TOtoksta
Jobs

Get job status

Get the status of a creator-discovery job. The {id} path parameter must be a plain UUID (no prefix). NOTE: content-fit / audience-fit / enrichment jobs are NOT retrievable here — use their dedicated results endpoints.

get/v1/jobs/{id}

Request

Path parameters

idstring required

Job UUID (plain, unprefixed).

Response

Job status. status is one of queued, running, succeeded, failed, canceled, expired.

successtrue required
dataobject required

Operation payload. See the example for the exact field structure.

Example response

{
  "success": true,
  "data": {
    "job": {
      "id": "56232ac2-8068-4dcb-9d1a-1f2e3a4b5c6d",
      "job_type": "creator_discovery",
      "status": "succeeded",
      "source_status": "completed",
      "is_terminal": true,
      "progress": {
        "total_items": 120,
        "completed_items": 120,
        "approved_items": 38,
        "failed_items": 82
      },
      "campaign_id": null,
      "platform": "linkedin",
      "created_list_id": null,
      "created_at": "2026-05-28T09:00:00Z",
      "updated_at": "2026-05-28T09:06:00Z",
      "completed_at": "2026-05-28T09:06:00Z",
      "result_expires_at": "2026-06-27T09:06:00Z",
      "result_retention_days": 30,
      "error_message": null
    }
  },
  "meta": {
    "request_id": "req_01HXYZ...",
    "trace_id": "4f1d...c2"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.