> This page is optimized for agents. Use the linked Markdown pages and llms.txt indexes for related API content.

# Retrieve Parse

- Product: Reducto API
- Section: Jobs
- Snapshot: Current
- Method: `GET`
- Path: `/job/{job_id}`

## Path parameters

### `job_id`

Type: `string`  
Required: yes  

## Execute with cURL

```bash
curl -X GET "https://platform.reducto.ai/job/$JOB_ID" \
  -H "Authorization: Bearer $REDUCTO_API_KEY"
```

## Responses

### Response `200`

Category: success  

Successful Response

#### `application/json`

##### Generated example

```json
{
  "status": "Pending",
  "result": {
    "job_id": "job_id",
    "duration": 0,
    "usage": {
      "num_pages": 0
    },
    "result": {},
    "response_type": "parse",
    "pdf_url": "pdf_url",
    "studio_link": "studio_link",
    "document_properties": {}
  },
  "progress": 0,
  "reason": "reason",
  "error": {
    "code": 0,
    "name": "TIMEOUT",
    "message": "message",
    "job_id": "job_id"
  }
}
```

##### Schema

###### Response Retrieve Parse Job  Job Id  Get

Type: `one of 2`  

###### AsyncJobResponse

Type: `AsyncJobResponse`  

###### `status`

Type: `string`  
Required: yes  
Allowed values: `Pending`, `Completed`, `Failed`, `Idle`  

###### `result`

Type: `one of 8`  
Required: no  

###### one of 8

Type: `one of 8`  

###### ParseResponse

Type: `ParseResponse`  

###### `response_type`

Type: `string`  
Required: no  
Default: `parse`  

###### `job_id`

Type: `string`  
Required: yes  

###### `duration`

Type: `number`  
Required: yes  

The duration of the parse request in seconds.

###### `pdf_url`

Type: `string`  
Required: no  

The storage URL of the converted PDF file.

###### string

Type: `string`  

###### unknown

Type: `unknown`  

###### `studio_link`

Type: `string`  
Required: no  

The link to the studio pipeline for the document.

###### string

Type: `string`  

###### unknown

Type: `unknown`  

###### `usage`

Type: `ParseUsage`  
Required: yes  

###### `num_pages`

Type: `number`  
Required: yes  

###### `credits`

Type: `number`  
Required: no  

###### `credit_breakdown`

Type: `object`  
Required: no  

###### `page_billing_breakdown`

Type: `object`  
Required: no  

Per-page breakdown of features used. Maps 1-indexed page numbers (as strings) to the list of billing features applied on that page (e.g. 'page', 'complex', 'chart_agent').

###### `non_empty_cell_count`

Type: `number`  
Required: no  

Total non-empty cells across all sheets. Only set for spreadsheet inputs.

###### `usage_breakdown`

Type: `one of 4`  
Required: no  

Raw usage quantities. Only set for accounts on the new pricing model; credit fields are omitted for those accounts.

###### `result`

Type: `FullResult | UrlResult`  
Required: yes  

The response from the document processing service. Note that there can be two types of responses, Full Result and URL Result. This is due to limitations on the max return size on HTTPS. If the response is too large, it will be returned as a presigned URL in the URL response. You should handle this in your application.

###### FullResult

Type: `FullResult`  

###### UrlResult

Type: `UrlResult`  

###### `document_properties`

Type: `DocumentProperties`  
Required: no  

Properties embedded in the customer's original document.

###### DocumentProperties

Type: `DocumentProperties`  

Embedded properties read from the customer's original document.

###### unknown

Type: `unknown`  

###### ExtractResponse

Type: `ExtractResponse`  

###### `response_type`

Type: `string`  
Required: no  
Default: `extract`  

###### `job_id`

Type: `string`  
Required: no  

###### string

Type: `string`  

###### unknown

Type: `unknown`  

###### `usage`

Type: `ExtractUsage`  
Required: yes  

###### `num_pages`

Type: `number`  
Required: yes  

###### `num_fields`

Type: `number`  
Required: yes  

###### `credits`

Type: `number`  
Required: no  

###### `extract_mode`

Type: `string`  
Required: no  

###### `usage_breakdown`

Type: `ExtractUsageBreakdown`  
Required: no  

