Saltar para o conteúdo principal
GET
/
public
/
v1
/
offsite-ads
/
jobs
/
{job-id}
Get Job Status
curl --request GET \
  --url https://api.topsort.com/public/v1/offsite-ads/jobs/{job-id} \
  --header 'Authorization: Bearer <token>'
{
  "jobId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "requestType": "advertiser_creation",
  "status": "not_started",
  "dsp": "google_ads",
  "result": "<string>"
}

Autorizações

Authorization
string
header
obrigatório

A valid API key generated in Topsort's UI.

Parâmetros de caminho

job-id
string<uuid>
obrigatório

The ID of the job to retrieve the status for.

Parâmetros de consulta

vendor_id
string
obrigatório

The ID of the vendor to retrieve the job status for.

Resposta

Successful Response

jobId
string<uuid>
obrigatório

The unique identifier for the queued job.

requestType
enum<string>
obrigatório

The type of operation the job represents.

Opções disponíveis:
advertiser_creation,
campaign_creation,
campaign_update,
user_list_audience_creation
status
enum<string>
obrigatório

The current status of the job.

Opções disponíveis:
not_started,
in_progress,
completed,
failed,
retrying
dsp
enum<string>
obrigatório

The Demand-Side Platform (DSP) associated with the campaign

Opções disponíveis:
google_ads,
meta
result
string | null

Optional result data in json format (e.g., {error: 'error message'}).