---
title: "List Extract Jobs"
method: GET
path: "/api/v2/extract"
tags: ["V2", "Extract"]
---

# List Extract Jobs

`GET /api/v2/extract`

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.

## Query parameters

- `document_input_type` string, nullable — Filter by document input type (file_id or parse_job_id)
- `file_input` string, nullable — Filter by file input value
- `document_input_value` string, nullable — Deprecated: use file_input instead
- `status` 'PENDING' | 'THROTTLED' | 'RUNNING' | 'COMPLETED' | 'FAILED' | 'CANCELLED', nullable — Filter by status
- `page_size` integer, nullable — Number of items per page
- `page_token` string, nullable — Token for pagination
- `job_ids` string[], nullable — Filter by specific job IDs
- `expand` string[] — Additional fields to include: configuration, extract_metadata
- `project_id` string, uuid, nullable
- `organization_id` string, uuid, nullable
- `configuration_id` string, nullable — Filter by configuration ID
- `created_at_on_or_after` string, date-time, nullable — Include items created at or after this timestamp (inclusive)
- `created_at_on_or_before` string, date-time, nullable — Include items created at or before this timestamp (inclusive)

## Cookies

- `session` string, nullable

## Response `200`

Successful Response

- ExtractV2JobQueryResponse — Paginated list of extraction jobs.
  - `items` ExtractV2Job[], required — The list of items.
    - `file_input` string, required — File ID or parse job ID that was extracted
    - `id` string, required — Unique job identifier (job_id)
    - `project_id` string, required — Project this job belongs to
    - `configuration_id` string, nullable — Saved extract configuration ID used for this job, if any
    - `configuration` ExtractConfiguration — Extract configuration combining parse and extract settings.
      - `target_pages` string, nullable — Comma-separated page numbers or ranges to process (1-based). Omit to process all pages.
      - `max_pages` integer, nullable — Maximum number of pages to process. Omit for no limit.
      - `tier` 'cost_effective' | 'agentic' — Extract tier: cost_effective (5 credits/page) or agentic (15 credits/page)
      - `version` string — Use 'latest' for the latest release for the selected tier or a date string (YYYY-MM-DD format) to pin to the nearest release at or before that date.
      - `data_schema` object, required — JSON Schema defining the fields to extract. Validate with the /schema/validate endpoint first.
      - `extraction_target` 'per_doc' | 'per_page' | 'per_table_row' — Granularity of extraction: per_doc returns one object per document, per_page returns one object per page, per_table_row returns one object per table row
      - `system_prompt` string, nullable — Custom system prompt to guide extraction behavior
      - `cite_sources` boolean — Include citations in results
      - `confidence_scores` boolean — Include confidence scores in results
      - `parse_tier` string, nullable — Parse tier to use before extraction. Defaults to the extract tier if not specified.
      - `parse_config_id` string, nullable — Saved parse configuration ID to control how the document is parsed before extraction
    - `status` string, required — Current job status. - `PENDING` — queued, not yet started - `RUNNING` — actively processing - `COMPLETED` — finished successfully - `FAILED` — terminated with an error - `CANCELLED` — cancelled by user
    - `error_message` string, nullable — Error details when status is FAILED
    - `extract_result` union — Extracted data conforming to the data_schema. Returns a single object for per_doc, or an array for per_page / per_table_row.
      - object
      - object[]
    - `extract_metadata` ExtractJobMetadata — Extraction metadata.
      - `field_metadata` ExtractedFieldMetadata — Metadata for extracted fields including document, page, and row level info.
        - `document_metadata` object, nullable — Per-field metadata keyed by field name from your schema. Scalar fields (e.g. `vendor`) map to a FieldMetadataEntry with citation and confidence. Array fields (e.g. `items`) map to a list where each element contains per-sub-field FieldMetadataEntry objects, indexed by array position. Nested objects contain sub-field entries recursively.
        - `page_metadata` object[], nullable — Per-page metadata when extraction_target is per_page
        - `row_metadata` object[], nullable — Per-row metadata when extraction_target is per_table_row
      - `parse_job_id` string, nullable — Reference to the ParseJob ID used for parsing
      - `parse_tier` string, nullable — Parse tier used for parsing the document
    - `metadata` ExtractV2JobMetadata — Job-level metadata.
      - `usage` ExtractJobUsage — Extraction usage metrics.
        - `num_pages_extracted` integer, nullable — Number of pages extracted
    - `created_at` string, date-time, required — Creation timestamp
    - `updated_at` string, date-time, required — Last update timestamp
  - `next_page_token` string, 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_size` integer, 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.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/run-llama/apis/llama-platform.md) · [All operations](https://skmtc.net/run-llama/apis/llama-platform/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/run-llama/llama-platform/versions/b17341164de9/schema)