Reference

API documentation

Base URL: https://geo.baube.net/v1. Authentication via bearer token. Responses are compatible with the Nominatim schema.

Authentication

Authorization: Bearer gk_live_your_key
# alternatively:  x-api-key: gk_live_your_key
# or query:       ?key=gk_live_your_key

Endpoints

GET /v1/search — forward geocoding

curl "https://geo.baube.net/v1/search?q=Königstraße+1+Stuttgart&format=jsonv2&addressdetails=1" \
  -H "Authorization: Bearer gk_live_your_key"

GET /v1/reverse — reverse geocoding

curl "https://geo.baube.net/v1/reverse?lat=48.7758&lon=9.1829&format=jsonv2" \
  -H "Authorization: Bearer gk_live_your_key"

GET /v1/lookup — OSM object lookup

curl "https://geo.baube.net/v1/lookup?osm_ids=R146656,W104393803&format=jsonv2" \
  -H "Authorization: Bearer gk_live_your_key"

Key parameters

• q — free-text search (search)
• lat, lon — coordinates (reverse)
• format — jsonv2 | json | geojson | xml
• addressdetails — 1 = structured address
• limit — max results (search)
• countrycodes — e.g. de,at,ch
• accept-language — e.g. en

Rate-limit headers

X-RateLimit-Limit-Second:    15
X-RateLimit-Limit-Day:       250000
X-RateLimit-Remaining-Day:   249877

Error codes

401 invalid_api_key          # key missing/invalid
403 subscription_inactive    # payment due / suspended
429 rate_limit_exceeded      # req/s exceeded
429 daily_quota_exceeded     # daily quota used up
502 upstream_error           # backend unreachable

Attribution (required)

When you display results, you must credit OpenStreetMap. Example in your UI: "Geocoding © OpenStreetMap contributors". The full licence text is included in every response in the licence field and the X-Data-Attribution header.