Raw usage quantities. Only set for accounts on the new pricing model; credit fields are omitted for those accounts.

###### `duration`

Type: `number`  
Required: no  

The duration of the extract request in seconds.

###### number

Type: `number`  

###### unknown

Type: `unknown`  

###### `studio_link`

Type: `string`  
Required: no  

The link to the studio pipeline for the document.

###### string

Type: `string`  

###### unknown

Type: `unknown`  

###### `result`

Type: `unknown[] | UrlResult`  
Required: yes  

The extracted response in your provided schema. This is a list of dictionaries. If disable_chunking is True (default), then it will be a list of length one. If force_url_result is True, this is returned as a URL result.

###### unknown[]

Type: `unknown[]`  

###### UrlResult

Type: `UrlResult`  

###### `citations`

Type: `unknown[] | UrlResult`  
Required: yes  

The citations corresponding to the extracted response. If force_url_result is True and citations are present, this is returned as a URL result.

###### unknown[]

Type: `unknown[]`  

###### UrlResult

Type: `UrlResult`  

###### unknown

Type: `unknown`  

###### `response_confidence`

Type: `object`  
Required: no  

Optional deep extract confidence metadata containing document-level confidence plus a mirrored leaf-level confidence tree.

###### object

Type: `object`  

###### unknown

Type: `unknown`  

###### SplitResponse

Type: `SplitResponse`  

###### `response_type`

Type: `string`  
Required: no  
Default: `split`  

###### `job_id`

Type: `string`  
Required: no  

The unique identifier for the split job.

###### string

Type: `string`  

###### unknown

Type: `unknown`  

###### `usage`

Type: `ParseUsage`  
Required: yes  

###### `num_pages`

Type: `number`  
Required: yes  

###### `credits`

Type: `number`  
Required: no  

###### `credit_breakdown`

Type: `object`  
Required: no  

###### `page_billing_breakdown`

Type: `object`  
Required: no  

Per-page breakdown of features used. Maps 1-indexed page numbers (as strings) to the list of billing features applied on that page (e.g. 'page', 'complex', 'chart_agent').

###### `non_empty_cell_count`

Type: `number`  
Required: no  

Total non-empty cells across all sheets. Only set for spreadsheet inputs.

###### `usage_breakdown`

Type: `one of 4`  
Required: no  

Raw usage quantities. Only set for accounts on the new pricing model; credit fields are omitted for those accounts.

###### `duration`

Type: `number`  
Required: no  

The duration of the split request in seconds.

###### number

Type: `number`  

###### unknown

Type: `unknown`  

###### `result`

Type: `one of 3`  
Required: yes  

The split result. If force_url_result is True, this is returned as a URL result.

###### SplitResult

Type: `SplitResult`  

###### DeepSplitResult

Type: `DeepSplitResult`  

###### UrlResult

Type: `UrlResult`  

###### EditResponse

Type: `EditResponse`  

###### `response_type`

Type: `string`  
Required: no  
Default: `edit`  

###### `job_id`

Type: `string`  
Required: no  

The unique identifier for the edit job.

###### string

Type: `string`  

###### unknown

Type: `unknown`  

###### `document_url`

Type: `string`  
Required: yes  

Presigned URL to download the edited document.

###### `form_schema`

Type: `EditWidget[]`  
Required: no  

Form schema for PDF forms. List of widgets with their types, descriptions, and bounding boxes.

###### EditWidget[]

Type: `EditWidget[]`  

###### unknown

Type: `unknown`  

###### `usage`

Type: `ParseUsage`  
Required: no  

Usage information for the edit operation, including number of pages and credits charged.

###### ParseUsage

Type: `ParseUsage`  

###### unknown

Type: `unknown`  

###### `warnings`

Type: `string[]`  
Required: no  

Warnings about the edit, for example when no form fields were filled.

###### string[]

Type: `string[]`  

###### unknown

Type: `unknown`  

###### PipelineResponse

Type: `PipelineResponse`  

###### `response_type`

Type: `string`  
Required: no  
Default: `pipeline`  

###### `job_id`

Type: `string`  
Required: yes  

###### `usage`

Type: `ParseUsage`  
Required: yes  

###### `num_pages`

