---
title: "Get a document schema"
method: GET
path: "/document_schemas/{id}"
tags: ["Document Schemas"]
---

# Get a document schema

`GET /document_schemas/{id}`

## Path parameters

- `id` string, required

## Response `200`

OK

- object
  - `data` DocumentSchema
    - `id` string, required
    - `type` 'document_schema', required
    - `attributes` object
      - `document_type` string — Document type this schema applies to (for example, commercial_invoice).
      - `label` string — Human-readable label for the document type.
      - `schema_version` string — Public schema version identifier.
      - `full_version` string — Fully-qualified schema version id (for example, commercial_invoice@2026-03-23).
      - `current` boolean — Whether this schema version is currently active.
      - `draft` boolean — Whether this schema version is marked as draft.
      - `active_at` string, date-time, nullable — Timestamp when this schema version became active.
      - `schema_format` 'json_schema' — Schema payload format.
      - `description` string, nullable — Optional notes describing this schema.
      - `schema_payload` object — JSON Schema payload used to validate and describe extracted fields.
      - `created_at` string, date-time — When this schema record was created.
      - `updated_at` string, date-time — When this schema record was last updated.
    - `links` object
      - `self` string
  - `links` LinkSelf
    - `self` string, uri

## Other responses

- `401` — Unauthorized
- `404` — Not Found

---

[API](https://skmtc.dev/terminal49/apis/terminal49-api-reference.md) · [All operations](https://skmtc.dev/terminal49/apis/terminal49-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/terminal49/terminal49-api-reference/revisions/998a27e39c03/schema)