Create Job

Create an asynchronous document extraction job with POST /v1/jobs: pass a schema_id and optional document_ids, then poll the returned job ID for results.

POST /v1/jobs creates an asynchronous Job (formerly called a structuring run): it runs the 4-phase extraction pipeline over a set of documents and fills your schema's fields into a structured grid. The job immediately enters pending status and processes in the background; the response returns a job ID you poll for progress and a results link for the extracted rows.

curl -X POST https://api.talonic.com/v1/jobs \
  -H "Authorization: Bearer $TALONIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "schema_id": "sch_uuid_1",
    "document_ids": ["doc_uuid_1", "doc_uuid_2"],
    "name": "Q4 Invoice Run"
  }'

Response

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "pending",
  "message": "Job created and queued for processing.",
  "links": {
    "self": "/v1/jobs/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "results": "/v1/jobs/a1b2c3d4-e5f6-7890-abcd-ef1234567890/results"
  }
}

Most integrations call POST /v1/jobs immediately after defining or updating a schema via the schemas API. Once created, poll GET /v1/jobs/:id every 2-5 seconds and watch for status transitioning to complete. Pair with GET /v1/jobs/:id/results to retrieve the structured output rows as soon as the job finishes.

Errors