Type: `number`  
Required: yes  

###### `credits`

Type: `number`  
Required: no  

###### `credit_breakdown`

Type: `object`  
Required: no  

###### `page_billing_breakdown`

Type: `object`  
Required: no  

Per-page breakdown of features used. Maps 1-indexed page numbers (as strings) to the list of billing features applied on that page (e.g. 'page', 'complex', 'chart_agent').

###### `non_empty_cell_count`

Type: `number`  
Required: no  

Total non-empty cells across all sheets. Only set for spreadsheet inputs.

###### `usage_breakdown`

Type: `one of 4`  
Required: no  

Raw usage quantities. Only set for accounts on the new pricing model; credit fields are omitted for those accounts.

###### `result`

Type: `PipelineResult`  
Required: yes  

###### `parse`

Type: `ParseResponse | ParseResponse[]`  
Required: yes  

###### `extract`

Type: `one of 4`  
Required: yes  

###### `split`

Type: `SplitResponse`  
Required: yes  

###### `edit`

Type: `EditResponse`  
Required: no  

###### V3ExtractResponse

Type: `V3ExtractResponse`  

###### `response_type`

Type: `string`  
Required: no  
Default: `v3_extract`  

###### `job_id`

Type: `string`  
Required: no  

###### string

Type: `string`  

###### unknown

Type: `unknown`  

###### `usage`

Type: `ExtractUsage`  
Required: yes  

###### `num_pages`

Type: `number`  
Required: yes  

###### `num_fields`

Type: `number`  
Required: yes  

###### `credits`

Type: `number`  
Required: no  

###### `extract_mode`

Type: `string`  
Required: no  

###### `usage_breakdown`

Type: `ExtractUsageBreakdown`  
Required: no  

Raw usage quantities. Only set for accounts on the new pricing model; credit fields are omitted for those accounts.

###### `duration`

Type: `number`  
Required: no  

The duration of the extract request in seconds.

###### number

Type: `number`  

###### unknown

Type: `unknown`  

###### `studio_link`

Type: `string`  
Required: no  

The link to the studio pipeline for the document.

###### string

Type: `string`  

###### unknown

Type: `unknown`  

###### `confidence`

Type: `string`  
Required: no  

Optional document-level deep extract confidence label.

###### string

Type: `string`  
Allowed values: `high`, `low`  

###### unknown

Type: `unknown`  

###### `confidence_reason`

Type: `string`  
Required: no  

Optional explanation for the document-level confidence label.

###### string

Type: `string`  

###### unknown

Type: `unknown`  

###### `result`

Type: `unknown[]`  
Required: yes  

The extracted response in your provided schema. This is a list of dictionaries. If disable_chunking is True (default), then it will be a list of length one.

###### unknown

Type: `unknown`  

###### unknown[]

Type: `unknown[]`  

###### ClassifyResponse

Type: `ClassifyResponse`  

Response from classify job - returned when polling /job/{job_id}

###### `response_type`

Type: `string`  
Required: no  
Default: `classify`  

###### `job_id`

Type: `string`  
Required: yes  

###### `result`

Type: `ClassifyResponseCategory | UrlResult`  
Required: yes  

###### ClassifyResponseCategory

Type: `ClassifyResponseCategory`  

###### UrlResult

Type: `UrlResult`  

###### `response_confidence`

Type: `ResponseConfidence`  
Required: no  

###### ResponseConfidence

Type: `ResponseConfidence`  

Overall confidence breakdown for classification response.

###### unknown

Type: `unknown`  

###### `usage`

Type: `ClassifyUsage`  
Required: no  

###### ClassifyUsage

Type: `ClassifyUsage`  

###### unknown

Type: `unknown`  

###### `extra_metadata`

Type: `object`  
Required: no  

Additional metadata for the classify response. Contains `grouping` when the request set `category_groups`. Omitted when empty.

###### `duration`

Type: `number`  
Required: no  

The duration of the classify request in seconds.

###### number

Type: `number`  

###### unknown

Type: `unknown`  

###### ChartResponse

Type: `ChartResponse`  

Response from synchronous and persisted chart extraction jobs.

###### `response_type`

Type: `string`  
Required: no  
Default: `chart`  

