Códigos postales de Veracruz

Los dos primeros dígitos son el estado

Veracruz usa 6 prefijos de dos dígitos: 91, 92, 93, 94, 95, 96. Un código que empiece con cualquiera de ellos está en Veracruz y en ningún otro estado.

• 91
• 92
• 93
• 94
• 95
• 96

Eso vale para todo el país: entre los 31,880 códigos postales del catálogo, no hay un solo prefijo de dos dígitos que compartan dos estados. Por eso se puede saber el estado con un código a medio escribir, y por eso una búsqueda por prefijo de dos dígitos es un filtro por estado disfrazado.

Por número de códigos postales, Veracruz ocupa el lugar 1 de 32 estados; por número de municipios, el 3. SEPOMEX lo registra con su nombre oficial completo, Veracruz de Ignacio de la Llave, y ese es el nombre que la API devuelve en state.name.

Municipios de Veracruz

212 en total, en orden alfabético, con la clave INEGI que la API devuelve en municipality.code y el tramo que cubren sus códigos postales.

Un rango es un primer código y un último código, no una afirmación de que todo lo que hay en medio pertenezca al mismo lugar. Los rangos se traslapan, y esa es la razón habitual de que una consulta por rango devuelva más de lo que esperabas.

Los mismos datos, en JSON

Esta tabla es una sola llamada. Veracruz tiene el id 30 en el catálogo, y pedir sus códigos postales recorre los 2,483, de veinte en veinte.

Solicitud

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.postalkit.mx/v1/states/30/postal-codes

Respuesta

{
  "data": [
    {
        "id": 28174,
        "code": "91000",
        "state": {
            "id": 30,
            "name": "Veracruz de Ignacio de la Llave",
            "code": "30"
        },
        "municipality": {
            "id": 2103,
            "name": "Xalapa",
            "code": "087"
        },
        "city": {
            "id": 565,
            "name": "Xalapa-Enríquez"
        }
    }
  ],
  "links": { "first": "...", "last": "...", "prev": null, "next": "..." },
  "meta": { "current_page": 1, "total": 2483, "per_page": 20 }
}

Si lo que traes es el nombre y no el id, la búsqueda geográfica lo acepta como texto, y acepta el nombre que escribiría una persona, no solo el del catálogo.

Solicitud

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.postalkit.mx/v1/postal-codes/search?state=Veracruz"

Un nivel más abajo, /v1/states/30/municipalities devuelve la tabla de arriba con sus ids, que es sobre lo que se arma un menú en cascada estado → municipio.

Otros estados, y las llamadas detrás de esta página

Los otros 31 están en el directorio de estados. Aquí al lado en el catálogo:

• Códigos postales de Tamaulipas
• Códigos postales de Tlaxcala
• Códigos postales de Yucatán
• Códigos postales de Zacatecas

Para bajar un nivel más que esta tabla, mira colonias por municipio. Los parámetros completos de las dos llamadas de arriba están en la referencia de estados.