Última actualización: 2026-09-21 · Base URL: https://api.shalom-api.lat
El catálogo de agencias se actualiza a diario desde el sistema de Shalom e incluye dirección exacta, referencia, teléfono, horarios y coordenadas (latitud/longitud) de cada sede. Con la búsqueda avanzada puedes filtrar por departamento o provincia y ordenar por cercanía usando las coordenadas del cliente — útil para mostrar 'la agencia más cercana' en tu checkout.
/agenciesListado completo de agencias autorizadas omitiendo rutas aéreas de origen/destino. Filtro opcional por texto.
| Parámetro | Descripción |
|---|---|
| q | Texto de búsqueda para filtrar por departamento, provincia o zona. |
curl -X GET "https://api.shalom-api.lat/agencies?q=lima" \
-H "x-api-key: TU_API_KEY"{
"success": true,
"message": "Lista de agencias minimal.",
"total": 552,
"query": null,
"data": [
{
"ter_id": 392,
"ter_abrebiatura": "MLGVLL",
"zona": "CERCADO LIMA",
"ter_zona": "LIMA OESTE 2",
"provincia": "LIMA",
"departamento": "LIMA",
"latitud": "-12.04638719585",
"longitud": "-77.049473000003",
"direccion": "JR. PRESBÍTERO GARCÍA VILLÓN NRO. 560 CERCADO LIMA - LIMA, REF. ...",
"telefono": "(01) 500 7878",
"hora_atencion": "LUNES A VIERNES - 8:00 AM A 8:00 PM",
"hora_domingo": "",
"estadoAgencia": "ATENDIENDO EN ESTE MOMENTO",
"nombre": "LIMA / LIMA / CERCADO LIMA / MALVINAS - JR. GARCIA VILLÓN",
"lugar_over": "MALVINAS - JR. GARCIA VILLÓN",
"ter_aereo": 1,
"dep_id": 15,
"prov_id": 1,
"dist_id": 1,
"ubi_id": 150101,
"...": "48 campos en total por agencia"
}
]
}/agencies/searchBusca por texto libre, departamento, provincia, disponibilidad aérea, u ordena por cercanía a coordenadas (near) en un radio específico.
| Parámetro | Descripción |
|---|---|
| q | Texto de búsqueda libre. |
| departamento | Filtrar por departamento. |
| provincia | Filtrar por provincia. |
| aereo | enum: true | false — filtrar por habilitación aérea. |
| near | Coordenadas lat,lng (patrón numérico con signo) para ordenar por cercanía. |
| radius_km | Radio de cobertura máximo en kilómetros. |
| per_page | Límite de resultados a retornar (1–500, default 100). |
curl -X GET "https://api.shalom-api.lat/agencies/search?q=lima&departamento=LIMA&provincia=LIMA&aereo=true&near=-12.046,-77.043&radius_km=5&per_page=5" \
-H "x-api-key: TU_API_KEY"{
"success": true,
"total": 26,
"returned": 2,
"data": [
{
"ter_id": 392,
"lugar_over": "MALVINAS - JR. GARCIA VILLON",
"departamento": "LIMA",
"provincia": "LIMA",
"direccion": "JR. GARCIA VILLON 250, ...",
"latitud": "-12.063...",
"longitud": "-77.012...",
"distancia_km": 0.71
}
]
}Nota: distancia_km solo aparece cuando se usa near. total = resultados antes del límite, returned = devueltos.
/public/agenciesListado público de agencias para la landing de demostración. No requiere API key ni consume cuota.
| Parámetro | Descripción |
|---|---|
| q | Texto de búsqueda para filtrar por departamento, provincia o zona. |
curl -X GET "https://api.shalom-api.lat/public/agencies?q=lima" \
-H "x-api-key: TU_API_KEY"{
"success": true,
"message": "Lista de agencias minimal.",
"total": 552,
"query": "",
"data": [ { "ter_id": 3, "..." : "misma estructura que GET /agencies" } ]
}/public/agencies/searchBúsqueda avanzada pública con los mismos filtros que GET /agencies/search. No requiere API key.
| Parámetro | Descripción |
|---|---|
| q | Texto de búsqueda libre. |
| departamento | Filtrar por departamento. |
| provincia | Filtrar por provincia. |
| aereo | enum: true | false. |
| near | Coordenadas lat,lng para ordenar por cercanía. |
| radius_km | Radio máximo en kilómetros. |
| per_page | Límite de resultados (1–500, default 100). |
curl -X GET "https://api.shalom-api.lat/public/agencies/search?q=lima&departamento=LIMA&provincia=LIMA&aereo=true&near=-12.046,-77.043&radius_km=5&per_page=5" \
-H "x-api-key: TU_API_KEY"{
"success": true,
"total": 26,
"returned": 2,
"data": [ { "..." : "misma estructura que GET /agencies/search" } ]
}Son 540 agencias con nombre, dirección, referencia, horario, teléfono, departamento, provincia, zona, coordenadas y si atienden servicio aéreo. Todo lo que necesitas para pintar un mapa, armar un selector de destino o validar una dirección.
En el listado, el parámetro `q` filtra por departamento, provincia o zona. La búsqueda avanzada añade filtros por departamento, provincia y habilitación aérea, además de la cercanía.
Con `near=lat,lng` el resultado viene ordenado por distancia a ese punto, y `radius_km` recorta el radio. Es el endpoint que necesitas cuando el cliente elige «la agencia más cercana a mi casa».
GET /public/agencies y /public/agencies/search responden sin API key. Sirven para que veas el formato real de las respuestas antes de integrar, y son los que alimentan la demo y el mapa de la portada.
Para crear un envío necesitas el identificador de la agencia de destino. Resuélvelo al cotizar y guárdalo junto al pedido: así no tienes que volver a buscarlo cuando llegue el momento de registrar la guía.
| 400 | near no tiene el formato lat,lng o per_page está fuera del rango 1–500. |
| 429 | Rate limit superado: espera y reintenta con backoff. |
540 agencias repartidas en 25 departamentos, con latitud y longitud incluidas.
Para GET /agencies y GET /agencies/search sí. Las versiones GET /public/agencies y /public/agencies/search responden sin API key.
Con GET /agencies/search?near=lat,lng, opcionalmente con radius_km para limitar el radio.
Sí, cada agencia trae latitud y longitud listas para dibujar en un mapa.
Con el campo ter_aereo de cada registro, o filtrando con el parámetro aereo=true en la búsqueda avanzada.
Escríbenos por WhatsApp y la recibes de inmediato para probar todos estos ejemplos.
Solicitar API key