###### `job_id`

Type: `string`  
Required: yes  

###### `result`

Type: `ChartResult`  
Required: yes  

###### `chart_data`

Type: `object`  
Required: yes  

###### `summary`

Type: `string`  
Required: yes  

###### `reconstruction_url`

Type: `string`  
Required: yes  

###### `verified`

Type: `boolean`  
Required: yes  

###### `usage`

Type: `ChartUsage`  
Required: no  

###### `num_charts`

Type: `number`  
Required: no  
Default: `1`  

###### `credits`

Type: `number`  
Required: no  
Default: `4`  

###### `duration`

Type: `number`  
Required: no  

###### number

Type: `number`  

###### unknown

Type: `unknown`  

###### unknown

Type: `unknown`  

###### `progress`

Type: `number`  
Required: no  

###### number

Type: `number`  

###### unknown

Type: `unknown`  

###### `reason`

Type: `string`  
Required: no  

###### string

Type: `string`  

###### unknown

Type: `unknown`  

###### `error`

Type: `ErrorDetail`  
Required: no  

###### ErrorDetail

Type: `ErrorDetail`  

Structured error body returned to customers.

Matches the format specified in ``ERROR_POLICY.md``.

###### `code`

Type: `number`  
Required: yes  

###### `name`

Type: `string`  
Required: yes  
Allowed values: `TIMEOUT`, `CAPACITY_TIMEOUT`, `CUSTOMER_TIMEOUT`, `INTERNAL_ERROR`, `SERVICE_UNAVAILABLE`, `GPU_ALLOCATION_ERROR`, `GPU_POOL_SATURATED`, `BATCH_QUEUE_FULL`, `QUEUE_FULL`, `JOB_STATE_ERROR`, `DOCUMENT_CORRUPT`, `DOCUMENT_EMPTY`, `DOCUMENT_UNSUPPORTED`, `DOCUMENT_TOO_LARGE`, `OFFICE_CONVERSION_TOO_LARGE`, `IMAGE_TOO_LARGE`, `IMAGE_TOO_SMALL`, `IMAGE_INVALID_ASPECT_RATIO`, `DOCUMENT_PASSWORD_PROTECTED`, `FORM_FILL_FAILED`, `INTERNAL_INVARIANT_VIOLATION`, `GPU_UNAVAILABLE`, `CONTEXT_WINDOW_EXCEEDED`, `OUTPUT_LIMIT_EXCEEDED`, `PROCESSING_FAILED`, `INFERENCE_METHOD_UNSUPPORTED`, `SUBPROCESS_CRASHED`, `BATCH_ORPHANED`, `OVERSIZED_RESULT`, `LLM_OUTPUT_PARSE_FAILED`, `LLM_PROVIDER_ERROR`, `INVALID_CONFIG`, `INVALID_SCHEMA`, `AUTH_ERROR`, `NOT_APPLICABLE`, `REGION_UNAVAILABLE`, `NOT_FOUND`, `JOB_DELETION_IN_PROGRESS`, `JOB_DELETED`, `JOB_NOT_COMPLETE`, `JOB_CANCELLED`, `RATE_LIMIT`, `CELL_COUNT_EXCEEDED`, `URL_NOT_ALLOWED`  

Machine-readable error names returned in API error responses.

Each member maps to a category (Transient / Processing / Input) and
a default HTTP status code defined in ``ERROR_CODE_DEFAULTS``.
The enum value is the string customers see in the ``error.name`` field.

###### `message`

Type: `string`  
Required: yes  

###### `job_id`

Type: `string`  
Required: no  

###### string

Type: `string`  

###### unknown

Type: `unknown`  

###### unknown

Type: `unknown`  

###### EnhancedAsyncJobResponse

Type: `EnhancedAsyncJobResponse`  

###### `status`

Type: `string`  
Required: yes  
Allowed values: `Pending`, `Completed`, `Failed`, `Idle`  

###### `result`

Type: `one of 8`  
Required: no  

###### one of 8

Type: `one of 8`  

###### ParseResponse

Type: `ParseResponse`  

###### `response_type`

Type: `string`  
Required: no  
Default: `parse`  

###### `job_id`

Type: `string`  
Required: yes  

###### `duration`

