Get / Delete Ground Truth Dataset

Retrieve a Ground Truth dataset with all expected values, or delete it permanently. GET requires read scope, DELETE requires write scope on the same path.

GET /v1/validation/ground-truth/{id} retrieves the full detail of a Ground Truth dataset, including every manually verified expected value entry; DELETE on the same path permanently removes it. These datasets are the reference side of Benchmarks: accuracy measurement of extraction output, distinct from the in-pipeline checks that gate results before delivery.

Call GET before starting a validation run to verify that expected values are correct and complete. The values array contains every document-field pair with its expected_value, document_id, and field_name. Review these to ensure the benchmark data reflects your current extraction requirements.

The response includes entry_count for a quick size check and user_schema_id to confirm schema scope. The values array entries each have their own UUID (id) and created_at timestamp. If the dataset is unscoped (user_schema_id: null), it can validate fields across any schema.

Use DELETE only when the dataset is no longer relevant. Existing validation runs that referenced this dataset are retained with their results intact, but you cannot create new runs against a deleted dataset. To update individual entries, recreate the dataset in the Talonic platform with corrected values.

Response

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "Invoice Validation Set",
  "user_schema_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "entry_count": 50,
  "created_at": "2024-08-01T00:00:00.000Z",
  "updated_at": "2024-08-01T00:00:00.000Z",
  "links": {
    "self": "/v1/validation/ground-truth/a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  },
  "values": [
    {
      "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
      "document_id": "d4e5f6a7-b8c9-0123-defa-234567890123",
      "field_name": "invoice_number",
      "expected_value": "INV-2024-0042",
      "created_at": "2024-08-01T00:00:00.000Z"
    }
  ]
}

{
  "deleted": true
}

Errors