Job Sponsorship

Available

These endpoints allow you to promote a job posting (activate sponsorship), demote a job posting (deactivate sponsorship), and query the current sponsorship status of a job posting.

---

1. Promote a Job (Activate Sponsorship)

Promotes the job associated with the specified externalJobPostingId by adding it to the sponsorship program.

HTTP Request [POST]
https://parceiros.empregos.com.br/api/job/{externalJobPostingId}/sponsorship

cURL

curl -X 'POST' \
  'https://parceiros.empregos.com.br/api/job/vaga-teste-01/sponsorship' \
  -H 'accept: application/json' \
  -H 'Authorization: bearer any'

C#

using System;
using System.Net.Http;
using System.Threading.Tasks;

class Program
{
    private const string ApiUrlBase = "https://parceiros.empregos.com.br/api/job/";
    private const string ExternalJobPostingId = "vaga-teste-01";

    static async Task Main(string[] args)
    {
        using (HttpClient httpClient = new HttpClient())
        {
            httpClient.DefaultRequestHeaders.Authorization = new System.Net.Http.Headers.AuthenticationHeaderValue("bearer", "any");
            
            var response = await httpClient.PostAsync($"{ApiUrlBase}{ExternalJobPostingId}/sponsorship", null);
            string result = await response.Content.ReadAsStringAsync();
            Console.WriteLine(result);
        }
    }
}

Responses

• 200 OK: Sponsorship activated successfully.

  {
    "externalJobPostingId": "vaga-teste-01",
    "isSponsored": true,
    "status": "ACTIVE",
    "sponsoredAt": "2026-06-12T14:30:24.000Z",
    "message": "Sponsorship activated successfully in real-time."
  }
• 404 Not Found: Job not found or already closed.

  {
    "externalJobPostingId": "vaga-teste-01",
    "error": "JOB_NOT_FOUND",
    "message": "The externalJobPostingId provided was not found or is already closed."
  }

---

2. Demote a Job (Deactivate Sponsorship)

Removes the sponsorship of the job associated with the specified externalJobPostingId.

HTTP Request [DELETE]
https://parceiros.empregos.com.br/api/job/{externalJobPostingId}/sponsorship

cURL

curl -X 'DELETE' \
  'https://parceiros.empregos.com.br/api/job/vaga-teste-01/sponsorship' \
  -H 'accept: application/json' \
  -H 'Authorization: bearer any'

C#

using System;
using System.Net.Http;
using System.Threading.Tasks;

class Program
{
    private const string ApiUrlBase = "https://parceiros.empregos.com.br/api/job/";
    private const string ExternalJobPostingId = "vaga-teste-01";

    static async Task Main(string[] args)
    {
        using (HttpClient httpClient = new HttpClient())
        {
            httpClient.DefaultRequestHeaders.Authorization = new System.Net.Http.Headers.AuthenticationHeaderValue("bearer", "any");
            
            var response = await httpClient.DeleteAsync($"{ApiUrlBase}{ExternalJobPostingId}/sponsorship");
            string result = await response.Content.ReadAsStringAsync();
            Console.WriteLine(result);
        }
    }
}

Responses

• 200 OK: Sponsorship deactivated successfully.

  {
    "externalJobPostingId": "vaga-teste-01",
    "isSponsored": false,
    "status": "INACTIVE",
    "sponsoredAt": null,
    "message": "Sponsorship deactivated successfully in real-time."
  }
• 404 Not Found: Job not found or already closed.

---

3. Query Sponsorship Status

Gets the current status and date of activation of the sponsorship for a specific job.

HTTP Request [GET]
https://parceiros.empregos.com.br/api/job/{externalJobPostingId}/sponsorship

cURL

curl -X 'GET' \
  'https://parceiros.empregos.com.br/api/job/vaga-teste-01/sponsorship' \
  -H 'accept: application/json' \
  -H 'Authorization: bearer any'

C#

using System;
using System.Net.Http;
using System.Threading.Tasks;

class Program
{
    private const string ApiUrlBase = "https://parceiros.empregos.com.br/api/job/";
    private const string ExternalJobPostingId = "vaga-teste-01";

    static async Task Main(string[] args)
    {
        using (HttpClient httpClient = new HttpClient())
        {
            httpClient.DefaultRequestHeaders.Authorization = new System.Net.Http.Headers.AuthenticationHeaderValue("bearer", "any");
            
            var response = await httpClient.GetAsync($"{ApiUrlBase}{ExternalJobPostingId}/sponsorship");
            string result = await response.Content.ReadAsStringAsync();
            Console.WriteLine(result);
        }
    }
}

Responses

• 200 OK: Returns the current status of the sponsorship.

  {
    "externalJobPostingId": "vaga-teste-01",
    "isSponsored": true,
    "status": "ACTIVE",
    "sponsoredAt": "2026-06-12T14:30:24.000Z",
    "message": "Sponsorship is active."
  }
• 404 Not Found: Job not found or already closed.

---

Response fields

Field	Description	Type
externalJobPostingId	The job identifier sent in the request.	String
isSponsored	true when the job is currently sponsored.	Boolean
status	ACTIVE when sponsored, INACTIVE otherwise.	String
sponsoredAt	Date the sponsorship was activated. null when the job is not sponsored. On promote, it is the time of the request.	DateTime
message	Result message.	String
error	Error code. Present only on 404 Not Found: JOB_NOT_FOUND.	String

When the job is not sponsored, Query Sponsorship Status returns 200 OK with:

{
  "externalJobPostingId": "vaga-teste-01",
  "isSponsored": false,
  "status": "INACTIVE",
  "sponsoredAt": null,
  "message": "Sponsorship is inactive."
}

Other responses (all three operations)

• 404 Not Found: same body for promote, demote and query. It is returned when the externalJobPostingId does not belong to a job of your partner account, or the job is closed.

  {
    "externalJobPostingId": "vaga-teste-01",
    "error": "JOB_NOT_FOUND",
    "message": "The externalJobPostingId provided was not found or is already closed."
  }

• 500 Internal Server Error: the sponsorship could not be changed or read, or an unexpected error occurred. message carries the reason (some texts are in Portuguese).

  {
    "externalJobPostingId": "vaga-teste-01",
    "message": "Não foi possivel promover a vaga vaga-teste-01."
  }

• 401 Unauthorized: missing or invalid bearer token. See Security.