Type: `number`  
Required: yes  

The duration of the parse request in seconds.

###### `pdf_url`

Type: `string`  
Required: no  

The storage URL of the converted PDF file.

###### string

Type: `string`  

###### unknown

Type: `unknown`  

###### `studio_link`

Type: `string`  
Required: no  

The link to the studio pipeline for the document.

###### string

Type: `string`  

###### unknown

Type: `unknown`  

###### `usage`

Type: `ParseUsage`  
Required: yes  

###### `num_pages`

Type: `number`  
Required: yes  

###### `credits`

Type: `number`  
Required: no  

###### `credit_breakdown`

Type: `object`  
Required: no  

###### `page_billing_breakdown`

Type: `object`  
Required: no  

Per-page breakdown of features used. Maps 1-indexed page numbers (as strings) to the list of billing features applied on that page (e.g. 'page', 'complex', 'chart_agent').

###### `non_empty_cell_count`

Type: `number`  
Required: no  

Total non-empty cells across all sheets. Only set for spreadsheet inputs.

###### `usage_breakdown`

Type: `one of 4`  
Required: no  

Raw usage quantities. Only set for accounts on the new pricing model; credit fields are omitted for those accounts.

###### `result`

Type: `FullResult | UrlResult`  
Required: yes  

The response from the document processing service. Note that there can be two types of responses, Full Result and URL Result. This is due to limitations on the max return size on HTTPS. If the response is too large, it will be returned as a presigned URL in the URL response. You should handle this in your application.

###### FullResult

Type: `FullResult`  

###### UrlResult

Type: `UrlResult`  

###### `document_properties`

Type: `DocumentProperties`  
Required: no  

Properties embedded in the customer's original document.

###### DocumentProperties

Type: `DocumentProperties`  

Embedded properties read from the customer's original document.

###### unknown

Type: `unknown`  

###### ExtractResponse

Type: `ExtractResponse`  

###### `response_type`

Type: `string`  
Required: no  
Default: `extract`  

###### `job_id`

Type: `string`  
Required: no  

###### string

Type: `string`  

###### unknown

Type: `unknown`  

###### `usage`

Type: `ExtractUsage`  
Required: yes  

###### `num_pages`

Type: `number`  
Required: yes  

###### `num_fields`

Type: `number`  
Required: yes  

###### `credits`

Type: `number`  
Required: no  

###### `extract_mode`

Type: `string`  
Required: no  

###### `usage_breakdown`

Type: `ExtractUsageBreakdown`  
Required: no  

Raw usage quantities. Only set for accounts on the new pricing model; credit fields are omitted for those accounts.

###### `duration`

Type: `number`  
Required: no  

The duration of the extract request in seconds.

###### number

Type: `number`  

###### unknown

Type: `unknown`  

###### `studio_link`

Type: `string`  
Required: no  

The link to the studio pipeline for the document.

###### string

Type: `string`  

###### unknown

Type: `unknown`  

###### `result`

Type: `unknown[] | UrlResult`  
Required: yes  

The extracted response in your provided schema. This is a list of dictionaries. If disable_chunking is True (default), then it will be a list of length one. If force_url_result is True, this is returned as a URL result.

###### unknown[]

Type: `unknown[]`  

###### UrlResult

Type: `UrlResult`  

###### `citations`

Type: `unknown[] | UrlResult`  
Required: yes  

The citations corresponding to the extracted response. If force_url_result is True and citations are present, this is returned as a URL result.

###### unknown[]

Type: `unknown[]`  

###### UrlResult

Type: `UrlResult`  

###### unknown

Type: `unknown`  

###### `response_confidence`

Type: `object`  
Required: no  

Optional deep extract confidence metadata containing document-level confidence plus a mirrored leaf-level confidence tree.

###### object

Type: `object`  

###### unknown

Type: `unknown`  

###### SplitResponse

Type: `SplitResponse`  

###### `response_type`

Type: `string`  
Required: no  
Default: `split`  

###### `job_id`

Type: `string`  
Required: no  

The unique identifier for the split job.

###### string

Type: `string`  

###### unknown

Type: `unknown`  

###### `usage`

Type: `ParseUsage`  
Required: yes  

###### `num_pages`

