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.