List Validation Runs
List validation runs that compare extraction results against ground-truth datasets. Requires read scope.
List all validation runs for your organization, ordered by most recent first. A validation run compares the structured output of a job run against a ground-truth dataset to produce per-field and overall accuracy scores.
Each run includes its status (pending, running, completed, failed), the overall accuracy score (available once completed), and links to the detailed results. Use this to track validation history and identify accuracy trends.
GET
/v1/validation/runsResponse
Response fields
dataarrayArray of validation run objects (up to 100, ordered by created_at descending).
data[].idstringValidation run UUID.
data[].namestringHuman-readable run name.
data[].statusstringRun status: pending, running, completed, or failed.
data[].dataspace_run_idstring | nullUUID of the job run being validated.
data[].golden_sample_idstringUUID of the ground-truth dataset.
data[].accuracynumber | nullOverall accuracy score (0–1) once the run completes.
data[].total_comparisonsinteger | nullTotal number of field comparisons made.
data[].created_atstringISO 8601 creation timestamp.
data[].completed_atstring | nullISO 8601 completion timestamp.
data[].linksobjectRelated resource URLs (self, results).
Response
{
"data": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"name": "Q1 Invoice accuracy check",
"status": "completed",
"dataspace_run_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"golden_sample_id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
"accuracy": 0.94,
"total_comparisons": 250,
"created_at": "2024-09-14T10:32:00.000Z",
"completed_at": "2024-09-14T10:35:00.000Z",
"links": {
"self": "/v1/validation/runs/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"results": "/v1/validation/runs/a1b2c3d4-e5f6-7890-abcd-ef1234567890/results"
}
}
]
}Errors
Error responses
401unauthorizedMissing or invalid API key.
429rate_limitedToo many requests. Retry after the period indicated in the Retry-After header.