Códigos postales de la Ciudad de México
Ciudad de México concentra 1,110 códigos postales repartidos en 16 alcaldías y 1,531 colonias. Van del 01000 al 16900.
- Códigos postales
- 1,110
- Alcaldías
- 16
- Colonias
- 1,531
- Rango
- 01000–16900
Los dos primeros dígitos son el estado
Ciudad de México usa 16 prefijos de dos dígitos: 01, 02, 03, 04, 05, 06, 07, 08, 09, 10, 11, 12, 13, 14, 15, 16. Un código que empiece con cualquiera de ellos está en Ciudad de México y en ningún otro estado.
- 01
- 02
- 03
- 04
- 05
- 06
- 07
- 08
- 09
- 10
- 11
- 12
- 13
- 14
- 15
- 16
Eso vale para todo el país: entre los 31,880 códigos postales del catálogo, no hay un solo prefijo de dos dígitos que compartan dos estados. Por eso se puede saber el estado con un código a medio escribir, y por eso una búsqueda por prefijo de dos dígitos es un filtro por estado disfrazado.
Por número de códigos postales, Ciudad de México ocupa el lugar 11 de 32 estados; por número de alcaldías, el 26.
Alcaldías de la Ciudad de México
16 en total, en orden alfabético, con la clave INEGI que la API devuelve en municipality.code y el tramo que cubren sus códigos postales.
| Nombre | INEGI | Códigos postales | Rango |
|---|---|---|---|
| Álvaro Obregón | 010 | 119 | 01000–01904 |
| Azcapotzalco | 002 | 74 | 02000–02990 |
| Benito Juárez | 014 | 52 | 03000–03940 |
| Coyoacán | 003 | 71 | 04000–04980 |
| Cuajimalpa de Morelos | 004 | 41 | 05000–05790 |
| Cuauhtémoc | 015 | 41 | 06000–06920 |
| Gustavo A. Madero | 005 | 134 | 07000–07990 |
| Iztacalco | 006 | 36 | 08000–08930 |
| Iztapalapa | 007 | 117 | 09000–09970 |
| La Magdalena Contreras | 008 | 37 | 10000–10926 |
| Miguel Hidalgo | 016 | 61 | 11000–11950 |
| Milpa Alta | 009 | 19 | 12000–12950 |
| Tláhuac | 011 | 55 | 13000–13700 |
| Tlalpan | 012 | 111 | 14000–14900 |
| Venustiano Carranza | 017 | 65 | 15000–15990 |
| Xochimilco | 013 | 77 | 16000–16900 |
Un rango es un primer código y un último código, no una afirmación de que todo lo que hay en medio pertenezca al mismo lugar. Los rangos se traslapan, y esa es la razón habitual de que una consulta por rango devuelva más de lo que esperabas.
Los mismos datos, en JSON
Esta tabla es una sola llamada. Ciudad de México tiene el id 1 en el catálogo, y pedir sus códigos postales recorre los 1,110, de veinte en veinte.
Solicitud
curl -H "Authorization: Bearer YOUR_API_KEY" \ https://api.postalkit.mx/v1/states/1/postal-codes
Respuesta
{
"data": [
{
"id": 1,
"code": "01000",
"state": {
"id": 1,
"name": "Ciudad de México",
"code": "09"
},
"municipality": {
"id": 1,
"name": "Álvaro Obregón",
"code": "010"
},
"city": {
"id": 1,
"name": "Ciudad de México"
}
}
],
"links": { "first": "...", "last": "...", "prev": null, "next": "..." },
"meta": { "current_page": 1, "total": 1110, "per_page": 20 }
}
Si lo que traes es el nombre y no el id, la búsqueda geográfica lo acepta como texto, y acepta el nombre que escribiría una persona, no solo el del catálogo.
Solicitud
curl -H "Authorization: Bearer YOUR_API_KEY" \ "https://api.postalkit.mx/v1/postal-codes/search?state=Ciudad%20de%20M%C3%A9xico"
Un nivel más abajo, /v1/states/1/municipalities devuelve la tabla de arriba con sus ids, que es sobre lo que se arma un menú en cascada estado → alcaldía.
Antes de copiarla
Qué hay en esta página, y qué hay detrás
-
La fuente es el catálogo nacional de SEPOMEX.
Cada cifra de aquí es un conteo sobre las mismas filas con las que responde la API: el catálogo que publica Correos de México, importado completo y no por muestra.
-
Se revisa cada mes, y solo se mueve cuando se mueve la fuente.
La actualización compara un hash del catálogo publicado antes de escribir nada, así que un mes sin cambios deja los datos intactos. GET /v1/account/db-version te dice qué versión estás leyendo.
-
Un código postal no es un polígono.
El catálogo es una lista de códigos con las colonias que cuelgan de cada uno, no un archivo de fronteras. Te dice qué colonias comparten un código; no te dibuja la forma de ninguno.
-
Un código, muchas colonias.
Es el caso normal, no la excepción: Ciudad de México tiene 1,531 colonias repartidas en 1,110 códigos. Un formulario que espere que un código lleve a un solo barrio se va a equivocar más veces de las que acierte.