---
title: "Returns a list of supported document formats"
method: GET
path: "/document/formats"
---

# Returns a list of supported document formats

`GET /document/formats`

The list of supported formats supported by the Document Translation
service.
The list includes the common file extension, as well as the
content-type if using the upload API.

## Query parameters

- `api-version` string, required
- `type` 'Document' | 'Glossary', required

## Response `200`

The request has succeeded.

- SupportedFileFormats — List of supported file formats
  - `value` FileFormat[], required — list of objects
    - `format` string, required — Name of the format
    - `fileExtensions` string[], required — Supported file extension for this format
    - `contentTypes` string[], required — Supported Content-Types for this format
    - `defaultVersion` string — Default version if none is specified
    - `versions` string[] — Supported Version
    - `type` 'Document' | 'Glossary' — Format types

## Other responses

- `default` — An unexpected error response.

## Changes

- **2026-07-13** (2023-11-01-preview) `2a29f2b714b8` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/azure/apis/translation-documenttranslation/changes/document/formats/get.md)

---

[API](https://skmtc.dev/azure/apis/translation-documenttranslation.md) · [All operations](https://skmtc.dev/azure/apis/translation-documenttranslation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/translation-documenttranslation/revisions/f29cf344b9da/schema)