/extract

Get the results of a completed extraction job.

get/extract/jobs/{job_id}/results

Request

  • Base URL
    https://api.contextual.ai/v1
  • URL
    https://api.contextual.ai/v1/extract/jobs/{job_id}/results
  • Auth
    HTTP bearer

Path parameters

job_idstring required

Response

Successful Response

job_idstring required

Unique ID of the extraction job

status'pending' | 'processing' | 'retrying' | 'completed' | 'failed' | 'cancelled' required
resultsobject required

Extracted results conforming to the provided JSON Schema. When per_key_attribution is enabled, primitive values are wrapped with AttributionInfo containing extracted_value, reasoning, confidence, and location fields.

metadataobject required

Metadata about the extraction process. May include has_attributions boolean flag indicating if attribution data is present in results.

Example response

{
  "config": {
    "model": "gemini-2.5-flash",
    "enable_thinking": true
  }
}

Changes