Utvikler

Test API-et. Rett i nettleseren.

ketl data API + MCP — auth, rate limits, eksempler og full OpenAPI 3.1-spec.

Kom i gang på 5 minutter

Opprett konto, generér API-nøkkel og gjør første kall mot Brreg.

Opprett konto →

Datakatalog

160+ norske offentlige datakilder med endepunkter, paginering og felt-mapping.

Bla i kilder →

Analyseapper

Ferdige dashboards som demonstrerer hvert API. Bruk som referanseimplementasjon.

Se apper →

MCP-distribusjon

174 Model Context Protocol-servere klare for Claude Desktop, Cursor og Windsurf.

MCP-hub →

Auth og rate limits

Public

60 req/min/IP

Connectors med åpne offentlige kilder (brreg, kartverket adresser, sodir, ssb, stortinget, lovtidend, hoyesterett) — ingen API-nøkkel.

Dev (gratis)

300 req/min/IP, 1 000 kall/mnd

API-nøkkel mot connectors med rate-limit eller kommersielt upstream-API.

Pro / Team / Enterprise

Tier-basert (se prising)

Full MCP-tilgang, usage-based metering via Stripe Billing.

Send API-nøkkel som x-api-key-header eller Firebase ID-token som Authorization: Bearer ….

Eksempler

curl

# Slå opp Equinor ASA via Brreg-connector
curl https://data.ketl.no/api/connectors/brreg/enhet/923609016

JavaScript (fetch)

const res = await fetch(
  "https://data.ketl.no/api/connectors/brreg/enhet/923609016"
);
const data = await res.json();
console.log(data.legalName); // "EQUINOR ASA"

Python (httpx)

import httpx

r = httpx.get(
    "https://data.ketl.no/api/connectors/brreg/enhet/923609016"
)
print(r.json()["legalName"])  # "EQUINOR ASA"

Feilhåndtering

Alle endepunkter returnerer strukturert JSON ved feil: { error: string, code: string }. Bruk code for programmatisk håndtering — error er for mennesker og kan endre form.

Status	Betydning	Hva du bør gjøre
200	OK	Vellykket. Response-body inneholder data + `x-ketl-cache: hit\|miss\|stale`-header.
400	Bad Request	Validation-feil — body har `{error, code: "validation_error"}`. Sjekk required query-params.
401	Unauthorized	API-nøkkel mangler eller er ugyldig. Send `x-api-key` eller `Authorization: Bearer …`.
403	Forbidden	Tier-en din har ikke tilgang til denne kilden. Se /pricing.
429	Too Many Requests	Rate limit nådd. `Retry-After`-headeren angir antall sekunder før neste forsøk er tillatt.
502	Bad Gateway	Upstream-kilden svarte med feil. Body har `{error, code: "upstream_error", upstreamStatus?}`. Stale cache kan ha blitt servert ved tilgjengelig data.
503	Service Unavailable	Connector mangler nødvendig credential (`{error: "not_configured"}`). Operasjonell-feil, ikke en bug — opprett en sak om kilden er markedsført men ikke fungerer.

Retry-strategi

Eksponentiell backoff på 429/502/503: 1s, 2s, 4s, 8s — gi opp etter fire forsøk. 4xx (utenom 429) er klient-feil og skal ikke retries. Se Retry-After-headeren for eksakt ventetid ved 429.

Rate limiting-headers

X-RateLimit-Limit	Maksimalt antall kall per minutt for din tier.
X-RateLimit-Remaining	Gjenværende kall i denne vinduet.
X-RateLimit-Reset	Unix-epoch (sekunder) når vinduet nullstilles.
Retry-After	Settes kun ved 429 — antall sekunder å vente før retry.

Paginering

Søke-endepunkter bruker offset-paginering (size + fra som 0-indeksert sidenummer). Liste-endepunkter for tidsserier bruker dato-vinduer (from/ to) istedenfor offset.

# Brreg-enhetssøk paginert (page 0-indexed, size 1-50)
curl "https://data.ketl.no/api/connectors/brreg/enheter?navn=Equinor&size=20&fra=0"

# Respons:
#   {
#     "enheter": [...],
#     "totalElements": 47,
#     "totalPages": 3,
#     "pageNumber": 0,
#     "pageSize": 20
#   }
#
# Hent neste side med fra=1, deretter fra=2.

Maks size per kilde er dokumentert i kildekatalogen — typisk 50 for søk og 1 000 for tidsserier. Større size klemmes ned i stedet for å gi feil.

OpenAPI 3.1-spec

Den komplette kontrakten er publisert som OpenAPI 3.1 og kan hentes maskinlesbart for codegen (orval, openapi-typescript) eller importeres i Postman/Insomnia/Stoplight.

curl https://data.ketl.no/api/v1/_meta/openapi.json

Last ned OpenAPI →Kildekatalog →Helsesjekk →