Skip to main content

Job Results

Retrieve the extracted result rows for a job. Each row corresponds to one document and contains extracted field values, confidence score, and validation flags.

Retrieve the extracted result rows for a completed (or partially completed) job. Each row corresponds to one document and contains the extracted field values keyed by field name, a row-level confidence score, and any validation flags raised during Phase 4. Results are available progressively as each pipeline phase flushes to the database.

Results are available even while the job is still processing. The grid flushes to the database after each phase, so you can read partial results before the job completes.
GET/v1/jobs/:id/results

Response

Response fields

job_idstringJob UUID.
job_statusstringCurrent job status (complete, processing, failed, etc.).
schemaobject | nullSchema used for this job: { id, name }.
total_rowsintegerTotal number of result rows.
dataarrayArray of result row objects.
data[].idstringResult row UUID.
data[].document_idstringSource document UUID.
data[].filenamestringSource document filename.
data[].statusstringRow processing status.
data[].valuesobjectExtracted field values keyed by field name.
data[].confidencenumber | nullRow-level confidence score (0–1).
data[].validation_flagsarrayArray of validation flag strings for this row.
links.selfstringURL of this results resource.
links.jobstringURL of the parent job.

Response

{
  "job_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "job_status": "complete",
  "schema": { "id": "sch_uuid_1", "name": "Invoice" },
  "total_rows": 2,
  "data": [
    {
      "id": "res_uuid_1",
      "document_id": "doc_uuid_1",
      "filename": "invoice_oct.pdf",
      "status": "approved",
      "values": {
        "invoice_number": "INV-2024-001",
        "vendor": "Acme Corp",
        "total": 4250.00,
        "date": "2024-10-01"
      },
      "confidence": 0.94,
      "validation_flags": []
    },
    {
      "id": "res_uuid_2",
      "document_id": "doc_uuid_2",
      "filename": "invoice_nov.pdf",
      "status": "review",
      "values": {
        "invoice_number": "INV-2024-002",
        "vendor": "Acme Corp",
        "total": null,
        "date": "2024-11-15"
      },
      "confidence": 0.71,
      "validation_flags": ["missing_required_field:total"]
    }
  ],
  "links": {
    "self": "/v1/jobs/a1b2c3d4-e5f6-7890-abcd-ef1234567890/results",
    "job": "/v1/jobs/a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}

Returns one row per document with field values keyed by the schema field names you defined. Rows with validation_flags containing entries like missing_required_field:<name> or format_mismatch:<name> indicate Phase 4 detected data quality issues. Use the confidence score to prioritize which rows need manual review -- values below 0.8 typically warrant inspection.

Errors

Error responses

400validation_errorInvalid job ID format. Must be a UUID.
401unauthorizedMissing or invalid API key.
404not_foundNo job with this ID exists for your organization.
429rate_limitedToo many requests. Retry after the period indicated in the Retry-After header.

Related

Get Job
Create Job