Ir al contenido

Estados

GET/v1/statesTodos los planes

¿Qué hace?

Los 32 estados de México con sus claves del INEGI, para un selector de estado o para filtrar otros endpoints.

Sin paginar.

La petición

No lleva parámetros.

Ejemplo

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

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": "01",
"name": "Aguascalientes"
},
{
"id": "02",
"name": "Baja California"
},
{
"id": "03",
"name": "Baja California Sur"
},
{
"id": "04",
"name": "Campeche"
},
{
"id": "05",
"name": "Coahuila de Zaragoza"
},
{
"id": "06",
"name": "Colima"
},
{
"id": "07",
"name": "Chiapas"
},
{
"id": "08",
"name": "Chihuahua"
},
{
"id": "09",
"name": "Ciudad de México"
},
{
"id": "10",
"name": "Durango"
},
{
"id": "11",
"name": "Guanajuato"
},
{
"id": "12",
"name": "Guerrero"
},
{
"id": "13",
"name": "Hidalgo"
},
{
"id": "14",
"name": "Jalisco"
},
{
"id": "15",
"name": "México"
},
{
"id": "16",
"name": "Michoacán de Ocampo"
},
{
"id": "17",
"name": "Morelos"
},
{
"id": "18",
"name": "Nayarit"
},
{
"id": "19",
"name": "Nuevo León"
},
{
"id": "20",
"name": "Oaxaca"
},
{
"id": "21",
"name": "Puebla"
},
{
"id": "22",
"name": "Querétaro"
},
{
"id": "23",
"name": "Quintana Roo"
},
{
"id": "24",
"name": "San Luis Potosí"
},
{
"id": "25",
"name": "Sinaloa"
},
{
"id": "26",
"name": "Sonora"
},
{
"id": "27",
"name": "Tabasco"
},
{
"id": "28",
"name": "Tamaulipas"
},
{
"id": "29",
"name": "Tlaxcala"
},
{
"id": "30",
"name": "Veracruz de Ignacio de la Llave"
},
{
"id": "31",
"name": "Yucatán"
},
{
"id": "32",
"name": "Zacatecas"
}
],
"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
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).
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.