Job endpoints

After submitting a job, poll status and download the result.

Get job status

GET /job/{id}
X-Fast-Api-Key: YOUR_API_KEY

Typical statuses:

Status	Meaning
`queued`	The job is waiting to start.
`running`	The job is processing.
`succeeded`	The ZIP is ready.
`failed`	The job failed; inspect the stable error code.
`canceled`	The job was canceled.

Poll with backoff. A practical starting point is every 1 to 2 seconds while queued or running, then slower after repeated unchanged responses.

Content-absent PDF selections can end as failed with a stable code even though processing worked as designed. extract.pdf.no_markdown_content_found means the Markdown engine found only structural markers, and extract.pdf.no_ocr_text_found means OCR found no readable text. These outcomes produce no artifact and are not charged.

Download result

GET /job/{id}/download
X-Fast-Api-Key: YOUR_API_KEY

Downloads a ZIP when the job has succeeded. The ZIP is deleted automatically after the configured retention window.

This public API form always requires a valid Pro API key and job ownership. The Extract.FAST website also receives a server-authored, same-origin URL for completed rows; that first-party browser request uses its signed owner proof or account session instead of an API key. If any API key is presented, public API rules take precedence.

Cancel job

POST /job/{id}/cancel
X-Fast-Api-Key: YOUR_API_KEY

Cancellation mirrors the other Tools.FAST APIs. It can cancel queued or running work when the job state allows it. If a charged job is canceled or fails after debit, refund handling follows the service billing state machine.

Delete job

DELETE /job/{id}
X-Fast-Api-Key: YOUR_API_KEY

Deletes job metadata and stored artifacts when the job is accessible to the caller and the state allows deletion.

PreviousTranscribe

NextDiscovery

# Job endpoints

After submitting a job, poll status and download the result.

## Get job status

```http
GET /job/{id}
X-Fast-Api-Key: YOUR_API_KEY
```

Typical statuses:

| Status | Meaning |
| --- | --- |
| `queued` | The job is waiting to start. |
| `running` | The job is processing. |
| `succeeded` | The ZIP is ready. |
| `failed` | The job failed; inspect the stable error code. |
| `canceled` | The job was canceled. |

Poll with backoff. A practical starting point is every 1 to 2 seconds while queued or running, then slower after repeated unchanged responses.

Content-absent PDF selections can end as `failed` with a stable code even though
processing worked as designed. `extract.pdf.no_markdown_content_found` means the
Markdown engine found only structural markers, and `extract.pdf.no_ocr_text_found`
means OCR found no readable text. These outcomes produce no artifact and are not
charged.

## Download result

```http
GET /job/{id}/download
X-Fast-Api-Key: YOUR_API_KEY
```

Downloads a ZIP when the job has succeeded. The ZIP is deleted automatically after the configured retention window.

This public API form always requires a valid Pro API key and job ownership. The Extract.FAST
website also receives a server-authored, same-origin URL for completed rows; that first-party
browser request uses its signed owner proof or account session instead of an API key. If any API
key is presented, public API rules take precedence.

## Cancel job

```http
POST /job/{id}/cancel
X-Fast-Api-Key: YOUR_API_KEY
```

Cancellation mirrors the other Tools.FAST APIs. It can cancel queued or running work when the job state allows it. If a charged job is canceled or fails after debit, refund handling follows the service billing state machine.

## Delete job

```http
DELETE /job/{id}
X-Fast-Api-Key: YOUR_API_KEY
```

Deletes job metadata and stored artifacts when the job is accessible to the caller and the state allows deletion.

Copied