Type: `number`  
Required: yes  

###### `credits`

Type: `number`  
Required: no  

###### `credit_breakdown`

Type: `object`  
Required: no  

###### `page_billing_breakdown`

Type: `object`  
Required: no  

Per-page breakdown of features used. Maps 1-indexed page numbers (as strings) to the list of billing features applied on that page (e.g. 'page', 'complex', 'chart_agent').

###### `non_empty_cell_count`

Type: `number`  
Required: no  

Total non-empty cells across all sheets. Only set for spreadsheet inputs.

###### `usage_breakdown`

Type: `one of 4`  
Required: no  

Raw usage quantities. Only set for accounts on the new pricing model; credit fields are omitted for those accounts.

###### `duration`

Type: `number`  
Required: no  

The duration of the split request in seconds.

###### number

Type: `number`  

###### unknown

Type: `unknown`  

###### `result`

Type: `one of 3`  
Required: yes  

The split result. If force_url_result is True, this is returned as a URL result.

###### SplitResult

Type: `SplitResult`  

###### DeepSplitResult

Type: `DeepSplitResult`  

###### UrlResult

Type: `UrlResult`  

###### EditResponse

Type: `EditResponse`  

###### `response_type`

Type: `string`  
Required: no  
Default: `edit`  

###### `job_id`

Type: `string`  
Required: no  

The unique identifier for the edit job.

###### string

Type: `string`  

###### unknown

Type: `unknown`  

###### `document_url`

Type: `string`  
Required: yes  

Presigned URL to download the edited document.

###### `form_schema`

Type: `EditWidget[]`  
Required: no  

Form schema for PDF forms. List of widgets with their types, descriptions, and bounding boxes.

###### EditWidget[]

Type: `EditWidget[]`  

###### unknown

Type: `unknown`  

###### `usage`

Type: `ParseUsage`  
Required: no  

Usage information for the edit operation, including number of pages and credits charged.

###### ParseUsage

Type: `ParseUsage`  

###### unknown

Type: `unknown`  

###### `warnings`

Type: `string[]`  
Required: no  

Warnings about the edit, for example when no form fields were filled.

###### string[]

Type: `string[]`  

###### unknown

Type: `unknown`  

###### PipelineResponse

Type: `PipelineResponse`  

###### `response_type`

Type: `string`  
Required: no  
Default: `pipeline`  

###### `job_id`

Type: `string`  
Required: yes  

###### `usage`

Type: `ParseUsage`  
Required: yes  

###### `num_pages`

Type: `number`  
Required: yes  

###### `credits`

Type: `number`  
Required: no  

###### `credit_breakdown`

Type: `object`  
Required: no  

###### `page_billing_breakdown`

Type: `object`  
Required: no  

Per-page breakdown of features used. Maps 1-indexed page numbers (as strings) to the list of billing features applied on that page (e.g. 'page', 'complex', 'chart_agent').

###### `non_empty_cell_count`

Type: `number`  
Required: no  

Total non-empty cells across all sheets. Only set for spreadsheet inputs.

###### `usage_breakdown`

Type: `one of 4`  
Required: no  

Raw usage quantities. Only set for accounts on the new pricing model; credit fields are omitted for those accounts.

###### `result`

Type: `PipelineResult`  
Required: yes  

###### `parse`

Type: `ParseResponse | ParseResponse[]`  
Required: yes  

###### `extract`

Type: `one of 4`  
Required: yes  

###### `split`

Type: `SplitResponse`  
Required: yes  

###### `edit`

Type: `EditResponse`  
Required: no  

###### V3ExtractResponse

Type: `V3ExtractResponse`  

###### `response_type`

Type: `string`  
Required: no  
Default: `v3_extract`  

###### `job_id`

Type: `string`  
Required: no  

###### string

Type: `string`  

###### unknown

Type: `unknown`  

###### `usage`

Type: `ExtractUsage`  
Required: yes  

###### `num_pages`

Type: `number`  
Required: yes  

###### `num_fields`

Type: `number`  
Required: yes  

###### `credits`

Type: `number`  
Required: no  

###### `extract_mode`

Type: `string`  
Required: no  

###### `usage_breakdown`

Type: `ExtractUsageBreakdown`  
Required: no  

