# Retrieve extract

Retrieve an extract by ID.

Related endpoints:

* Create extract
* Retrieve parsing

Endpoint: GET /v0/extract/{id}
Security: ApiKeyAuth

## Path parameters:

  - `id` (string, required)
    The UUID of the extract.

## Response 200 fields (application/json):

  - `id` (string, required)
    Example: "300f339f-da71-4f9f-80f6-c25a63baae75"

  - `schema` (object, required)

  - `schema.id` (string, required)
    Example: "300f339f-da71-4f9f-80f6-c25a63baae75"

  - `schema.name` (string, required)
    Example: "Invoice schema"

  - `schema.description` (string, required)
    Example: "Schema used for extracting data from invoices."

  - `schema.completion_mode` (string, required)
    * CLASSIC - Classic
* VANILLA - Vanilla
    Enum: "CLASSIC", "VANILLA"

  - `parsing` (object, required)

  - `parsing.id` (string, required)
    Example: "300f339f-da71-4f9f-80f6-c25a63baae75"

  - `parsing.document` (object, required)

  - `parsing.document.id` (string, required)
    Example: "300f339f-da71-4f9f-80f6-c25a63baae75"

  - `parsing.document.filename` (string, required)
    Example: "invoice.pdf"

  - `parsing.document.file_url` (string,null)
    Example: "/v0/documents/300f339f-da71-4f9f-80f6-c25a63baae75/download"

  - `parsing.document.metadata` (object, required)
    Example: {"source":"api"}

  - `parsing.document.page_count` (integer, required)
    Example: 3

  - `parsing.document.created_at` (string, required)
    Example: "2025-06-12T14:56:10.682461Z"

  - `parsing.document.updated_at` (string, required)
    Example: "2025-06-12T14:56:10.682461Z"

  - `parsing.picture_description_enabled` (boolean, required)

  - `parsing.table_verification_enabled` (boolean, required)

  - `parsing.model` (string, required)
    * PIGALLE - Pigalle
* PIGALLE_LITE - Pigalle Lite
    Enum: "PIGALLE", "PIGALLE_LITE"

  - `parsing.pictures` (array, required)

  - `parsing.pictures.id` (string, required)
    Example: "300f339f-da71-4f9f-80f6-c25a63baae75"

  - `parsing.pictures.parsing` (string, required)
    Example: "300f339f-da71-4f9f-80f6-c25a63baae75"

  - `parsing.pictures.name` (string,null)
    Example: "_page_0_Picture_15.jpeg"

  - `parsing.pictures.picture` (string,null)
    Example: "/pipelines/documents/example-picture.jpeg"

  - `parsing.pictures.page_index` (integer, required)

  - `parsing.pictures.bbox` (object,null)

  - `parsing.pictures.description` (string,null)
    Example: "Company logo detected in the document."

  - `parsing.pictures.created_at` (string, required)
    Example: "2025-06-12T14:56:10.682461Z"

  - `parsing.ocr_content` (object,null)

  - `parsing.markdown_content` (string,null)
    Example: "# Invoice\n\nInvoice number: INV-2026-001"

  - `parsing.pages_total` (integer, required)
    Example: 3

  - `parsing.pages_success` (integer, required)

  - `parsing.pages_failed` (integer, required)

  - `parsing.status` (string, required)
    * IN_QUEUE - In queue
* IN_PROGRESS - In progress
* FINISHED - Finished
* PARTIAL_FINISHED - Partial finished
* ERROR - Error
    Enum: "IN_QUEUE", "IN_PROGRESS", "FINISHED", "PARTIAL_FINISHED", "ERROR"

  - `parsing.metadata` (object,null)
    Example: {"source":"api"}

  - `parsing.error` (string,null)

  - `parsing.created_at` (string, required)
    Example: "2025-06-12T14:56:10.682461Z"

  - `parsing.updated_at` (string, required)
    Example: "2025-06-12T14:56:10.682461Z"

  - `result` (object,null)
    Extracted structured result. Can be null until processing is complete.

  - `status` (string, required)
    * IN_QUEUE - In queue
* IN_PROGRESS - In progress
* FINISHED - Finished
* ERROR - Error
    Enum: "IN_QUEUE", "IN_PROGRESS", "FINISHED", "ERROR"

  - `error` (string,null)

  - `created_at` (string, required)
    Example: "2025-06-12T14:56:10.682461Z"

  - `updated_at` (string, required)
    Example: "2025-06-12T14:56:10.682461Z"

## Response 401 fields (application/json):

  - `detail` (string, required)
    Example: "Invalid API key"

## Response 404 fields (application/json):

  - `detail` (string, required)
    Example: "Parsing not found."