Ir al contenido

Municipios de un estado

GET/v1/states/{state}/municipalitiesTodos los planes

¿Qué hace?

Los municipios (o alcaldías) de un estado con sus claves, para un selector de municipio o para filtrar otros endpoints.

Todos los municipios del estado (sin paginar; el estado más grande tiene 570).

La petición

ParámetroTipoValores aceptadosDescripción
stateen la rutaobligatoriotexto
2 dígitos
Clave INEGI del estado (2 dígitos).
qen la consultatexto
de 2 a 100 caracteres
Texto a buscar, sin importar mayúsculas ni acentos (de 2 a 100 caracteres, hasta 12 palabras).

Ejemplo

curl -H "x-api-key: TU_LLAVE" "https://colonix.silgaru.mx/v1/states/09/municipalities"

Cambia TU_LLAVE por tu llave; en los lenguajes, se lee de la variable de entorno COLONIX_API_KEY. Esta petición es la que produjo la respuesta de abajo.

La respuesta

Respuesta real a la petición del ejemplo. Viene con los encabezados ETag, X-Data-Version, Cache-Control.

200 OK
{
"data": [
{
"id": "002",
"name": "Azcapotzalco"
},
{
"id": "003",
"name": "Coyoacán"
},
{
"id": "004",
"name": "Cuajimalpa de Morelos"
},
{
"id": "005",
"name": "Gustavo A. Madero"
},
{
"id": "006",
"name": "Iztacalco"
},
{
"id": "007",
"name": "Iztapalapa"
},
{
"id": "008",
"name": "La Magdalena Contreras"
},
{
"id": "009",
"name": "Milpa Alta"
},
{
"id": "010",
"name": "Álvaro Obregón"
},
{
"id": "011",
"name": "Tláhuac"
},
{
"id": "012",
"name": "Tlalpan"
},
{
"id": "013",
"name": "Xochimilco"
},
{
"id": "014",
"name": "Benito Juárez"
},
{
"id": "015",
"name": "Cuauhtémoc"
},
{
"id": "016",
"name": "Miguel Hidalgo"
},
{
"id": "017",
"name": "Venustiano Carranza"
}
],
"data_version": "2026.11.05-36a7823b"
}

Campos

CampoTipoDescripción
datalista de objetos
data[].idtextoClave oficial
data[].nametextoNombre
data_versiontextoVersión del dato

Errores

Todos en formato application/problem+json; ninguno cuenta para tu cuota. Qué hacer con cada uno: Errores.

EstadoCuándo
400Parámetro inválido o repetido (/errors/invalid-parameter), un parámetro que el endpoint no tiene (/errors/unknown-parameter), cursor vencido (/errors/cursor-expired), versión del dato desconocida (/errors/unknown-version) o as_of fuera del historial registrado (/errors/as-of-out-of-range).
401Credenciales faltantes (/errors/missing-api-key) o inválidas (/errors/invalid-api-key).
403Llave suspendida (/errors/api-key-suspended) o endpoint fuera de tu plan (/errors/plan-not-allowed).
404El recurso no existe (/errors/postal-code-not-found, /errors/state-not-found, /errors/municipality-not-found, /errors/location-not-covered o /errors/route-not-found). No cuenta para tu cuota.
429Se alcanzó la cuota mensual (/errors/quota-exceeded) o el límite por minuto (/errors/rate-limited). La respuesta del límite por minuto trae el mismo cuerpo, pero con Content-Type: application/json.
5XXError inesperado (/errors/internal-error) o servicio no disponible por un momento (503, que puede llegar sin cuerpo). Reintenta unas cuantas veces, esperando cada vez más.