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

# Catálogos geográficos

> Departamentos, distritos y localidades del catálogo SET.

e-Miti expone endpoints de datos de referencia que tu integración puede usar para construir formularios de selección, validar ubicaciones o pre-completar campos antes de emitir un DE.

<Note>
  Para buscar y administrar el catálogo de clientes de tu tenant (alta, edición, baja, consulta del padrón DNIT), ver [Receptores](/api-reference/receptores).
</Note>

## Catálogo geográfico SET

El catálogo geográfico está organizado en tres niveles jerárquicos: **departamento → distrito → localidad**. Los códigos que devuelven estos endpoints son los mismos que se usan en los campos `codigo_departamento`, `codigo_distrito` y `codigo_ciudad` de `receptor` y `autofactura`.

### GET /v1/catalogos/departamentos

Devuelve la lista completa de departamentos (\~18 ítems). No requiere filtros.

```bash theme={null}
curl "https://api.emiti.fravelabs.com/v1/catalogos/departamentos" \
  -H "Authorization: ApiKey emiti_k_xxxxxxxxxxxxxxxxxxxxxxxx"
```

**Respuesta `200`:**

```json theme={null}
{
  "departamentos": [
    { "codigo": 1,  "nombre": "CAPITAL" },
    { "codigo": 2,  "nombre": "CONCEPCION" },
    { "codigo": 12, "nombre": "CENTRAL" }
  ]
}
```

### GET /v1/catalogos/distritos

Devuelve distritos del departamento indicado. Sin el parámetro `departamento` devuelve todos.

| Param          | Tipo      | Requerido | Descripción                          |
| -------------- | --------- | --------- | ------------------------------------ |
| `departamento` | `integer` | no        | Código de departamento para filtrar. |

```bash theme={null}
curl "https://api.emiti.fravelabs.com/v1/catalogos/distritos?departamento=1" \
  -H "Authorization: ApiKey emiti_k_xxxxxxxxxxxxxxxxxxxxxxxx"
```

**Respuesta `200`:**

```json theme={null}
{
  "distritos": [
    { "codigo": 1, "nombre": "ASUNCION", "codigo_departamento": 1 }
  ]
}
```

### GET /v1/catalogos/localidades

Devuelve localidades del distrito indicado. Sin `distrito` devuelve la tabla completa (\~6 764 ítems, \~200 KB).

| Param      | Tipo      | Requerido | Descripción                      |
| ---------- | --------- | --------- | -------------------------------- |
| `distrito` | `integer` | no        | Código de distrito para filtrar. |

```bash theme={null}
curl "https://api.emiti.fravelabs.com/v1/catalogos/localidades?distrito=1" \
  -H "Authorization: ApiKey emiti_k_xxxxxxxxxxxxxxxxxxxxxxxx"
```

**Respuesta `200`:**

```json theme={null}
{
  "localidades": [
    { "codigo": 1, "nombre": "ASUNCION", "codigo_distrito": 1 }
  ]
}
```

<Tip>
  Cargá los tres niveles de forma progresiva en tus formularios (dpto → distrito → localidad) para evitar payloads grandes. Con TanStack Query o SWR podés cachear cada nivel.
</Tip>

<Note>
  Todos los endpoints de esta página requieren autenticación aunque la información sea pública — son datos compartidos entre tenants (no filtrados por tenant, a diferencia de `/v1/receptores`).
</Note>