Raw usage quantities. Only set for accounts on the new pricing model; credit fields are omitted for those accounts.

###### `duration`

Type: `number`  
Required: no  

The duration of the extract request in seconds.

###### number

Type: `number`  

###### unknown

Type: `unknown`  

###### `studio_link`

Type: `string`  
Required: no  

The link to the studio pipeline for the document.

###### string

Type: `string`  

###### unknown

Type: `unknown`  

###### `confidence`

Type: `string`  
Required: no  

Optional document-level deep extract confidence label.

###### string

Type: `string`  
Allowed values: `high`, `low`  

###### unknown

Type: `unknown`  

###### `confidence_reason`

Type: `string`  
Required: no  

Optional explanation for the document-level confidence label.

###### string

Type: `string`  

###### unknown

Type: `unknown`  

###### `result`

Type: `unknown[]`  
Required: yes  

The extracted response in your provided schema. This is a list of dictionaries. If disable_chunking is True (default), then it will be a list of length one.

###### unknown

Type: `unknown`  

###### unknown[]

Type: `unknown[]`  

###### ClassifyResponse

Type: `ClassifyResponse`  

Response from classify job - returned when polling /job/{job_id}

###### `response_type`

Type: `string`  
Required: no  
Default: `classify`  

###### `job_id`

Type: `string`  
Required: yes  

###### `result`

Type: `ClassifyResponseCategory | UrlResult`  
Required: yes  

###### ClassifyResponseCategory

Type: `ClassifyResponseCategory`  

###### UrlResult

Type: `UrlResult`  

###### `response_confidence`

Type: `ResponseConfidence`  
Required: no  

###### ResponseConfidence

Type: `ResponseConfidence`  

Overall confidence breakdown for classification response.

###### unknown

Type: `unknown`  

###### `usage`

Type: `ClassifyUsage`  
Required: no  

###### ClassifyUsage

Type: `ClassifyUsage`  

###### unknown

Type: `unknown`  

###### `extra_metadata`

Type: `object`  
Required: no  

Additional metadata for the classify response. Contains `grouping` when the request set `category_groups`. Omitted when empty.

###### `duration`

Type: `number`  
Required: no  

The duration of the classify request in seconds.

###### number

Type: `number`  

###### unknown

Type: `unknown`  

###### ChartResponse

Type: `ChartResponse`  

Response from synchronous and persisted chart extraction jobs.

###### `response_type`

Type: `string`  
Required: no  
Default: `chart`  

###### `job_id`

Type: `string`  
Required: yes  

###### `result`

Type: `ChartResult`  
Required: yes  

###### `chart_data`

Type: `object`  
Required: yes  

###### `summary`

Type: `string`  
Required: yes  

###### `reconstruction_url`

Type: `string`  
Required: yes  

###### `verified`

Type: `boolean`  
Required: yes  

###### `usage`

Type: `ChartUsage`  
Required: no  

###### `num_charts`

Type: `number`  
Required: no  
Default: `1`  

###### `credits`

Type: `number`  
Required: no  
Default: `4`  

###### `duration`

Type: `number`  
Required: no  

###### number

Type: `number`  

###### unknown

Type: `unknown`  

###### unknown

Type: `unknown`  

###### `progress`

Type: `number`  
Required: no  

###### number

Type: `number`  

###### unknown

Type: `unknown`  

###### `reason`

Type: `string`  
Required: no  

###### string

Type: `string`  

###### unknown

Type: `unknown`  

###### `error`

Type: `ErrorDetail`  
Required: no  

###### ErrorDetail

Type: `ErrorDetail`  

Structured error body returned to customers.

Matches the format specified in ``ERROR_POLICY.md``.

###### `code`

Type: `number`  
Required: yes  

###### `name`

