Argentina CPA (Código Postal Argentino)
API de Localidades y Códigos Postales de Argentina (CPA) API REST para buscar localidades argentinas y trabajar con el código postal argentino (CPA). Permite buscar ciudades, pueblos y localidades de toda Argentina por nombre, validar códigos postales, consultar provincias y normalizar direcciones, con respuestas en formato JSON rápidas y fáciles de integrar en cualquier aplicación web o móvil.…
Argentina CPA (Código Postal Argentino) endpoints
| Method | Endpoint | Description |
|---|---|---|
| Localidades | ||
| GET |
getLocalidadesByZip /localidades/by_zip |
Resuelve una zona postal — código legado de 4 dígitos ("2000"), letra + zona ("S2000") o CPA completo ("S2000AAA") — al conjunto de localidades que la comparten. Hermano… |
| GET |
getLocalidadByCpa /localidades/by_cpa |
Resuelve un CPA a la(s) localidad(es) correspondiente(s), incluyendo la jerarquía de provincia. Acepta las formas que un usuario realmente tiene a mano: el CPA completo… |
| POST |
validateCpaBatch /batch/validate_cpa |
Valida y normaliza hasta 1000 CPAs en una sola llamada (para logística / limpieza de bases). Los resultados vuelven en el mismo orden que la entrada. Acepta el CPA completo (8… |
| GET |
validateCpa /localidades/validate_cpa |
Verifica el formato de un CPA, lo normaliza y resuelve su provincia. Distingue un formato inválido (400) de un CPA válido inexistente (`exists: false`). |
| GET |
searchLocalidades /localidades/search |
Busca localidades por nombre con filtrado opcional por provincia, paginación y coincidencia difusa. La búsqueda es insensible a acentos ("cordoba" encuentra "Córdoba"). Si no se… |
| GET |
autocompleteLocalidades /localidades/autocomplete |
Sugerencias rápidas por prefijo, ordenadas exacto > prefijo (nombre más corto primero, p. ej. "Mendoza" antes que "Mendoza Sur"). Insensible a acentos. Ideal para formularios de… |
| GET |
nearbyLocalidades /localidades/nearby |
Localidades dentro de un radio de un punto (lat/lon) o de un CPA, de la más cercana a la más lejana. Sólo se consideran localidades con coordenadas conocidas (cobertura parcial).… |
| Provincias | ||
| GET |
getProvinciaById /provincias/{id} |
|
| GET |
listMunicipios /municipios |
Municipios (id INDEC de 6 dígitos, con centroide) desde GeoRef. Filtrá por provincia_id (1-24), nombre o id. Nota: los ids son INDEC. |
| GET |
listDepartamentos /departamentos |
Departamentos (id INDEC de 5 dígitos, con centroide) desde GeoRef. Filtrá por provincia_id (1-24), nombre o id. Nota: los ids son INDEC. |
| GET |
getProvinciaByLetra /provincias/by_letra/{letra} |
|
| GET |
listProvincias /provincias |
|
| GET |
searchProvincias /provincias/search |
|
| Normalización | ||
| GET |
normalizeAddress /api/normalize |
Convierte una dirección de texto libre en componentes estructurados (calle, altura, localidad) y la resuelve contra el dataset interno de localidades/CPA. |
| GET |
reverseGeocode /api/reverse_geocode |
Convierte lat/lon en la jerarquía administrativa (provincia / departamento / municipio, vía GeoRef /ubicacion) y un CPA aproximado del área, resuelto desde el dataset interno. |
| GET |
geocode /api/geocode |
Geocodificación directa con el motor oficial GeoRef (/direcciones): normaliza calle + altura y devuelve coordenadas y la jerarquía administrativa, con el CPA agregado desde el… |
| GET |
getCpaEspecifico /api/cpa |
Devuelve el CPA específico de 8 caracteres de una dirección puntual — con el sufijo real de 3 letras que identifica la cara de manzana según calle, altura y paridad (par/impar)—… |
| Sistema | ||
| GET |
getHealth /health |
Estado de la base de datos y el caché. Endpoint público. |
| Other endpoints | ||
| GET |
getHealth /health |
Estado de la base de datos y el caché. Endpoint público. |
| GET |
getLocalidadByCpa /localidades/by_cpa |
Recupera una localidad por su CPA, incluyendo la jerarquía de provincia. |
| GET |
searchLocalidades /localidades/search |
Busca localidades por nombre con filtrado opcional por provincia, paginación y coincidencia difusa. La búsqueda es insensible a acentos ("cordoba" encuentra "Córdoba"). Si no se… |
| GET |
normalizeAddress /api/normalize |
Convierte una dirección de texto libre en componentes estructurados (calle, altura, localidad) y la resuelve contra el dataset interno de localidades/CPA. |
| GET |
validateCpa /localidades/validate_cpa |
Verifica el formato de un CPA, lo normaliza y resuelve su provincia. Distingue un formato inválido (400) de un CPA válido inexistente (`exists: false`). |
| GET |
getProvinciaByLetra /provincias/by_letra/{letra} |
|
| GET |
listProvincias /provincias |
|
| GET |
searchProvincias /provincias/search |
|
| GET |
getProvinciaById /provincias/{id} |
|
| GET |
listMunicipios /municipios |
Municipios (id INDEC de 6 dígitos, con centroide) desde GeoRef. Filtrá por provincia_id (1-24), nombre o id. Nota: los ids son INDEC. |
| GET |
getHealth /health |
Estado de la base de datos y el caché. Endpoint público. |
| GET |
geocode /api/geocode |
Geocodificación directa con el motor oficial GeoRef (/direcciones): normaliza calle + altura y devuelve coordenadas y la jerarquía administrativa, con el CPA agregado desde el… |
| GET |
getLocalidadByCpa /localidades/by_cpa |
Resuelve un CPA a la(s) localidad(es) correspondiente(s), incluyendo la jerarquía de provincia. Acepta las formas que un usuario realmente tiene a mano: el CPA completo… |
| GET |
autocompleteLocalidades /localidades/autocomplete |
Sugerencias rápidas por prefijo, ordenadas exacto > prefijo (nombre más corto primero, p. ej. "Mendoza" antes que "Mendoza Sur"). Insensible a acentos. Ideal para formularios de… |
| GET |
reverseGeocode /api/reverse_geocode |
Convierte lat/lon en la jerarquía administrativa (provincia / departamento / municipio, vía GeoRef /ubicacion) y un CPA aproximado del área, resuelto desde el dataset interno. |
| GET |
listProvincias /provincias |
|
| GET |
getProvinciaById /provincias/{id} |
|
| GET |
getProvinciaByLetra /provincias/by_letra/{letra} |
|
| GET |
listDepartamentos /departamentos |
Departamentos (id INDEC de 5 dígitos, con centroide) desde GeoRef. Filtrá por provincia_id (1-24), nombre o id. Nota: los ids son INDEC. |
| GET |
validateCpa /localidades/validate_cpa |
Verifica el formato de un CPA, lo normaliza y resuelve su provincia. Distingue un formato inválido (400) de un CPA válido inexistente (`exists: false`). |
| POST |
validateCpaBatch /batch/validate_cpa |
Valida y normaliza hasta 1000 CPAs en una sola llamada (para logística / limpieza de bases). Los resultados vuelven en el mismo orden que la entrada. Acepta el CPA completo (8… |
| GET |
searchLocalidades /localidades/search |
Busca localidades por nombre con filtrado opcional por provincia, paginación y coincidencia difusa. La búsqueda es insensible a acentos ("cordoba" encuentra "Córdoba"). Si no se… |
| GET |
normalizeAddress /api/normalize |
Convierte una dirección de texto libre en componentes estructurados (calle, altura, localidad) y la resuelve contra el dataset interno de localidades/CPA. |
| GET |
searchProvincias /provincias/search |
|
| GET |
getLocalidadesByZip /localidades/by_zip |
Resuelve una zona postal — código legado de 4 dígitos ("2000"), letra + zona ("S2000") o CPA completo ("S2000AAA") — al conjunto de localidades que la comparten. Hermano… |
| GET |
reverseGeocode /api/reverse_geocode |
Convierte lat/lon en la jerarquía administrativa (provincia / departamento / municipio, vía GeoRef /ubicacion) y un CPA aproximado del área, resuelto desde el dataset interno. |
| GET |
geocode /api/geocode |
Geocodificación directa con el motor oficial GeoRef (/direcciones): normaliza calle + altura y devuelve coordenadas y la jerarquía administrativa, con el CPA agregado desde el… |
| GET |
getLocalidadByCpa /localidades/by_cpa |
Resuelve un CPA a la(s) localidad(es) correspondiente(s), incluyendo la jerarquía de provincia. Acepta las formas que un usuario realmente tiene a mano: el CPA completo… |
| GET |
searchLocalidades /localidades/search |
Busca localidades por nombre con filtrado opcional por provincia, paginación y coincidencia difusa. La búsqueda es insensible a acentos ("cordoba" encuentra "Córdoba"). Si no se… |
| GET |
nearbyLocalidades /localidades/nearby |
Localidades dentro de un radio de un punto (lat/lon) o de un CPA, de la más cercana a la más lejana. Sólo se consideran localidades con coordenadas conocidas (cobertura parcial).… |
| GET |
getLocalidadesByZip /localidades/by_zip |
Resuelve una zona postal — código legado de 4 dígitos ("2000"), letra + zona ("S2000") o CPA completo ("S2000AAA") — al conjunto de localidades que la comparten. Hermano… |
| POST |
validateCpaBatch /batch/validate_cpa |
Valida y normaliza hasta 1000 CPAs en una sola llamada (para logística / limpieza de bases). Los resultados vuelven en el mismo orden que la entrada. Acepta el CPA completo (8… |
Argentina CPA (Código Postal Argentino) pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO Recommended | $3 / month | — |
|
| ULTRA | $4.2 / month | — |
|
| MEGA | Free | 500 / second |
|