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

ParameterBehavior
lat, lonRequired search origin.
radiusKmOptional radius; maximum 20 km and default 8 km.
religionOptional religion filter, or all.
denominationOptional denomination filter.
limit1 to 200, default 50.
offsetNon-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.