Consulta colonias, municipio, estado y ciudad a partir de un código postal mexicano.
Devuelve toda la información asociada a un código postal: colonias, tipo de asentamiento, municipio, estado, ciudad y país.
GET https://api.copomex.com/query/info_cp/{CP}?token={token}
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
{CP} | string | Sí | Código postal de 5 dígitos (ruta) |
token | string | Sí | Token de proyecto |
type | string | No | Usa simplified para respuesta compacta |
type=simplified)Devuelve un array de objetos, uno por cada colonia asociada al CP. Incluye todos los campos SEPOMEX.
curl "https://api.copomex.com/query/info_cp/06600?token=pruebas"[
{
"error": false,
"code_error": 0,
"error_message": null,
"response": {
"cp": "06600",
"asentamiento": "Juárez",
"tipo_asentamiento": "Colonia",
"municipio": "Cuauhtémoc",
"estado": "Ciudad de México",
"ciudad": "Ciudad de México",
"pais": "México"
}
},
{
"error": false,
"code_error": 0,
"error_message": null,
"response": {
"cp": "06600",
"asentamiento": "Tabacalera",
"tipo_asentamiento": "Colonia",
"municipio": "Cuauhtémoc",
"estado": "Ciudad de México",
"ciudad": "Ciudad de México",
"pais": "México"
}
}
]Cada objeto del array representa una colonia. Los campos municipio, estado, ciudad y pais son idénticos en todos los elementos.
type=simplified)Devuelve un objeto único con todas las colonias agrupadas en un array.
curl "https://api.copomex.com/query/info_cp/06600?type=simplified&token=pruebas"{
"error": false,
"code_error": 0,
"error_message": null,
"response": {
"cp": "06600",
"asentamiento": ["Juárez", "Tabacalera", "Santa María la Ribera"],
"tipo_asentamiento": "Colonia",
"municipio": "Cuauhtémoc",
"estado": "Ciudad de México",
"ciudad"
Usa este modo cuando solo necesitas los nombres de las colonias y los datos básicos del CP.
| Campo | Tipo | Descripción |
|---|---|---|
cp | string | Código postal consultado |
asentamiento | string | string[] | Nombre(s) de la(s) colonia(s) |
tipo_asentamiento | string | Tipo: Colonia, Fraccionamiento, Pueblo, etc. |
municipio | string | Municipio o delegación |
estado | string | Entidad federativa |
ciudad | string | Ciudad (puede ser igual al estado en zonas metropolitanas) |
pais | string | Siempre "México" |
| Código | Mensaje | Causa |
|---|---|---|
101 | No se recibió el cp | Falta el parámetro de ruta {CP} |
102 | La longitud del cp es inválida | El CP no tiene 5 dígitos |
104 | El cp es un número negativo | El CP contiene caracteres inválidos |