Documentation menu
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
| Name | In | Required | Description |
|---|---|---|---|
| lat | query | yes | Latitude (WGS84), required |
| lon | query | yes | Longitude (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 error400Missing or malformed
lat/lon401Missing 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