Skip to main content

Get Job

Retrieve the current status, pipeline phase, and progress for an extraction job. Poll this endpoint or use webhooks for completion events.

GET/v1/jobs/:id

Path parameters

ParameterTypeDescription
idstringThe job ID (e.g., job_def456)

Example

curl https://api.talonic.com/v1/jobs/job_def456 \
  -H "Authorization: Bearer tlnc_sk_live_7f3a...x9k2"

Response

{
  "id": "job_def456",
  "document_id": "doc_xyz789",
  "extraction_id": "ext_abc123",
  "status": "completed",
  "phase": "re-read",
  "progress": 1.0,
  "created_at": "2026-04-20T14:30:00Z",
  "completed_at": "2026-04-20T14:31:22Z"
}

Related

Get Extraction Data
Fetch results after job completion.
Cancel Job
Cancel a running job.
Four-Phase Pipeline
Resolve, agent, validate, re-read phases.
Webhooks
Event-driven notifications.
Error Handling
Error codes and response format.