01/5 endpoints
API de códigos postales
Consulta cualquier código postal de México y obtén su estado, municipio, ciudad y colonias. Busca por prefijo numérico, o por estado, municipio y nombre de colonia, y lista los asentamientos de un solo código.
En esta página
Datos postales de México actualizados
Referencia de API
Acceso programático a códigos postales, colonias, municipios y estados. Cada respuesta es JSON, cada solicitud lleva un solo token Bearer.
Seis de los 21 endpoints —localidades, calles y geocodificación— están desplegados y responden, pero el catálogo que va detrás todavía no está cargado, así que vuelven vacíos. Están marcados más abajo.
URL base
https://api.postalkit.mx
- códigos postales
- 31,880 códigos postales
- colonias
- 159,019 colonias
- municipios
- 2,478 municipios
- estados
- 32 estados
Autenticación
Cada solicitud debe incluir tu token de API en el encabezado Authorization. Genera un token desde tu panel después de registrarte.
Authorization: Bearer YOUR_API_KEY
Las solicitudes sin un token válido devuelven 401 Unauthorized
.
Endpoints
La referencia es una página por recurso. Todas las rutas son relativas a la URL base y los segmentos entre {llaves} son parámetros obligatorios.
02/1 endpoints
API de búsqueda de colonias
Busca colonias de México por nombre en todo el catálogo y obtén el código postal, el municipio y el estado detrás de cada coincidencia.
03/6 endpoints
API de estados y municipios
Lista los 32 estados de México y entra al detalle de los municipios, ciudades, códigos postales y colonias de cada uno, por ID interno o por clave oficial del INEGI.
04/2 endpoints
API de municipios
Obtén todos los códigos postales y todas las colonias de un municipio de México, identificado por su ID.
05/2 endpoints Sin datos aún
API de localidades
Busca localidades de México por nombre y consulta una localidad con el municipio y el estado a los que pertenece. Estos endpoints están activos, pero el catálogo de localidades que va detrás todavía no está cargado.
06/2 endpoints Sin datos aún
API de calles
Busca nombres de calles de México dentro de un estado y un municipio, acota los resultados a una localidad y consulta los tipos de vialidad oficiales. Estos endpoints están activos, pero el catálogo de calles que va detrás todavía no está cargado.
07/1 endpoints Sin datos aún
API de geocodificación inversa
Convierte un par de latitud y longitud en el código postal de México más cercano, con su estado y municipio. Este endpoint está activo, pero ningún código postal del catálogo trae coordenadas todavía.
08/2 endpoints
API de cuenta y consumo
Consulta la cuota de tu plan, cuántas peticiones te quedan este mes y la fecha de la última actualización del catálogo postal.
Límites y Errores
Cuotas Mensuales
| Plan | Solicitudes / Mes |
|---|---|
| Gratis | 100 |
| Starter | 5,000 |
| Pro | 50,000 |
| Business | 250,000 |
Consulta precios para los detalles de planes y precios mensuales.
Encabezados de Límite
Cada respuesta de la API incluye estos encabezados:
X-RateLimit-Limit: 100 X-RateLimit-Remaining: 58
Respuestas de Error
| Estado | Significado |
|---|---|
| 401 Unauthorized | Token de API faltante o inválido |
| 404 Not Found | El recurso (código postal o estado) no existe |
| 422 Unprocessable Entity | Entrada inválida, revisa el campo message para más detalles |
| 429 Too Many Requests | Cuota mensual excedida |