# Catálogos del API Bancario

> Catálogo de tipos de identificación de cliente por país en el API Bancario.

- kind: api-operation
- status: stable
- api_version: 1.0.0
- last_verified: 2026-09-02
- url: https://www.tilopay.com/developers/api-bancario/catalogos

El grupo `Catalogs` publica los valores que tu integración debe usar en los campos de
identificación de cliente, en vez de codificarlos a mano.

```http
GET /api/public/v1/catalogs/customer-identification-types
```

Filtrá por `country_code` de dos letras para obtener los tipos vigentes en ese país.
Consultá el catálogo al iniciar la integración y cacheá el resultado; leelo de nuevo antes
de agregar un país nuevo.

## Operaciones [#operaciones]

### List customer identification person types [#get-catalogs-customer-identification-types]

```http
GET /api/public/v1/catalogs/customer-identification-types
```

Host: `https://api-baas-sandbox.tilopay.com` — requiere `Authorization: Bearer <access_token>`.

Returns the distinct customer person types (`individual`, `business`, `both`) available
for the authenticated tenant, optionally filtered by country. This is a person-type
classification, not the payment identification-document catalog (`cedula`, `juridica`,
`dimex`, ...) used by `identification.type` on `POST /payments`.

**Parámetros**

| Parámetro | En | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
| `X-Correlation-Id` | header | string | — | Optional client-supplied correlation id for end-to-end tracing. Echoed back as `correlation_id` in the response envelope. If omitted, the API generates one and still returns it. |
| `country_code` | query | string | — | Optional ISO-2 country code used to filter results. A legacy `country` query parameter is also accepted as an alias when `country_code` is omitted; prefer `country_code`. |

**200** — The request was processed successfully.

`response_code`: `OK`

Campos de `data`:

| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `items` | array<object> | sí | — |
| `items[].code` | string | sí | — |

**Respuestas de error**

| HTTP | response_code | Descripción |
|---|---|---|
| 401 | `UNAUTHORIZED` | Unauthorized. Verify your session or credentials. |
| 403 | `FORBIDDEN` | You do not have permission to perform this action. |
| 429 | `TOO_MANY_REQUESTS` | Too many requests. Please retry after a short delay. |
| 500 | `INTERNAL_ERROR` | An unexpected error occurred. Please try again later. |
| 502 | — | Dependency error |
| 503 | `SERVICE_UNAVAILABLE` | A required service is temporarily unavailable. Please try again later. |