Skip to main content
GET
Retrieve a schema

Authorizations

Authorization
string
header
required

Bearer token obtained from the /v1/auth endpoint

Path Parameters

schemaId
string
required

The schema ID (from GET /v1/schemas). Must be non-blank, ≤1500 characters, contain no /, and must not start with _ or ..

Response

Detail for the schema, including every field it can return in results.

Success response from GET /v1/schemas/{schemaId}. New keys may be added over time; ignore ones you do not recognise. Inputs are deliberately not included — see GET /v1/schemas/{schemaId}/required-inputs.

schemaId
string
required

Echoes the path parameter.

name
string
required

Human-readable schema name, the same value as in GET /v1/schemas. Falls back to the schemaId when the schema sets no name.

requestType
string
required

The request type this schema produces (e.g. vob, claim-status), the same value as in GET /v1/schemas. Informational: derived from the schema, not something you supply on POST /v1/requests, which is keyed on schemaId.

resultsFields
object[]
required

Every field this schema can return in results, sorted by name, describing the schema's current latest version. Never empty: a schema with no readable fields returns 500. A superset of the keys any single request contributes from this schema. A chained request can also carry a follow-up schema's keys, which are not listed here.