API-dokumentasjon
Konkurs.app tilbyr et gratis, åpent JSON API for oppslag i norske konkursbo. Dataene hentes daglig fra Brønnøysundregistrenes Enhetsregister-API og omfatter alle registrerte konkursbo med tilhørende roller, næringskoder og adresser.
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 |
bostyrer | tekst | Navn på bostyrer oppnevnt av tingretten |
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
Alle data hentes fra Brønnøysundregistrenes Enhetsregister-API. Dataene synkroniseres automatisk hver dag klokken 05:00 UTC.
Brønnøysundregistrene er den offisielle kilden. Ved feil i registrerte opplysninger, kontakt Brønnøysundregistrene direkte.