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"const url = new URL("https://colonix.silgaru.mx/v1/states");
const res = await fetch(url, { headers: { "x-api-key": process.env.COLONIX_API_KEY }, signal: AbortSignal.timeout(5000),});const data = await res.json();if (!res.ok) throw new Error(`${data.type}: ${data.detail}`);
console.log(data);import osimport requests
res = requests.get( "https://colonix.silgaru.mx/v1/states", headers={"x-api-key": os.environ["COLONIX_API_KEY"]}, timeout=5,)data = res.json()if not res.ok: raise RuntimeError(f"{data['type']}: {data['detail']}")
print(data)<?php$url = "https://colonix.silgaru.mx/v1/states";$ch = curl_init($url);curl_setopt_array($ch, [ CURLOPT_HTTPHEADER => ["x-api-key: " . getenv("COLONIX_API_KEY")], CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 5,]);$data = json_decode(curl_exec($ch), true);if (curl_getinfo($ch, CURLINFO_RESPONSE_CODE) !== 200) { throw new RuntimeException("{$data['type']}: {$data['detail']}");}
print_r($data);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.
{ "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
| Campo | Tipo | Descripción |
|---|---|---|
data | lista de objetos | |
data[].id | texto | Clave oficial |
data[].name | texto | Nombre |
data_version | texto | Versión del dato |
Errores
Todos en formato application/problem+json; ninguno cuenta para tu cuota. Qué hacer con cada uno: Errores.
| Estado | Cuándo |
|---|---|
401 | Credenciales faltantes (/errors/missing-api-key) o inválidas (/errors/invalid-api-key). |
403 | Llave suspendida (/errors/api-key-suspended) o endpoint fuera de tu plan (/errors/plan-not-allowed). |
429 | Se 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. |
5XX | Error 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. |
© 2026 Silgaru