Skip to content

50,000 free calls a month, card-free. Get an API key →

Documentation menu
docs / api / get-boundary
boundaries

GET/boundary

API key required, sent as Authorization: Bearer snk_… or ?api_key=snk_….

Call it

bash
curl -fsS -X GET "https://api.mapmap.ai/boundary?lat=…&lon=…" \
  -H "Authorization: Bearer $MAPMAP_KEY"

Parameters

NameInRequiredDescription
latqueryyesLatitude (WGS84), required
lonqueryyesLongitude (WGS84), required

Responses

200{point: {lat, lon}, admins: [{admin_level, iso_code, name, name_en, drive_on_right}, …]}, sorted ascending by admin_level (country before sub-division). An empty admins array is a valid answer (open sea, or a genuine gap in this deployment's admin-boundary coverage: see docs/API.md), never an error
400Missing or malformed lat/lon
401Missing or invalid API key
429Quota or rate limit exceeded
500The admin-boundaries database could not be read
501Admin boundary lookup not enabled (SN_ADMIN_BOUNDARIES_DB unset)

Error bodies follow the shared problem model documented on API conventions.

Generated from https://api.mapmap.ai/openapi.json on 2026-09-17 · operationId get_boundary