List Quality Datasets

List every ground truth dataset in your workspace with GET /v1/quality/ground-truth. Datasets hold verified field values used to benchmark extraction accuracy.

A ground truth dataset is a collection of manually verified field values that serves as the gold standard for benchmarking extraction accuracy. Ground truth datasets and benchmark runs together make up Benchmarks (the /v1/quality namespace). GET /v1/quality/ground-truth lists every dataset in your workspace so you can pick one to benchmark against. This is offline accuracy measurement, not the inline validation checks that gate individual results before delivery.

Use this endpoint to see all available datasets before creating a benchmark run. A typical workflow is to list datasets, select the one covering the document type you want to evaluate, then pass its id to POST /v1/quality/benchmarks to start a run.

Each dataset includes a name, optional description, user_schema_id (the schema it is scoped to), document_count (number of verified entries), and a links.self URL for the detail endpoint. Datasets are returned in descending creation order with cursor-based pagination.

Create separate datasets for different document types or schema versions to track accuracy independently. Pair with the benchmark endpoints to measure extraction accuracy over time: run benchmarks after schema or extraction changes to detect regressions.

• Each dataset contains verified entries mapping documents to expected field values
• Datasets can be scoped to a specific user schema via user_schema_id
• Use datasets as inputs to benchmark runs for per-field accuracy measurement

Response

{
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "Invoice Accuracy Set",
      "description": "Manually verified invoices for Q3 2024",
      "user_schema_id": null,
      "document_count": 50,
      "created_at": "2024-09-01T10:00:00.000Z",
      "links": {
        "self": "/v1/quality/ground-truth/a1b2c3d4-e5f6-7890-abcd-ef1234567890"
      }
    }
  ],
  "pagination": {
    "total": 3,
    "limit": 20,
    "has_more": false,
    "next_cursor": null
  }
}

Errors