Skip to main content

Schema Fields

Get per-field structuring metrics for a schema including field-level state distribution, capture rates, and strategy breakdown.

GET/v1/telemetry/schemas/{id}/fields

Response

Response fields

dataarrayArray of per-field telemetry objects.
data[].field_namestringField name.
data[].capture_ratenumberFraction of rows where this field was captured (0–1).
data[].synthesize_ratenumberFraction of rows where this field was synthesized by LLM (0–1).
data[].strategystringMost common strategy used for this field.
data[].state_distributionobjectCount of cells per state (filled, empty, skipped).

Response

{
  "data": [
    {
      "field_name": "invoice_number",
      "capture_rate": 0.98,
      "synthesize_rate": 0.01,
      "strategy": "transfer",
      "state_distribution": {
        "filled": 196,
        "empty": 2,
        "skipped": 2
      }
    },
    {
      "field_name": "payment_terms",
      "capture_rate": 0.54,
      "synthesize_rate": 0.38,
      "strategy": "extract",
      "state_distribution": {
        "filled": 184,
        "empty": 14,
        "skipped": 2
      }
    }
  ]
}

Errors

Error responses

401unauthorizedMissing or invalid API key.
404not_foundNo schema with this ID exists for your organization.
429rate_limitedToo many requests. Retry after the period indicated in the Retry-After header.

Related

Schema Summary