---
title: "`GET /boundary?lat=<f64>&lon=<f64>`."
method: GET
path: "/boundary"
tags: ["boundaries"]
---

# \`GET /boundary?lat=<f64>&lon=<f64>\`.

`GET /boundary`

## Request

- Base URL: `https://api.mapmap.ai`
- URL: `https://api.mapmap.ai/boundary`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `api_key`

## Query parameters

- `lat` number, double, required
- `lon` number, double, required

## Response `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

- object

## Other responses

- `400`: Missing or malformed `lat`/`lon`
- `401`: Missing or invalid API key
- `429`: Quota or rate limit exceeded
- `500`: The admin-boundaries database could not be read
- `501`: Admin boundary lookup not enabled (SN_ADMIN_BOUNDARIES_DB unset)

---

[API](https://skmtc.dev/mapmap/apis/sn-gateway.md) · [All operations](https://skmtc.dev/mapmap/apis/sn-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/mapmap/apis/sn-gateway/revisions/2293be8b4c38?raw)