> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wava.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Document Types

> Retrieve valid national document types for buyer identification.

# Document Types

<Warning>
  **Deprecated.** This endpoint remains functional for backwards compatibility but is no longer the recommended approach. The `POST /orders` response now includes an `allowed_documents` field with the same data. See [Creating Orders](/orders/creating-orders) for details.
</Warning>

All direct API orders require a national ID number (`id_number`) and document type (`id_type`) for buyer identification and compliance. Use this endpoint to retrieve the valid document types for a given country.

## Request

```bash theme={null}
curl -X GET "https://api.wava.co/v1/national-document-types/CO" \
  -H "merchant-key: YOUR_MERCHANT_KEY"
```

## Response

```json theme={null}
{
  "data": [
    {
      "id_national_document_type": 1,
      "country_code": "CO",
      "type": "CC",
      "description": "Cédula de Ciudadanía"
    },
    {
      "id_national_document_type": 2,
      "country_code": "CO",
      "type": "CE",
      "description": "Cédula de Extranjería"
    },
    {
      "id_national_document_type": 3,
      "country_code": "CO",
      "type": "TI",
      "description": "Tarjeta de Identidad"
    }
  ]
}
```

## How to use

Pass the `id_national_document_type` value as the `id_type` field in the shopper object when [creating orders](/orders/creating-orders):

```json theme={null}
"shopper": {
  "id_number": "12345678",
  "id_type": 1
}
```

<Note>
  The `id_type` field currently accepts the integer ID from this endpoint. The API also accepts `id_national_document_type` as an alias for `id_type`.
</Note>

## Gateway-specific restrictions

Not all gateways accept all document types. When creating an order, ensure the document type is supported by the selected gateway:

| Gateway   | Accepted document types                         |
| --------- | ----------------------------------------------- |
| Nequi     | All Colombian document types (CC, CE, TI, etc.) |
| Daviplata | CC, CE, TI only                                 |
| Breb      | CC, CE, TI only                                 |

<Warning>
  Sending an unsupported document type for Daviplata or Breb will result in a payment error from the gateway.
</Warning>

## Supported countries

| Country code | Country  |
| ------------ | -------- |
| `CO`         | Colombia |

<Note>
  Additional countries will be added as Wava expands across Latin America.
</Note>