Extract

List Extract Jobs

List extraction jobs with optional filtering and pagination.

Filter by configuration_id, status, file_input, 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

document_input_typestring nullable

Filter by document input type (file_id or parse_job_id)

file_inputstring nullable

Filter by file input value

document_input_valuestring nullable

Deprecated: use file_input instead

Filter by status

page_sizeinteger nullable

Number of items per page

page_tokenstring nullable

Token for pagination

job_idsstring[] nullable

Filter by specific job IDs

expandstring[]

Additional fields to include: configuration, extract_metadata

project_idstring uuid nullable

organization_idstring uuid nullable

configuration_idstring nullable

Filter by configuration ID

Example:cfg-11111111-2222-3333-4444-555555555555

Filter by configuration ID

created_at_on_or_afterstring date-time nullable

Include items created at or after this timestamp (inclusive)

created_at_on_or_beforestring date-time nullable

Include items created at or before this timestamp (inclusive)

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": [
    {
      "file_input": "dfl-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
      "id": "ext-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
      "project_id": "prj-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
      "configuration_id": "cfg-11111111-2222-3333-4444-555555555555",
      "configuration": {
        "target_pages": "1,3,5-7",
        "max_pages": 10,
        "tier": "cost_effective",
        "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",
      "extract_metadata": {
        "field_metadata": {
          "document_metadata": {
            "items": [
              {
                "amount": {
                  "citation": [
                    {
                      "matching_text": "$10.00",
                      "page": 1
                    }
                  ],
                  "confidence": 1
                },
                "description": {
                  "citation": [
                    {
                      "matching_text": "$10/month",
                      "page": 1
                    }
                  ],
                  "confidence": 0.998
                }
              }
            ],
            "total": {
              "citation": [
                {
                  "matching_text": "$10.00",
                  "page": 1
                }
              ],
              "confidence": 1
            },
            "vendor": {
              "citation": [
                {
                  "matching_text": "Noisebridge",
                  "page": 1
                }
              ],
              "confidence": 1,
              "extraction_confidence": 1,
              "parsing_confidence": 1
            }
          }
        }
      }
    }
  ]
}

Changes

Changed in 8 of the 33 revisions of this API.149

Jun 9, 2026b17341164de92See the full diff
- ○
  added the optional property detail/items/ctx to the response with the 422 status
  response-optional-property-added
- ○
  added the optional property detail/items/input to the response with the 422 status
  response-optional-property-added
This revision also has 5 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jun 4, 2026d40e17e17bd111See the full diff
- ●
  removed the optional property items/items/configuration/anyOf[subschema #1: ExtractConfiguration]/extract_version from the response with the 200 status
  response-optional-property-removed
- ○
  added the optional property items/items/configuration/anyOf[subschema #1: ExtractConfiguration]/version to the response with the 200 status
  response-optional-property-added
May 27, 20261c29e1491a382See the full diff
- ●
  removed the optional property items/items/metadata/anyOf[subschema #1: ExtractV2JobMetadata]/usage/anyOf[subschema #1: ExtractJobUsage]/num_document_tokens from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property items/items/metadata/anyOf[subschema #1: ExtractV2JobMetadata]/usage/anyOf[subschema #1: ExtractJobUsage]/num_output_tokens from the response with the 200 status
  response-optional-property-removed
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
May 16, 2026c317ed7c691a1See the full diff
- ○
  api tag LlamaExtract removed
  api-tag-removed
May 14, 20261bbc901f8c0d1See the full diff
- ○
  api tag LlamaExtract added
  api-tag-added
This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Apr 29, 2026beb65a9b42eb1See the full diff
- ○
  api tag LlamaExtract removed
  api-tag-removed
Apr 8, 202601ac7197eb4a1See the full diff
- ●
  removed the optional property items/items/configuration/anyOf[subschema #1: ExtractConfiguration]/lang from the response with the 200 status
  response-optional-property-removed
This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Apr 1, 20267e0726654d2213See the full diff
- ▲
  removed the required property items/items/document_input_value from the response with the 200 status
  response-required-property-removed
- ○
  added the new optional query request parameter file_input
  new-optional-request-parameter
- ○
  query request parameter document_input_value was deprecated
  request-parameter-deprecated
- ○
  added the required property items/items/file_input to the response with the 200 status
  response-required-property-added

Full history