TOtoksta
Jobs

Get multiple job results

Fetch results for multiple creator-discovery jobs in one call.

URL: POST /v1/jobs/results:bulk (note the :bulk action suffix).

Body requires job_ids: an array of 1-20 plain UUIDs (not prefixed). Each entry in the response carries found plus the job result or a per-job error.

post/v1/jobs/results{bulk}

Request

Path parameters

bulkstring required

Request body

job_idsstring[] required

1-20 discovery job UUIDs (plain, unprefixed). REQUIRED.

limitinteger

Max candidate rows per job (1-200). Defaults to 50. Alias: results_limit.

Example request

{
  "job_ids": [
    "56232ac2-8068-4dcb-9d1a-1f2e3a4b5c6d",
    "7a8b9c0d-1e2f-4a3b-8c9d-0e1f2a3b4c5d"
  ],
  "limit": 25
}

Response

Bulk job results. meta includes requested_count, found_count, not_found_count.

successtrue required
dataobject required

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

Example response

{
  "success": true,
  "data": {
    "jobs": [
      {
        "found": true,
        "job_id": "56232ac2-8068-4dcb-9d1a-1f2e3a4b5c6d",
        "job_type": "creator_discovery",
        "status": "succeeded",
        "progress": {
          "total_items": 120,
          "completed_items": 120,
          "approved_items": 38,
          "failed_items": 82
        },
        "result_count": 38,
        "results": []
      },
      {
        "job_id": "7a8b9c0d-1e2f-4a3b-8c9d-0e1f2a3b4c5d",
        "found": false
      }
    ]
  },
  "meta": {
    "request_id": "req_01HXYZ...",
    "trace_id": "4f1d...c2"
  }
}

Changes

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