API reference
Account
API key usage and health
GET
/api/municipalitiesAPI keyList Norwegian municipalities
Returns all Norwegian municipalities grouped by county. Optionally filter to a single county with ?county=XX (2-digit county code).
Query parameters
2-digit Norwegian county code (e.g. '03' for Oslo).
/^\d{2}$/
Responses
200Successful response.
401Missing or invalid API key.
402Trial expired. Upgrade required.
429Rate limit or quota exceeded.
GET
/api/healthAPI health check
Returns { status: 'ok' } when the API is reachable. Pass the X-Sync-Secret header to include DB diagnostics and sync status.
Responses
200Successful response.
GET
/api/keys/usageAPI keyGet API key usage
Returns the caller's own tier, limits (rate/daily/monthly), and current usage counters with reset timestamps.
Responses
200Successful response.
401Missing or invalid API key.
402Trial expired. Upgrade required.
429Rate limit or quota exceeded.