Skip to content
Documentation menu
docs / api / get-v1-places-id-entrances
geocoding

GET/v1/places/{id}/entrances

Access and price

AuthAn API key, as Authorization: Bearer snk_… or ?api_key=snk_…. Metered. Needs a full key; a browser (maps) key is refused.
Price1 call per request. Class: standard. Published as unit_rules.default in /pricing.json.

What it does

GET /v1/places/{id}/entrances.

Call it

bash
curl -fsS -X GET "https://api.mapmap.ai/v1/places/{id}/entrances" \
  -H "Authorization: Bearer $MAPMAP_KEY"

Parameters

NameInTypeRequiredDescription
idpathstringyesA place id exactly as a first-party place result reports it (properties.id), e.g. osm:w123:poi

Responses

200{id, name, lat, lon, entrances, entrances_index, note}. entrances is a list of {lon, lat, kind, wheelchair, access, door, level, ref, name, osm_id, source, confidence, basis}: kind is the OpenStreetMap entrance=* value (main, yes, entry, service, staircase, emergency, exit, home, garage, other); source is osm for a door mapped in OpenStreetMap or estimated for one MapMap inferred (none are served today); confidence (high, medium, low) grades how sure the tie between door and place is, with basis saying what tied them (own_outline, stop_area, address_match, sole_occupant). An empty list means no door is tied to this place, not that it has none. name, lat and lon are the place's own, null when this deployment has no place index
400An id longer than 128 bytes

application/problem+json · Problem

401Missing or invalid API key. Also: No key, or a missing, malformed, unknown, revoked or expired one (unauthorized); the body carries signup, docs and a one-call hint for a free key

application/problem+json · Problem

402Beyond the included volume with no way to pay this call: an x402 body naming how to pay (provisional key past its allowance, prepaid balance below the price, or a rejected X-PAYMENT). Not problem+json

application/json · X402PaymentRequired

403The key may not call this: a browser key outside its scope (scope-insufficient), a request from an origin the key does not allow (origin-not-allowed), or an account restriction (forbidden)

application/problem+json · Problem

404No such place in this deployment's place index

application/problem+json · Problem

429Quota or rate limit exceeded. Also: Per-key rate limit (rate-limited, with Retry-After), or monthly quota exhausted with no payment path (quota-exceeded)

application/problem+json · Problem

501This deployment has no place-entrance index (entrances-not-enabled)

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.

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