Check your results

Get a job

GETDELETE/v1/jobs/{job_id}

See a job's status and, once it's complete, its results. Use it after any analysis, or skip polling by adding a webhook_url to the analysis request.

Poll async jobs for status, progress, result, and errors. Same resource supports cancelling a job while it is still queued. Auth: X-API-Key on both methods.

Returns: Job statusand result when complete
Status values: complete or failedonce finished; queued, processing or cancelled before
Shortcut: poll_urlfrom the 202 response
Auth: API keyX-API-Key header

GET — Poll job

You can also build this URL from the poll_url in any 202 response by adding the base URL in front.

Returns a single JSON object for the job. input_s3_key and input_s3_bucket are not exposed; the API includes a presigned pdf_url for the source PDF (default expiry 3600s in _make_presigned_url). The shape varies by lifecycle stage; see the queued and complete examples.

Post-processing on read applies only to door-detector: result.doors / result.doors_found are filtered. TOC and content-extractor results are returned as stored.

Field	Description
`id`string	Job UUID.
`status`string	queued, processing, complete, failed, cancelled, …
`model`string	toc-parser, content-extractor, door-detector, …
`model_version`string	Model version string.
`tier`string	When applicable.
`cached`boolean	When applicable.
`cached_from_job_id`string	When applicable.
`queued_at`timestamp	When the job was queued.
`processing_started_at`timestamp	When processing began.
`completed_at`timestamp	When the job finished.
`processing_time_ms`integer	Recorded processing duration.
`input_page_count`integer	Input metadata.
`input_file_size_bytes`integer	Input metadata.
`input_source`string	Input metadata.
`progress`string	Human-readable status string.
`result`object \| null	null until complete (or absent); shape depends on model.
`error_code`string \| null	On failure, the same value as error.code.
`error`object \| null	On failure, { code, message }: a stable code and a message you can show. null otherwise.
`webhook_url`string	If set on submit.
`webhook_delivered_at`timestamp	If delivered.
`expires_at`timestamp	Job row expiry; GET requires expires_at > now().
`pdf_url`string	Presigned GET for the job PDF.

Worker failures (e.g. URL_UNREACHABLE, PDF_CORRUPT, TIMEOUT, INTERNAL_ERROR) appear as status: failed with an error object, for example {"code": "PDF_CORRUPT", "message": "The submitted PDF could not be processed."}.

DELETE — Cancel job

Cancels a job only while status is queued. Same auth and ownership rules as GET.

Field	Description
`job_id`string · UUID	The cancelled job.
`status`string	cancelled

Errors

Status	What it means
404	Unknown id, another account’s job, or expires_at ≤ now() — same response in all cases (anti-enumeration).

Status	What it means
404	Same as GET — missing job or not your account.
409JOB_NOT_CANCELLABLE	Already processing, complete, failed, etc.

Usage

Submitting jobs (for example spec parse or content-extract) counts toward your plan's allowance; polling GET /v1/jobs and DELETE /v1/jobs do not.

Typical spec workflow

POST /v1/documents → document_id
POST /v1/specs/parse/document → TOC job_id
GET /v1/jobs/{toc_job_id} until complete → result.divisions / section codes
POST /v1/specs/content-extract with job_id: TOC job id and section_codes and/or division_codes
GET /v1/jobs/{content_job_id} until complete → result.sections

Examples

curl -s https://api.anchorgrid.ai/v1/jobs/7c9e6679-7425-40de-944b-e07fc1f90ae7 \
  -H "X-API-Key: <your-api-key>"

Response · 200 · queued

{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "status": "queued",
  "model": "toc-parser",
  "model_version": "toc-parser-v1.0.0",
  "progress": "Queued",
  "result": null,
  "queued_at": "2025-03-01T18:00:00.000Z",
  "processing_started_at": null,
  "completed_at": null,
  "processing_time_ms": null,
  "pdf_url": "https://s3.example.com/presigned-get…"
}

Response · 200 · complete

{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "status": "complete",
  "model": "toc-parser",
  "model_version": "toc-parser-v1.0.0",
  "tier": "developer",
  "cached": false,
  "queued_at": "2025-03-01T18:00:00.000Z",
  "processing_started_at": "2025-03-01T18:00:02.000Z",
  "completed_at": "2025-03-01T18:00:17.000Z",
  "processing_time_ms": 12000,
  "input_page_count": 86,
  "input_file_size_bytes": 2411724,
  "input_source": "upload",
  "progress": "Complete",
  "result": {
    "toc_found": true,
    "division_count": 3,
    "section_count": 42,
    "divisions": [],
    "model_version": "toc-parser-v1.0.0",
    "processing_time_ms": 12000
  },
  "error_code": null,
  "error": null,
  "webhook_url": null,
  "webhook_delivered_at": null,
  "expires_at": "2025-04-01T18:00:00.000Z",
  "pdf_url": "https://s3.example.com/presigned-get…"
}

curl -X DELETE https://api.anchorgrid.ai/v1/jobs/7c9e6679-7425-40de-944b-e07fc1f90ae7 \
  -H "X-API-Key: <your-api-key>"

Response · DELETE 200

{
  "job_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "status": "cancelled"
}