c_CodigoPostal

Consulta el catálogo de códigos postales de México con su desglose territorial (estado, municipio y localidad).

Endpoint

GET /api/v1/catalogos/c_CodigoPostal/entradas

Pruébalo

Consulta interactiva del catálogo. Demo pública sin API key, limitada a 10 resultados.

Cargando ejemplo…

Parámetros de consulta

Parámetro	Tipo	Descripción
`clave`	string	Filtra por clave exacta.
`descripcion`	string	Filtra por coincidencia parcial en la descripción.
`page`	integer	Número de página (por defecto 1).
`per_page`	integer	Resultados por página (por defecto 50, máximo 200).
`estado`	string	Filtra por clave de estado.
`municipio`	string	Filtra por clave de municipio.
`localidad`	string	Filtra por clave de localidad.

Ejemplo con curl

curl -H "Authorization: Bearer <token>" \
  "https://localhost:8080/api/v1/catalogos/c_CodigoPostal/entradas?clave=20000&page=1&per_page=10"

Formato de respuesta

{
  "data": [
    {
      "clave": "20000",
      "estado": "AGU",
      "municipio": "001",
      "localidad": "01",
      "estado_descripcion": "Aguascalientes",
      "municipio_descripcion": "Aguascalientes",
      "localidad_descripcion": "Aguascalientes",
      "colonias": [
        {"clave": "0000", "descripcion": "Aguascalientes Centro"},
        {"clave": "0004", "descripcion": "Zona Centro"}
      ]
    }
  ],
  "page": 1,
  "per_page": 10,
  "total": 1
}