Skip to main content
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>"
}

Authorizations

​
Authorization
string
header
required

A valid API key generated in Topsort's UI.

Path Parameters

​
job-id
string<uuid>
required

The ID of the job to retrieve the status for.

Query Parameters

​
vendor_id
string
required

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

Response

Successful Response

​
jobId
string<uuid>
required

The unique identifier for the queued job.

​
requestType
enum<string>
required

The type of operation the job represents.

Available options:
advertiser_creation,
campaign_creation,
campaign_update,
user_list_audience_creation
​
status
enum<string>
required

The current status of the job.

Available options:
not_started,
in_progress,
completed,
failed,
retrying
​
dsp
enum<string>
required

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

Available options:
google_ads,
meta
​
result
string | null

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