---
title: "List supported DIR document types"
method: GET
path: "/dir/document_types"
tags: ["Reference Data"]
---

# List supported DIR document types

`GET /dir/document_types`

Reference list of `document_type` values accepted by `DirCreateRequest.documents[].document_type` and the infringement-contest endpoint. Each entry has a stable `short_name` (used in API calls) and a customer-facing description.

## Response `200`

List of supported document types.

- DocumentTypeReferenceList
  - `data` DocumentTypeReference[], required
    - `description` string
    - `short_name` string — Stable identifier passed to `Document.document_type`.
  - `meta` BrandedCallingPaginationMeta, required — JSON:API pagination metadata returned with every paginated list response. Page numbering is 1-based. `page_size` reports the number of items actually returned in `data` for this page; the requested size is taken from the `page[size]` query parameter.
    - `page_number` integer, required — 1-based index of this page. Echoes the `page[number]` query parameter (default `1`).
    - `page_size` integer, required — Number of items returned in this page's `data` array. Capped at 250.
    - `total_pages` integer, required — Total number of pages available given the current `page_size`.
    - `total_results` integer, required — Total number of items across all pages (excludes soft-deleted rows).

## Other responses

- `4XX` — An error occurred. The response carries the standard Telnyx error envelope.
- `default` — An error occurred. The response carries the standard Telnyx error envelope.

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/3fdc16374d70/schema)