Mongolia360
API docs
Build with Mongolia360 — datasets, search and AI over a documented, versioned API.
The Mongolia360 public API is a versioned, read-only REST interface. All endpoints are served under /api/v1 and return JSON unless a different format is requested. Most endpoints are open; higher rate limits require an API key passed via Authorization: Bearer <key>.
Endpoints
Geography
| Method | Path | Description |
|---|---|---|
| GET | /api/v1/provinces | List provinces (aimags). |
| GET | /api/v1/soums | List soums. |
| GET | /api/v1/districts | List districts. |
Content
| Method | Path | Description |
|---|---|---|
| GET | /api/v1/travel | List travel destinations. |
| GET | /api/v1/businesses | List business profiles. |
| GET | /api/v1/events | List events. |
Search
| Method | Path | Description |
|---|---|---|
| GET | /api/v1/search | Basic keyword search across content. |
| GET | /api/v1/search/federated | Grouped federated search across all entity types. |
Digital Twin
| Method | Path | Description |
|---|---|---|
| GET | /api/v1/digital-twin | National digital twin overview. |
| GET | /api/v1/digital-twin/provinces | Per-province twin metrics. |
| GET | /api/v1/digital-twin/soums | Per-soum twin metrics. |
| GET | /api/v1/digital-twin/coverage | Data coverage breakdown. |
| GET | /api/v1/digital-twin/health | Twin health scores. |
Open Data & Status
| Method | Path | Description |
|---|---|---|
| GET | /api/v1/data/<dataset>?format=json|csv|geojson | Download a full dataset (provinces, soums, destinations, businesses, events). |
| GET | /api/v1/status | API health and version status. |
Response envelope
Every successful response is wrapped in a consistent envelope with success, data, and meta fields.
{
"success": true,
"data": [ /* ... results ... */ ],
"meta": {
"page": 1,
"perPage": 20,
"total": 132,
"totalPages": 7,
"locale": "mn"
}
}Errors return a structured error object:
{
"success": false,
"error": {
"code": "NOT_FOUND",
"message": "Resource not found"
}
}Pagination
List endpoints are paginated. Control results with the page and perPage query parameters. The meta block returns total (total matching records) and totalPages so you can iterate through all pages.
GET /api/v1/provinces?page=2&perPage=50
Localization
All localized fields respond in the requested language. Pass the ?locale query parameter with any supported locale code (for example mn, en). When omitted, the default locale is used. The resolved locale is echoed back in meta.locale.
GET /api/v1/travel?locale=en
Usage limits
Requests are rate limited to 60/min per client by default. Authenticated requests with an API key may receive a higher allowance. When the limit is exceeded the API responds with HTTP 429 and an error code of RATE_LIMITED.