---
title: "List Extract Agents"
method: GET
path: "/api/v1/beta/extraction-agents"
tags: ["Beta", "LlamaExtract"]
---

# List Extract Agents

`GET /api/v1/beta/extraction-agents`

## Request

- Base URL: `https://api.cloud.llamaindex.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.cloud.llamaindex.ai/api/v1/beta/extraction-agents`
- Auth: HTTP bearer

List the extraction agents in a project, newest first.

## Query parameters

- `include_default` boolean: Whether to include default agents in the results
- `page_size` integer: Number of items per page
- `page_token` string, nullable: Cursor from the previous page's `next_page_token`.
- `project_id` string, uuid, nullable
- `organization_id` string, uuid, nullable

## Cookies

- `session` string, nullable

## Response `200`

Successful Response

- ExtractAgentQueryResponse: Paginated list of extraction agents.
  - `items` ExtractAgent[], required: The list of items.
    - `id` string, uuid, required: The id of the extraction agent.
    - `name` string, required: The name of the extraction agent.
    - `project_id` string, uuid, required: The ID of the project that the extraction agent belongs to.
    - `data_schema` object, required: The schema of the data.
    - `config` ExtractConfig, required: Configuration parameters for the extraction agent.
      - `priority` 'low' | 'medium' | 'high' | 'critical', nullable: The priority for the request. This field may be ignored or overwritten depending on the organization tier.
      - `extraction_target` 'PER_DOC' | 'PER_PAGE' | 'PER_TABLE_ROW': Defines the extraction target scope.
      - `extraction_mode` 'FAST' | 'BALANCED' | 'PREMIUM' | 'MULTIMODAL': Extraction mode options.
      - `parse_model` 'openai-gpt-4o' | 'openai-gpt-4o-mini' | 'openai-gpt-4-1' | 'openai-gpt-4-1-mini' | 'openai-gpt-4-1-nano' | 'openai-gpt-5' | 'openai-gpt-5-mini' | 'openai-gpt-5-nano' | 'openai-text-embedding-3-large' | 'openai-text-embedding-3-small' | 'openai-whisper-1' | 'anthropic-sonnet-3.5' | 'anthropic-sonnet-3.5-v2' | 'anthropic-sonnet-3.7' | 'anthropic-sonnet-4.0' | 'anthropic-sonnet-4.5' | 'anthropic-haiku-3.5' | 'anthropic-haiku-4.5' | 'gemini-2.5-flash' | 'gemini-3.0-pro' | 'gemini-3.1-pro' | 'gemini-2.5-pro' | 'gemini-2.0-flash' | 'gemini-2.0-flash-lite' | 'gemini-2.5-flash-lite': Public model names.
      - `extract_model` union: The extract model to use for data extraction. If not provided, uses the default for the extraction mode.
        - 'openai-gpt-4-1' | 'openai-gpt-4-1-mini' | 'openai-gpt-4-1-nano' | 'openai-gpt-5' | 'openai-gpt-5-mini' | 'gemini-2.0-flash' | 'gemini-2.5-flash' | 'gemini-2.5-flash-lite' | 'gemini-2.5-pro' | 'openai-gpt-4o' | 'openai-gpt-4o-mini': Extract model options.
        - string
      - `multimodal_fast_mode` boolean: DEPRECATED: Whether to use fast mode for multimodal extraction.
      - `system_prompt` string, nullable: The system prompt to use for the extraction.
      - `use_reasoning` boolean: Whether to use reasoning for the extraction.
      - `cite_sources` boolean: Whether to cite sources for the extraction.
      - `citation_bbox` boolean: Whether to fetch citation bounding boxes for the extraction. Only available in PREMIUM mode. Deprecated: this is now synonymous with cite_sources.
      - `confidence_scores` boolean: Whether to fetch confidence scores for the extraction.
      - `chunk_mode` 'PAGE' | 'SECTION': How to chunk documents.
      - `high_resolution_mode` boolean: Whether to use high resolution mode for the extraction.
      - `invalidate_cache` boolean: Whether to invalidate the cache for the extraction.
      - `num_pages_context` integer, nullable: Number of pages to pass as context on long document extraction.
      - `page_range` string, nullable: Comma-separated list of page numbers or ranges to extract from (1-based, e.g., '1,3,5-7,9' or '1-3,8-10').
    - `custom_configuration` 'default', nullable: Custom configuration type for the extraction agent. Currently supports 'default'.
    - `created_at` string, date-time, nullable: The creation time of the extraction agent.
    - `updated_at` string, date-time, nullable: The last update time of the extraction agent.
  - `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

## Changes

- **2026-10-16** `a38b684f8e1b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/run-llama/apis/llama-platform/changes/api/v1/beta/extraction-agents/get.md)

---

[API](https://skmtc.dev/run-llama/apis/llama-platform.md) · [All operations](https://skmtc.dev/run-llama/apis/llama-platform/llms.txt) · [OpenAPI document](https://skmtc.dev/run-llama/apis/llama-platform/revisions/809d302cdb1e?raw)