Empezar en 5 minutos

Sigue estos pasos para hacer tu primera consulta a la API de COPOMEX.

Paso 1 — Crea tu cuenta

Regístrate gratis en el panel de control:

👉 api.copomex.com/panel/checkout

Recibirás 50 consultas gratis para comenzar a integrar.

Paso 2 — Genera tu token

Una vez dentro del panel, crea un proyecto y copia el token asignado. Lo usarás en cada petición como parámetro token.

Modo pruebas — Si todavía no tienes cuenta, usa el token especial pruebas. Devuelve datos genéricos, ideal para desarrollo. No consume créditos.

Paso 3 — Consulta un código postal

Obtén la información de un código postal con una petición GET sencilla:

curl "https://api.copomex.com/query/info_cp/06600?type=simplified&token=pruebas"

Respuesta

{
  "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": "Ciudad de México",
    "pais": "México"
  }
}

Paso 4 — Explora más endpoints

Con el mismo token puedes consultar catálogos de estados, municipios o hacer búsquedas por coincidencia:

# Todos los estados de México
curl "https://api.copomex.com/query/get_estados?token=pruebas"
 
# Búsqueda por CP parcial
curl "https://api.copomex.com/query/search_cp/066?token=pruebas"
 
# Municipios de un estado
curl "https://api.copomex.com/query/get_municipio_por_estado/Jalisco?token=pruebas"

¿Qué sigue?

• Revisa todos los endpoints disponibles
• Aprende el uso del token en distintos lenguajes
• Aprende a manejar errores