Firmadatabasen API-dokumentasjon

Base-URL og autentisering

Produksjon serveres fra https://api.firmadatabasen.no. Alle /v1-kall krever en X-API-Key-header (alternativt Authorization: Bearer fdb_…). Kall API-et fra server-side — nøkkelen må aldri eksponeres i nettleseren.

X-API-Key: fdb_din_nokkel_her

GET/v1/company/{orgNumber}

Slå opp ett selskap. Returnerer grunndata, adresse, kontaktinfo, inntil fem regnskapsår og fem nøkkeltall. Slettede selskaper får adresse og kontakt nullet (GDPR).

curl -H "X-API-Key: $API_KEY" \
  https://api.firmadatabasen.no/v1/company/924831723

const res = await fetch(
  'https://api.firmadatabasen.no/v1/company/924831723',
  { headers: { 'X-API-Key': process.env.FDB_API_KEY } },
)
const { data } = await res.json()

{
  "data": {
    "orgNumber": "924831723",
    "name": "MANAGR. AS",
    "organizationForm": "AS",
    "industry": { "code": "62.100", "description": "Dataprogrammeringstjenester" },
    "address": { "street": "Neseveien 54B", "postalCode": "4514", "city": "MANDAL", "municipality": "LINDESNES" },
    "employees": null,
    "status": { "konkurs": false, "underAvvikling": false, "mvaRegistered": true },
    "accounting": [
      { "fiscalYear": 2024, "type": "SELSKAP", "revenue": 49849, "operatingProfit": 10631, "netProfit": 7875 }
    ],
    "metrics": [
      { "label": "Driftsmargin", "value": 21.33, "unit": "%", "color": "green", "rating": "God" }
    ]
  }
}

GET/v1/search

Søk etter selskaper. Minst én av q, municipality, industryCode, organizationForm, employeesMin eller employeesMax kreves. Cursor-paginering via nextCursor.

curl -H "X-API-Key: $API_KEY" \
  'https://api.firmadatabasen.no/v1/search?q=managr&limit=5'

{
  "data": [
    {
      "id": "401e1c25-123b-45cd-b988-fa50eb374786",
      "orgNumber": "924831723",
      "name": "MANAGR. AS",
      "organizationForm": "AS",
      "industryCode": "62.100",
      "municipality": "LINDESNES",
      "konkurs": false
    }
  ],
  "nextCursor": null
}

Prøv det

Kjør et ekte kall mot produksjons-API-et — uten egen nøkkel.

// Trykk «Kjør» for å sende en ekte forespørsel mot api.firmadatabasen.no

Feilkoder

Rate limits og kvoter

Rate limit og månedskvote håndheves per nøkkel og avhenger av planen (Sandbox: 1 req/s og 100 kall/mnd; opp til Scale: 100 req/s og 100 000 kall/mnd). Følg med på response-headerne:

• X-RateLimit-Limit / -Remaining / -Reset
• X-Usage-Current / -Included / -Remaining
• Retry-After ved 429

OpenAPI-spec

Hele kontrakten er tilgjengelig som maskinlesbar OpenAPI 3.1: https://api.firmadatabasen.no/openapi.yaml. Importer den i Postman, Insomnia, Scalar eller en kodegenerator.