Benchmarks

Create a validation run

Start a new validation run against a ground-truth dataset.

post/v1/validation/runs

Request

Base URL: https://api.talonic.com
URL: https://api.talonic.com/v1/validation/runs
Auth: HTTP bearer

Request body

golden_sample_idstring uuid required

Ground-truth dataset to validate against.

schema_idstring uuid

Optional schema to scope the validation.

Example request

{
  "golden_sample_id": "e5f6a7b8-c9d0-1234-efab-345678901234",
  "schema_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901"
}

Response

Validation run created.

idstring uuid required

golden_sample_idstring uuid

schema_idstring uuid nullable

status'pending' | 'running' | 'completed' | 'failed' required

accuracy_overallnumber float nullable

documents_processedinteger nullable

created_atstring date-time required

completed_atstring date-time nullable

Example response

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "golden_sample_id": "e5f6a7b8-c9d0-1234-efab-345678901234",
  "schema_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "status": "completed",
  "created_at": "2026-04-25T14:30:00.000Z",
  "completed_at": "2026-04-25T14:30:00.000Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.