Passer au contenu 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",
  "dsp": [],
  "result": "<string>"
}

Autorisations

​
Authorization
string
header
requis

A valid API key generated in Topsort's UI. Use the TSE API key if calling auctions or events API, otherwise use the TSC API key.

Paramètres de chemin

​
job-id
string<uuid>
requis

The ID of the job to retrieve the status for.

Paramètres de requête

​
vendor_id
string | null

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

Réponse

Successful Response

​
jobId
string<uuid>
requis

The unique identifier for the queued job.

​
requestType
enum<string>
requis

The type of operation the job represents.

Options disponibles:
advertiser_creation,
campaign_creation,
campaign_update,
user_list_audience_creation
​
status
enum<string>
requis

The current status of the job.

Options disponibles:
not_started,
in_progress,
completed,
failed,
retrying
​
dsp
enum<string>[]
requis

The DSP(s) associated with the job.

DSPs an offsite audience is synced to.

Options disponibles:
google_ads,
meta,
tiktok_ads,
snapchat_ads
​
result
string | null

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