API ReferenceCorrectionsList Corrections

List Corrections

GET /api/v1/jobs/{job_id}/corrections/

Returns a paginated list of corrections for an extraction job.

Authentication

Requires an API key with jobs:read scope. Pass via the X-API-Key header.

Path Parameters

ParameterTypeDescription
job_idstring (UUID)The ID of the extraction job.

Response

Status: 200 OK

{
  "count": 2,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": "f6a7b8c9-0123-4567-89ab-cdef01234567",
      "job_id": "e5f6a7b8-c901-2345-6789-abcdef012345",
      "correction_type": "wrong_value",
      "field_path": "employees[0].gross_pay",
      "original_value": "5000.00",
      "corrected_value": "5250.00",
      "notes": "Verified against source document page 3",
      "created_at": "2026-03-16T12:00:00Z"
    }
  ]
}

Response Fields

FieldTypeDescription
countintegerTotal number of corrections.
nextstring or nullURL for the next page of results.
previousstring or nullURL for the previous page of results.
resultsarrayList of correction objects.

Correction Object

FieldTypeDescription
idstring (UUID)Unique identifier for the correction.
job_idstring (UUID)The extraction job this correction belongs to.
correction_typestringType of correction: wrong_value, wrong_field, missing_field, or spurious.
field_pathstringDot-notation path to the corrected field.
original_valuestringThe original extracted value.
corrected_valuestringThe corrected value.
notesstring or nullOptional explanation for the correction.
created_atstring (ISO 8601)Timestamp when the correction was created.

Errors

StatusDescription
401Missing or invalid API key.
403API key does not have jobs:read scope.
404Extraction job not found.

Code Examples

curl https://api.parsifyhq.com/api/v1/jobs/e5f6a7b8-c901-2345-6789-abcdef012345/corrections/ \
  -H "X-API-Key: YOUR_API_KEY"