Errors

All errors share a canonical shape:

{
  "error": {
    "code": "radius_too_large_for_free",
    "message": "Free tier caps radius_m at 1000.",
    "next_action": "upgrade_tier",
    "details": { "max_radius_m": 1000 }
  }
}

Status codes

400 — validation
401 — missing/invalid key or token
403 — quota exceeded or tier-gated
404 — entity not found
429 — rate-limited (retry after Retry-After)
5xx — our problem; we'll find it before you do