API-dokumentasjon
Konkurs.app tilbyr et gratis, åpent JSON API for oppslag i norske konkursbo. Dataene synkroniseres fra Brønnøysundregistrenes Enhetsregister to ganger daglig.
Basis-URL: https://konkurs.app/api
API-et er begrenset til 60 forespørsler per minutt per IP-adresse. Ved overskridelse returneres HTTP 429 med en Retry-After-header.
API-et er ment for enkeltoppslag og begrenset integrasjon. Systematisk viderebruk, massenedlasting eller oppbygging av egne persondatabaser er ikke tillatt. API-data inneholder personopplysninger; tredjeparter som viderebruker data er selv behandlingsansvarlige etter GDPR. Se personvernpolicyen for detaljer.
Endepunkter
GET /api/stats
Returnerer nøkkeltall og statistikk over konkursbo.
Tar ingen parametere. Responsen mellomlagres i opptil 1 time.
curl https://konkurs.app/api/stats
Respons:
{ "total": 3254, "thisMonth": 87, "thisYear": 412, "byMunicipality": [{ "kommune": "OSLO", "count": 520 }, ...], "byIndustry": [{ "naeringskode": "68.209", "naeringsbeskrivelse": "Utleie av egen ...", "count": 98 }, ...], "byMonth": [{ "month": "2024-03", "count": 95 }, ...], "lastSynced": "2026-02-22T03:12:45.000Z" }
GET /api/filters
Returnerer tilgjengelige filterverdier for kommuner og næringskoder.
Tar ingen parametere. Responsen mellomlagres i opptil 1 time.
curl https://konkurs.app/api/filters
Respons:
{ "kommuner": [{ "kommune": "ALTA" }, { "kommune": "ARENDAL" }, ...], "naeringskoder": [{ "naeringskode": "01.110", "naeringsbeskrivelse": "Dyrking av korn ..." }, ...] }
GET /api/konkursbo
Paginert liste over konkursbo med filtrering og sortering.
| Parameter | Type | Standard | Beskrivelse |
|---|---|---|---|
page |
heltall | 1 | Sidenummer (starter fra 1) |
size |
heltall | 50 | Antall per side (maks 100) |
sort |
tekst | stiftelsesdato | Sorter etter: stiftelsesdato, registreringsdato, navn, kommune, orgnr |
order |
tekst | desc | asc eller desc |
kommune |
tekst | Filtrer etter kommune (eksakt treff) | |
naeringskode |
tekst | Filtrer etter næringskode (eksakt treff) | |
search |
tekst | Fritekstsøk i navn, org.nr, konkursdebitor og bostyrer | |
fra_dato |
dato | Stiftelsesdato fra og med (YYYY-MM-DD) | |
til_dato |
dato | Stiftelsesdato til og med (YYYY-MM-DD) | |
status |
tekst | aktive | aktive, avsluttede eller alle |
curl "https://konkurs.app/api/konkursbo?kommune=OSLO&page=1&size=10"
Respons:
{ "data": [{ "orgnr": "934567890", "navn": "EKSEMPEL AS ...", ... }], "pagination": { "page": 1, "size": 10, "total": 520, "totalPages": 52 } }
GET /api/konkursbo/:orgnr
Henter alle felter for ett konkursbo.
| Parameter | Type | Beskrivelse |
|---|---|---|
:orgnr |
tekst | Ni-sifret organisasjonsnummer |
curl https://konkurs.app/api/konkursbo/934567890
Returnerer 400 ved ugyldig org.nr og 404 om boet ikke finnes.
GET /api/health
Helsesjekk som bekrefter at databasen er tilgjengelig.
curl https://konkurs.app/api/health
Respons:
{ "status": "ok", "lastSynced": "2026-02-22T03:12:45.000Z", "totalRecords": 3254 }
Datamodell
Hvert konkursbo har følgende felter:
| Felt | Type | Beskrivelse |
|---|---|---|
orgnr |
tekst | Ni-sifret organisasjonsnummer (primærnøkkel) |
navn |
tekst | Navn på konkursboet |
stiftelsesdato |
dato | Dato boet ble stiftet (YYYY-MM-DD) |
registreringsdato |
dato | Dato boet ble registrert i Enhetsregisteret |
naeringskode |
tekst | NACE-kode for næringsgruppe |
naeringsbeskrivelse |
tekst | Beskrivelse av næring |
kommune |
tekst | Kommunenavn |
kommunenummer |
tekst | Fire-sifret kommunenummer |
poststed |
tekst | Poststed |
postnummer |
tekst | Fire-sifret postnummer |
adresse |
tekst | Forretningsadresse |
under_avvikling |
heltall | 1 hvis under avvikling, ellers 0 |
mva_registrert |
heltall | 1 hvis registrert i MVA-registeret |
aktiv |
heltall | 1 hvis aktivt bo, 0 hvis avsluttet/slettet |
slettet_dato |
dato | Dato boet ble slettet (kun for avsluttede) |
debitor_navn |
tekst | Navn på konkursdebitor (virksomheten som gikk konkurs) |
debitor_orgnr |
tekst | Org.nr til konkursdebitor |
debitor_stiftelsesdato |
dato | Stiftelsesdato for konkursdebitoren (selve virksomheten, ikke boet) |
debitor_orgform |
tekst | Organisasjonsform-kode for debitor (f.eks. AS, ENK, DA) |
debitor_orgform_beskrivelse |
tekst | Organisasjonsform i klartekst (f.eks. «Aksjeselskap») |
debitor_aktivitet |
tekst | Beskrivelse av virksomhetens aktivitet (fra Brreg) |
debitor_formaal |
tekst | Vedtektsfestet formål (fra Brreg) |
bostyrer |
tekst | Navn på bostyrer oppnevnt av tingretten |
regnskap_aar |
tekst | Sist tilgjengelige regnskapsår fra Brreg (f.eks. "2023"). null hvis ingen regnskap er innsendt. |
regnskap_valuta |
tekst | Funksjonell valuta i regnskapet (typisk NOK; EUR, USD eller SEK forekommer) |
regnskap_driftsinntekter |
heltall | Driftsinntekter (sum) i regnskapsårets valuta |
regnskap_driftsresultat |
heltall | Driftsresultat i regnskapsårets valuta |
regnskap_aarsresultat |
heltall | Årsresultat i regnskapsårets valuta |
regnskap_sum_eiendeler |
heltall | Sum eiendeler i regnskapsårets valuta |
regnskap_sum_egenkapital |
heltall | Sum egenkapital i regnskapsårets valuta (kan være negativ) |
regnskap_sum_gjeld |
heltall | Sum gjeld i regnskapsårets valuta |
Merk om regnskapsfelt: alle regnskap_*-felt er null for konkursbo der ingen regnskap er innsendt til Brønnøysundregistrene, eller der debitor er en privatperson. Beløpene oppgis i regnskapets funksjonelle valuta (se regnskap_valuta), ikke alltid NOK.
Hastighetsbegrensning
API-et tillater 60 forespørsler per minutt per IP-adresse. Begrensningen gjelder alle /api/*-endepunkter.
Ved overskridelse returneres HTTP 429 Too Many Requests med en Retry-After: 60-header. Vent angitt antall sekunder før du prøver igjen.
HTTP/1.1 429 Too Many Requests Content-Type: application/json Retry-After: 60 {"error": "For mange forespørsler. Prøv igjen om litt."}
CORS
API-et støtter Cross-Origin Resource Sharing (CORS) og kan brukes direkte fra tredjeparts nettlesere og JavaScript-applikasjoner. Alle offentlige /api/*-endepunkter returnerer Access-Control-Allow-Origin: *.
Preflight-forespørsler (OPTIONS) besvares med 204 No Content og en Access-Control-Max-Age på 24 timer.
Datakilde
Dataene hentes fra Brønnøysundregistrenes Enhetsregister og Regnskapsregister. Synkronisering skjer automatisk to ganger daglig, klokken 07:00 og 17:00 norsk tid.
Brønnøysundregistrene er den offisielle kilden. Ved feil i registrerte opplysninger, kontakt Brønnøysundregistrene direkte.