03/6 endpoints
Lista los 32 estados de México y entra al detalle de los municipios, ciudades, códigos postales y colonias de cada uno, por ID interno o por clave oficial del INEGI.
https://api.postalkit.mx
/v1/states
Devuelve todos los estados de México con sus IDs y códigos oficiales. Usa el id para consultar municipios.
Solicitud
curl -H "Authorization: Bearer YOUR_API_KEY" \ https://api.postalkit.mx/v1/states
Respuesta
{
"data": [
{ "id": 2, "name": "Aguascalientes", "code": "01" },
{ "id": 1, "name": "Ciudad de México", "code": "09" }
]
}
/v1/states/{id}/municipalities
Devuelve todos los municipios de un estado dado. Obtén el id del estado de Listar Estados.
| Parámetro | Tipo | Descripción |
|---|---|---|
| id | integer | ID numérico del estado |
Solicitud
curl -H "Authorization: Bearer YOUR_API_KEY" \ https://api.postalkit.mx/v1/states/1/municipalities
Respuesta
{
"data": [
{ "id": 1, "name": "Álvaro Obregón", "code": "010" },
{ "id": 6, "name": "Cuauhtémoc", "code": "015" }
]
}
{ "message": "State with id 999 not found." }
/v1/states/by-code/{code}/municipalities
Devuelve todos los municipios que pertenecen al estado identificado por su código INEGI de 2 dígitos, ordenados alfabéticamente.
| Parámetro | Tipo | Descripción |
|---|---|---|
| code | string | Código INEGI de estado de 2 dígitos, ej. 09 |
Solicitud
curl -H "Authorization: Bearer YOUR_API_KEY" \ https://api.postalkit.mx/v1/states/by-code/09/municipalities
Respuesta
{
"data": [
{ "id": 1, "name": "Álvaro Obregón", "code": "010" },
{ "id": 6, "name": "Cuauhtémoc", "code": "015" }
]
}
{ "message": "State with code '99' not found." }
/v1/states/{id}/cities
Devuelve todas las ciudades que pertenecen al estado dado, ordenadas alfabéticamente.
| Parámetro | Tipo | Descripción |
|---|---|---|
| id | integer | ID numérico del estado |
Solicitud
curl -H "Authorization: Bearer YOUR_API_KEY" \ https://api.postalkit.mx/v1/states/2/cities
Respuesta
{
"data": [
{ "id": 1, "name": "Aguascalientes" },
{ "id": 2, "name": "Calvillo" }
]
}
{ "message": "State with id 999 not found." }
/v1/states/{id}/postal-codes
Devuelve todos los códigos postales que pertenecen al estado dado, ordenados por código y paginados.
| Parámetro | Tipo | Descripción |
|---|---|---|
| id | integer | ID numérico del estado |
Solicitud
curl -H "Authorization: Bearer YOUR_API_KEY" \ https://api.postalkit.mx/v1/states/2/postal-codes
Respuesta
{
"data": [
{
"id": 1,
"code": "20000",
"state": { "id": 2, "name": "Aguascalientes", "code": "01" },
"municipality": { "id": 1, "name": "Aguascalientes", "code": "001" },
"city": { "id": 1, "name": "Aguascalientes" }
}
],
"links": { "first": "...", "last": "...", "prev": null, "next": "..." },
"meta": { "current_page": 1, "total": 100, "per_page": 20 }
}
{ "message": "State with id 999 not found." }
/v1/states/{id}/municipalities/{mid}/settlements
Devuelve todas las colonias que pertenecen al municipio dado dentro del estado dado, ordenadas alfabéticamente y paginadas con 20 resultados por página.
| Parámetro | Tipo | Descripción |
|---|---|---|
| id | integer | ID numérico del estado |
| mid | integer | ID numérico del municipio |
Solicitud
curl -H "Authorization: Bearer YOUR_API_KEY" \ https://api.postalkit.mx/v1/states/1/municipalities/6/settlements
Respuesta
{
"data": [
{
"id": 532,
"name": "Juárez",
"zone": "Urbano",
"settlement_type": { "id": 1, "name": "Colonia" },
"postal_code": { "id": 384, "code": "06600" }
}
],
"links": { "first": "...", "last": "...", "prev": null, "next": "..." },
"meta": { "current_page": 1, "total": 33, "per_page": 20 }
}
{ "message": "State with id 999 not found." }
{ "message": "Municipality with id 999 not found." }
Comienza a consultar el catálogo postal completo en minutos.
curl -s https://api.postalkit.mx/v1/postal-codes/06600 -H "Authorization: Bearer YOUR_API_KEY"