Documentation Index
Fetch the complete documentation index at: https://docs.foodsave.kz/llms.txt
Use this file to discover all available pages before exploring further.
Geo API
Base path: /api/v1/geo
Overview
Geospatial search and address geocoding powered by cached queries.
Geocode results are cached in Redis. Repeated lookups with identical addresses are usually served from cache.
GET /api/v1/geo/partners/nearby
Find partners near a geographic point.
curl --request GET \
--url "https://api.foodsave.kz/api/v1/geo/partners/nearby?lat=43.24&lng=76.92&radius=5000"
const response = await fetch('https://api.foodsave.kz/api/v1/geo/partners/nearby?lat=43.24&lng=76.92&radius=5000')
console.log(await response.json())
import requests
response = requests.get('https://api.foodsave.kz/api/v1/geo/partners/nearby?lat=43.24&lng=76.92&radius=5000')
print(response.json())
{ "partners": [{ "partnerId": "p-1", "latitude": 43.24, "longitude": 76.92, "distanceMeters": 420 }] }
partners[].distanceMeters
GET /api/v1/geo/geocode
Geocode an address.
{ "latitude": 43.238949, "longitude": 76.889709, "found": true }
POST /api/v1/geo/internal/locations
Upsert a partner location.
Internal location writes are reserved for platform operators and trusted sync jobs.