Skip to main content
GET
/
extract
/
jobs
List Jobs
curl --request GET \
  --url https://api.contextual.ai/v1/extract/jobs \
  --header 'Authorization: Bearer <token>'
{
  "jobs": [
    {
      "job_id": "<string>",
      "status": "pending",
      "created_at": "<string>",
      "progress": {
        "completion_percentage": 50,
        "current_step": "<string>",
        "fields_processed": 0,
        "total_fields": 0
      },
      "current_activity": "<string>",
      "schema_id": "<string>",
      "document_id": "<string>",
      "config": {
        "model": "gemini-2.5-flash",
        "per_key_attribution": false,
        "temperature": 0,
        "enable_thinking": true,
        "additional_instructions": "<string>",
        "enable_agentic_array_extraction": false
      }
    }
  ],
  "total_count": 123,
  "next_cursor": "<string>",
  "prev_cursor": "<string>"
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

limit
integer
default:20
cursor
string | null
job_status
string | null
search
string | null

Response

Successful Response

Response model for job listing.

jobs
JobStatusResponse · object[]
required

List of jobs

total_count
integer
required

Total number of jobs

next_cursor
string | null

Next cursor to continue pagination. Omitted if there are no more jobs to retrieve.

prev_cursor
string | null

Previous cursor to go back in pagination. Omitted if this is the first page.