Endpoint guide
GET /v1/places/nearby
Use this endpoint when you need a list of nearby places of worship ordered by distance, with limit and offset pagination.
Parameters
| Parameter | Behavior |
|---|---|
lat, lon | Required search origin. |
radiusKm | Optional radius; maximum 20 km and default 8 km. |
religion | Optional religion filter, or all. |
denomination | Optional denomination filter. |
limit | 1 to 200, default 50. |
offset | Non-negative offset, default 0. |
cURL example
curl -H "X-API-Key: $KAIROS_API_KEY" \
"https://kairos.yarumaltech.com/v1/places/nearby?lat=6.96333&lon=-75.41722&radiusKm=8&religion=all&limit=20&offset=0"
Best uses
Map result lists
Populate a nearby-results panel next to a map or city-guide interface.
Directory pages
Fetch a bounded result set and combine it with your own content, ratings or contact information.