Sign in
V2
Extract
LlamaExtract

List Extract Jobs

List extraction jobs with optional filtering and pagination.

Filter by configuration_id, status, document_input_value, or creation date range. Results are returned newest-first. Use expand=configuration to include the full configuration used, and expand=extract_metadata for per-field metadata.

get/api/v2/extract

Query parameters

configuration_idstring nullable

Filter by configuration ID

Filter by configuration ID

document_input_typestring nullable

Filter by document input type (file_id or parse_job_id)

Filter by document input type (file_id or parse_job_id)

document_input_valuestring nullable

Filter by document input value

Filter by document input value

status'PENDING' | 'THROTTLED' | 'RUNNING' | 'COMPLETED' | 'FAILED' | 'CANCELLED' nullable

Filter by status

Filter by status

page_sizeinteger nullable

Number of items per page

Number of items per page

page_tokenstring nullable

Token for pagination

Token for pagination

created_at_on_or_afterstring date-time nullable

Include jobs created at or after this timestamp (inclusive)

Include jobs created at or after this timestamp (inclusive)

created_at_on_or_beforestring date-time nullable

Include jobs created at or before this timestamp (inclusive)

Include jobs created at or before this timestamp (inclusive)

job_idsstring[] nullable

Filter by specific job IDs

Filter by specific job IDs

expandstring[]

Additional fields to include: configuration, extract_metadata

Additional fields to include: configuration, extract_metadata

project_idstring uuid nullable
organization_idstring uuid nullable

Cookies

sessionstring nullable

Response

Successful Response

next_page_tokenstring nullable

A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.

total_sizeinteger nullable

The total number of items available. This is only populated when specifically requested. The value may be an estimate and can be used for display purposes only.

Example response

{
  "items": [
    {
      "id": "ext-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
      "project_id": "prj-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
      "configuration_id": "cfg-11111111-2222-3333-4444-555555555555",
      "document_input_value": "dfl-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
      "configuration": {
        "target_pages": "1,3,5-7",
        "max_pages": 10,
        "lang": "en",
        "tier": "cost_effective",
        "extract_version": "latest",
        "extraction_target": "per_doc",
        "system_prompt": "Extract all monetary values in USD. If a currency is not specified, assume USD.",
        "parse_tier": "fast",
        "parse_config_id": "cfg-11111111-2222-3333-4444-555555555555"
      },
      "status": "COMPLETED"
    }
  ]
}

Changes