Type: `string`  
Required: yes  
Allowed values: `TIMEOUT`, `CAPACITY_TIMEOUT`, `CUSTOMER_TIMEOUT`, `INTERNAL_ERROR`, `SERVICE_UNAVAILABLE`, `GPU_ALLOCATION_ERROR`, `GPU_POOL_SATURATED`, `BATCH_QUEUE_FULL`, `QUEUE_FULL`, `JOB_STATE_ERROR`, `DOCUMENT_CORRUPT`, `DOCUMENT_EMPTY`, `DOCUMENT_UNSUPPORTED`, `DOCUMENT_TOO_LARGE`, `OFFICE_CONVERSION_TOO_LARGE`, `IMAGE_TOO_LARGE`, `IMAGE_TOO_SMALL`, `IMAGE_INVALID_ASPECT_RATIO`, `DOCUMENT_PASSWORD_PROTECTED`, `FORM_FILL_FAILED`, `INTERNAL_INVARIANT_VIOLATION`, `GPU_UNAVAILABLE`, `CONTEXT_WINDOW_EXCEEDED`, `OUTPUT_LIMIT_EXCEEDED`, `PROCESSING_FAILED`, `INFERENCE_METHOD_UNSUPPORTED`, `SUBPROCESS_CRASHED`, `BATCH_ORPHANED`, `OVERSIZED_RESULT`, `LLM_OUTPUT_PARSE_FAILED`, `LLM_PROVIDER_ERROR`, `INVALID_CONFIG`, `INVALID_SCHEMA`, `AUTH_ERROR`, `NOT_APPLICABLE`, `REGION_UNAVAILABLE`, `NOT_FOUND`, `JOB_DELETION_IN_PROGRESS`, `JOB_DELETED`, `JOB_NOT_COMPLETE`, `JOB_CANCELLED`, `RATE_LIMIT`, `CELL_COUNT_EXCEEDED`, `URL_NOT_ALLOWED`  

Machine-readable error names returned in API error responses.

Each member maps to a category (Transient / Processing / Input) and
a default HTTP status code defined in ``ERROR_CODE_DEFAULTS``.
The enum value is the string customers see in the ``error.name`` field.

###### `message`

Type: `string`  
Required: yes  

###### `job_id`

Type: `string`  
Required: no  

###### string

Type: `string`  

###### unknown

Type: `unknown`  

###### unknown

Type: `unknown`  

###### `type`

Type: `string`  
Required: no  

###### string

Type: `string`  
Allowed values: `Parse`, `Extract`, `Split`, `Edit`, `Pipeline`, `Classify`, `Chart`  

###### unknown

Type: `unknown`  

###### `num_pages`

Type: `number`  
Required: no  

###### number

Type: `number`  

###### unknown

Type: `unknown`  

###### `total_pages`

Type: `number`  
Required: no  

###### number

Type: `number`  

###### unknown

Type: `unknown`  

###### `source`

Type: `one of 2`  
Required: no  

###### unknown

Type: `unknown`  

###### unknown

Type: `unknown`  

###### `duration`

Type: `number`  
Required: no  

###### number

Type: `number`  

###### unknown

Type: `unknown`  

###### `created_at`

Type: `string`  
Required: no  

###### string

Type: `string`  
Format: `date-time`  

###### unknown

Type: `unknown`  

###### `raw_config`

Type: `string`  
Required: no  

###### string

Type: `string`  

###### unknown

Type: `unknown`  

###### `bucket`

Type: `one of 2`  
Required: no  

###### unknown

Type: `unknown`  

###### unknown

Type: `unknown`  

### Response `422`

Category: client-error  

Validation Error

#### `application/json`

##### Generated example

```json
{
  "detail": [
    {
      "loc": [
        "loc"
      ],
      "msg": "msg",
      "type": "type",
      "ctx": {}
    }
  ]
}
```

##### Schema

###### HTTPValidationError

Type: `HTTPValidationError`  

###### `detail`

Type: `ValidationError[]`  
Required: no  

###### ValidationError

Type: `ValidationError`  

###### `loc`

Type: `string | number[]`  
Required: yes  

###### string | number

Type: `string | number`  

###### string

Type: `string`  

###### number

Type: `number`  

###### `msg`

Type: `string`  
Required: yes  

###### `type`

Type: `string`  
Required: yes  

###### `input`

Type: `unknown`  
Required: no  

###### `ctx`

Type: `object`  
Required: no  

## Related representations

- [Human documentation](/api-reference/api/sections/jobs/operations/get-job/)
- [cURL Markdown](https://docs.reducto.ai/api-reference/api/curl/sections/jobs/operations/get-job.md)
