API Códigos Postales
Consulta información detallada de códigos postales mexicanos con base de datos SEPOMEX actualizada.
Se requiere una API key para usar esta API. Fuente oficial SEPOMEX.
Regístrate para ComenzarCaracterísticas
✓ Base de Datos SEPOMEX
Información oficial del Servicio Postal Mexicano actualizada regularmente.
✓ Detalles Completos
Estado, municipio, ciudad, colonias, tipo de asentamiento y zona (urbana/rural).
✓ Coordenadas Geográficas
Latitud y longitud para integración con mapas y servicios de geolocalización.
✓ Validación de Direcciones
Estandariza y normaliza direcciones para mejorar entregas y logística.
Endpoint API
GET https://api.tlaloc.sh/mx/v1/zip?code={codigo_postal}
Parámetros
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
code |
string | Sí | Código postal (5 dígitos) |
Ejemplo de Solicitud
Necesitas una API key tipo Bearer (prefijo tlmx_) que generas en la consola.
curl -X GET "https://api.tlaloc.sh/mx/v1/zip?code=64000" \
-H "Authorization: Bearer tlmx_TU_API_KEY"
Ejemplo de Respuesta
[
{
"asentamiento": "Monterrey Centro",
"tipo_asentamiento": "Colonia",
"municipio": "Monterrey",
"estado": "Nuevo León",
"ciudad": "Monterrey",
"cp_administracion": "64000",
"clave_estado": "19",
"cp_oficina_reparto": "64000",
"clave_tipo_asentamiento": "09",
"clave_municipio": "039",
"zona": "Urbano",
"clave_ciudad": "001",
"clave_asentamiento": "0001"
}
]
Casos de Uso
E-commerce y Logística
Valida direcciones de envío y calcula costos de entrega precisos.
Formularios Web
Autocompletado inteligente de direcciones en formularios.
Análisis Geográfico
Segmentación de mercado y análisis demográfico por ubicación.
Servicios a Domicilio
Verifica cobertura y optimiza rutas de entrega.
Preguntas Frecuentes
¿Qué información devuelve la API por código postal?
Todos los asentamientos (colonias) del código postal con su tipo, municipio o alcaldía, estado, ciudad, zona (urbana/rural) y las claves oficiales de cada campo. La respuesta es un arreglo: un código postal puede tener decenas de colonias.
¿De dónde salen los datos?
Del catálogo nacional de códigos postales de SEPOMEX (Correos de México), que mantenemos actualizado.
¿Sirve para validar el código postal de un CFDI 4.0?
Sí. El SAT exige que el código postal del domicilio fiscal del receptor exista y coincida; validar contra el catálogo evita rechazos por código postal inexistente.
¿Cuánto cuesta?
$0.01 MXN (0.01 unidades) por consulta, IVA incluido — pensada para usarse en cada formulario sin preocuparte por el costo.
¿Para qué se usa normalmente esta API?
Autocompletar dirección en checkouts y formularios de envío (el usuario teclea 5 dígitos y obtienes colonia, municipio y estado), validar direcciones antes de generar guías, y normalizar bases de datos de clientes.