Get Parser Run

Retrieve the status and results of a parser run.

Use this endpoint to get results for a parser run that has already completed, or to check on the status of an asynchronous parser run initiated via the Parse File Asynchronously endpoint.

If parsing is still in progress, you’ll receive a response with just the status. Once complete, you’ll receive the full parsed content in the response.

Retrieve the status and results of a parser run. Use this endpoint to get results for a parser run that has already completed, or to check on the status of an asynchronous parser run initiated via the [Parse File Asynchronously](https://docs.extend.ai/2025-04-21/developers/api-reference/parse-endpoints/parse-file-async) endpoint. If parsing is still in progress, you'll receive a response with just the status. Once complete, you'll receive the full parsed content in the response.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

idstringRequired

The unique identifier for the parser run.

Example: "parser_run_xK9mLPqRtN3vS8wF5hB2cQ"

Query parameters

responseTypeenumOptional

Controls the format of the response chunks. Defaults to json if not specified.

json - Returns chunks with inline content
url - Returns chunks with presigned URLs to content instead of inline data

Controls the format of the response chunks. Defaults to `json` if not specified. * `json` - Returns chunks with inline content * `url` - Returns chunks with presigned URLs to content instead of inline data

Allowed values:

Response

Successfully retrieved parser run

successboolean

parserRunobject

warningstring or null

Warning message about missing API version header if applicable

1	{
2	"success": true,
3	"parserRun": {
4	"object": "parser_run_status",
5	"id": "parser_run_xK9mLPqRtN3vS8wF5hB2cQ",
6	"status": "PROCESSING",
7	"failureReason": "string"
8	},
9	"warning": "string"
10	}