Skip to content
Documentation menu
docs / api / get-styles-spec-theme
Tiles, styles and map assets

GET/styles/{spec}/theme

Access and price

AuthNo key. Not metered.
PriceNot metered: no quota, no credit.

What it does

The latest theme document (the editable source a new version is published from; never cached).

No key. Not metered.

Call it

bash
curl -fsS -X GET "https://api.mapmap.ai/styles/{spec}/theme"

Parameters

NameInTypeRequiredDescription
specpathstringyesStyle id

Responses

200The latest theme document
FieldTypeRequiredDescription
basestringnoBuilt-in palette it starts from, e.g. light.
fontsobjectnoLabel fonts.
glyphsstringnoGlyph endpoint override, when set.
layersobjectnoPer-layer overrides by layer id.
namestringnoTheme name.
paletteobjectnoPalette overrides by slot name.
spritestringnoSprite sheet override, when set.
terrainobjectnoTerrain and hillshade settings, when set.

Example: Recorded from the hosted gateway on 2026-11-05, keyless: GET /styles/mapmap-light-76ef8d/theme

json
{
  "base": "light",
  "name": "MapMap Light"
}
404Hosted styles not configured or unknown style

application/problem+json · Problem

504The request did not finish within the gateway's request deadline (request-timeout)

application/problem+json · Problem

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

Also under Tiles, styles and map assets

Generated from https://api.mapmap.ai/openapi.json on 2026-11-12 · operationId get_theme