Geografía
GET /api/v1/geografia — departamentos, distritos y ciudades de Paraguay para autocompletar direcciones.
El catálogo público permite elegir departamentos, distritos y ciudades de Paraguay. No requiere API key.
Usá el campo codigo de cada resultado para los códigos geográficos de las direcciones. Los identificadores terminados en Id sirven para recorrer este catálogo; no son los códigos SIFEN.
Consultas
| Ruta | Resultado |
|---|---|
GET /api/v1/geografia/departamentos | Departamentos |
GET /api/v1/geografia/departamentos/{departamentoId}/distritos | Distritos del departamento seleccionado |
GET /api/v1/geografia/distritos/{distritoId}/ciudades | Ciudades del distrito seleccionado |
GET /api/v1/geografia/departamentos/{departamentoId}/ciudades | Ciudades de todos los distritos del departamento |
Las cuatro consultas devuelven 200 OK con los resultados dentro de data. La respuesta también incluye timestamp y errors. Si no hay resultados, data es una lista vacía.
Ejemplos de respuesta
Estos extractos muestran el formato de las respuestas. Las ciudades por departamento tienen los mismos campos que las ciudades por distrito. Capital tiene código 1; Concepción, 2; y Central, 12.
GET /api/v1/geografia/departamentos:
{
"data": [
{ "departamentoId": 1, "codigo": 1, "nombre": "CAPITAL" },
{ "departamentoId": 2, "codigo": 2, "nombre": "CONCEPCION" },
{ "departamentoId": 12, "codigo": 12, "nombre": "CENTRAL" }
],
"timestamp": "2026-10-02T10:30:00-03:00",
"errors": null
}Campos de cada resultado
| Campo | Tipo | Presencia y uso |
|---|---|---|
codigo | integer | Código geográfico SIFEN |
nombre | string | Nombre para mostrar en el selector |
departamentoId | integer | Departamentos y distritos; usalo en la consulta de distritos |
distritoId | integer | Distritos y ciudades; usalo en la consulta de ciudades |
ciudadId | integer | Identifica un resultado de ciudad |
Recorrer el catálogo
curl -s https://api.sifende.com.py/api/v1/geografia/departamentos | jq '.data'
curl -s "https://api.sifende.com.py/api/v1/geografia/departamentos/$DEPARTAMENTO_ID/distritos" | jq '.data'
curl -s "https://api.sifende.com.py/api/v1/geografia/distritos/$DISTRITO_ID/ciudades" | jq '.data'- Cargá los departamentos y mostrá su
nombre. - Al elegir uno, usá su
departamentoIdpara consultar los distritos. - Al elegir el distrito, usá su
distritoIdpara consultar las ciudades. - Conservá los
codigode los resultados elegidos para completar la dirección.
Si la dirección no necesita distrito, como en una autofactura, consultá las ciudades directamente con /departamentos/{departamentoId}/ciudades.
En el receptor, departamento y ciudad aceptan nombres o códigos expresados como texto; codigoDistrito es numérico. Respetá los tipos indicados en el modelo de cada dirección, incluidas las de nota de remisión. En autofactura, departamento y ciudad aceptan sólo códigos SIFEN expresados como texto.