Catálogos

Conjunto de endpoints para consultar los catálogos geográficos de México: estados, municipios, colonias y sus relaciones.

Estados

`GET /get_estados`

Lista todos los estados y entidades federativas de México.

curl "https://api.copomex.com/query/get_estados?token=pruebas"

{
  "error": false,
  "code_error": 0,
  "error_message": null,
  "response": {
    "estado": [
      "Aguascalientes",
      "Baja California",
      "Baja California Sur",
      "Ciudad de México",
      "Jalisco"
    ]
  }
}

`GET /get_estado_clave`

Lista los estados con su clave oficial de 2 dígitos (clave INEGI).

curl "https://api.copomex.com/query/get_estado_clave?token=pruebas"

{
  "error": false,
  "code_error": 0,
  "error_message": null,
  "response": {
    "estado_clave": {
      "Aguascalientes": "01",
      "Baja California": "02",
      "Ciudad de México": "09",
      "Jalisco": "14"
    }
  }
}

Municipios

`GET /get_municipio_por_estado/{estado}`

Lista los municipios de un estado.

curl "https://api.copomex.com/query/get_municipio_por_estado/Jalisco?token=pruebas"

{
  "error": false,
  "code_error": 0,
  "error_message": null,
  "response": {
    "municipios": ["Guadalajara", "Zapopan", "Tlaquepaque", "Tonalá"]
  }
}

`GET /get_municipio_clave_por_estado/{estado}`

Municipios de un estado con su clave oficial de 3 dígitos.

curl "https://api.copomex.com/query/get_municipio_clave_por_estado/Jalisco?token=pruebas"

`GET /get_municipio_clave_por_clave_estado/{clave_estado}`

Municipios con clave oficial usando la clave numérica del estado.

curl "https://api.copomex.com/query/get_municipio_clave_por_clave_estado/14?token=pruebas"

`GET /getCitiesByStateCode/{clave_estado}`

Ciudades de un estado identificado por su clave.

curl "https://api.copomex.com/query/getCitiesByStateCode/09?token=pruebas"

Códigos postales

`GET /get_cp_por_municipio/{municipio}`

Lista los CPs de un municipio.

curl "https://api.copomex.com/query/get_cp_por_municipio/Cuauhtemoc?token=pruebas"

{
  "error": false,
  "code_error": 0,
  "error_message": null,
  "response": {
    "cp": ["06000", "06010", "06020", "06030", "06600"]
  }
}

`GET /get_cp_por_estado/{estado}`

Lista todos los CPs de un estado.

curl "https://api.copomex.com/query/get_cp_por_estado/Jalisco?token=pruebas"

`GET /search_cp_advanced/{estado}`

Búsqueda avanzada de CPs filtrada por municipio y/o colonia dentro de un estado.

Parámetro	Tipo	Requerido	Descripción
`{estado}`	`string`	Sí	Nombre del estado (ruta)
`token`	`string`	Sí	Token de proyecto
`municipio`	`string`	No	Filtrar por municipio
`colonia`	`string`	No	Filtrar por nombre de colonia
`limit`	`integer`	No	Máximo de resultados

curl "https://api.copomex.com/query/search_cp_advanced/Jalisco?municipio=Guadalajara&colonia=Chapalita&token=pruebas"

`GET /get_cp_advanced/{estado}`

Igual que search_cp_advanced pero devuelve solo coincidencias exactas.

curl "https://api.copomex.com/query/get_cp_advanced/Jalisco?municipio=Guadalajara&token=pruebas"

Colonias

`GET /get_colonia_por_cp/{CP}`

Lista solo los nombres de las colonias de un CP.

curl "https://api.copomex.com/query/get_colonia_por_cp/06600?token=pruebas"

{
  "error": false,
  "code_error": 0,
  "error_message": null,
  "response": {
    "colonia": ["Juárez", "Tabacalera", "Santa María la Ribera"]
  }
}

Usa /info_cp/{CP} si necesitas municipio, estado y tipo de asentamiento además de los nombres.

`GET /get_colonia_por_municipio/{municipio}`

Lista todas las colonias de un municipio.

curl "https://api.copomex.com/query/get_colonia_por_municipio/Cuauhtemoc?token=pruebas"

`GET /get_colonia_por_estado_municipio`

Lista las colonias con su CP correspondiente, filtradas por estado y municipio.

Parámetro	Requerido	Descripción
`estado`	Sí	Nombre del estado
`municipio`	Sí	Nombre del municipio
`token`	Sí	Token de proyecto

curl "https://api.copomex.com/query/get_colonia_por_estado_municipio?estado=Ciudad%20de%20Mexico&municipio=Cuauhtemoc&token=pruebas"