link

# Bisnode Norge ForetaksInfo API (deprecated)

This document describes how to interact with Bisnode Norge's ForetaksInfo service through Signicat's API. Signicat's Bisnode Norge service supports JSON for accessing the API.

This service is being phased out

This registry lookup will be phased out soon, so we recommend that you integrate towards our normalised services if you are building a new integration. To learn more about normalised registry lookups, refer to our Express offering.

# Using the service

# Authentication

All requests must be authenticated by means of an OIDC access token, supplied as an authorisation header of type Bearer. For information on how to obtain such a token, refer to Accessing Signicat REST services.

# API

Environment Base URL
Beta https://beta.signicat.com
Pre-production https://preprod.signicat.com
Production https://id.signicat.com

# Queries

The service provides two types of operations for interaction with Bisnode Norge's ForetaksInfo service.

Path Verb Scope Content type Input Output Description
/company/search POST client.bisnode.post application/json SearchRequest ForetakSokResponse Search for companies.
/company/info POST client.bisnode.post application/json InfoRequest HentForetakResponse Obtain information about a company.

# HTTP headers

Key Value Description
Content-Type application/json Describes the format of the request message body.
Accept application/json Describes which content type(s) the client will accept in the response.
Authorization See description OIDC access token of type Bearer. For instructions on how to obtain such a token, refer to Accessing Signicat REST services.

# Operations

Search for a company. At least one of the elements/search criteria must be supplied.

# SearchRequest

Name Type Description
navn String Name of the company to search for.
orgnr int Organisation number.
dunsnr int DUNS number.

# ForetakSokResponse

Name Type Description
foretakList List of ForetakData List of individual search objects - companies that satisfy search criteria given in the request.
meldinger List of Meldinger List of messages from Bisnode Norge.

# ForetakData

Name Type Description
navn String Name
orgnr Integer Organisational number
dunsnr Integer DUNS number
adresse, postnr, poststed String, Integer, String Address incl. postal address
postAdresse, postPostnr, postPoststed String, Integer, String Address incl. postal address
jurAdresse, jurPostnr, jurPoststed String, Integer, String Juridical address
sisteRegnskapsAr, sisteRegnskapsMnd Integer, Integer Last fiscal year
selskapsform String Legal structure
kodeType, kodeTekst String, String Code type, code text
sektorKode, sektorTekst Integer, String Sector type, sector text
etablertDato String Established date
bransjeData List of BransjeData Industry data
gjenpartsIndikator String Counterpart indicator

# BransjeData

Name Type Description
bransjeKode Integer Industry code
bransjeTekst String Industry text

# Code example

# Request

curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -H "Authorization: Bearer <OIDC ACCESS TOKEN>" -d '{"orgnr":"937340303"}' "<ENVIRONMENT>/bisnode/company/info"

# Response

{          
 "foretakData":[           
        {           
            "dunsnr":518304555,          
            "orgnr":937340303,          
            "kodeType":"A",          
            "kodeTekst":"Aktivt",          
            "selskapsform":"AS",          
            "navn":"SVAR DIREKTE AS",          
            "adresse":"C/o Testgruppen",          
            "postnr":580,          
            "poststed":"Oslo",          
            "jurAdresse":"C/o Testgruppen",          
            "jurPostnr":580,          
            "jurPoststed":"Oslo",          
            "telefon":"22915200",          
            "sisteRegnskapsAr":0,          
            "sisteRegnskapsMnd":0,          
            "bransjeData":[           
                {           
                    "bransjeKode":0,          
                    "bransjeTekst":""          
                }          
            ],          
            "sektorKode":0,          
            "sektorTekst":"Uoppgitt",          
            "etablertDato":"1985-12-30T23:00:00.000+0000",          
            "gjenpartsIndikator":"Ja"          
        }          
    ],          
 "meldinger":[           
 ]          
}

# Company Info

Bisnode Norge's ForetaksInfo service is capable of returning large amounts of information about a company. By supplying relevant information in the request, the client can control which information objects should be returned in the response. Instead of implementing full proxy to Bisnode Norge's ForetaksInfo service, this particular service implements a version where only a subset of the information objects may be returned.

# InfoRequest

Gets (a subset of) information about the company.

Name Type Required Description
orgnr Integer No (one of) Organisation number.
dunsnr Integer No (one of) DUNS number.
hent List of InfoType Yes List of desired information elements to return.

# InfoType

Controls which objects will be returned in the response. Each of the InfoTypes triggers the return of an Identifikasjon object. Some of the InfoTypes trigger the return of more than one object.

Name Returned objects Description
NavnAdresse Identifikasjon, NavnAdresse Name, Address
GrunnFakta Identifikasjon, Grunnfakta Company information
RettighetsHavere Identifikasjon, Rettighetshavere Legal owner
JuridiskVerv Identifikasjon, Juridisk, Verv Juridical role
Fullmakt Identifikasjon, FullmaktForetak Authorised

# HentForetakResponse

Depending on the InfoTypes supplied in the request, the following elements of the response may be returned.

Name Type Description
identifikasjon Identifikasjon Identifikasjon object.
navnAdresse NavnAdresse Navnadresse object.
grunnfakta Grunnfakta Grunnfakta object.
juridisk Juridisk Juridisk object.
verv Verv Verv object.
fullmaktForetak FullmaktForetak FullmaktFortak object.
rettighetshavere Rettighetshavere Rettighetshavere object.

# Identifikasjon

Name Type
orgnr Integer
dunsnr Integer
Name Type Description
navn String Name
kodeType, kodeTekst String, String Code type, code text
markedsnavn String Commerical name
historiskNavnData List of HistoriskNavnData Historical name
gateAdresse, gatePostnr, gatePoststed, gatePostboks String, Integer, String, String Visiting address
postAdresse, postPostnr, postPoststed, postPostboks, postPosthus String, Integer, String, Integer, String Postal address
andel String Share
jurAdresse, jurPostnr, jurPoststed String, Integer, String Juridical address
telefon String Phone
telefax String Fax
webadresse String Web address
epost String E-mail

# HistoriskNavnData

Name Type Description
navnType String Name type
navn String Name
aktivFra String Active from
aktivTil String Active to

# Grunnfakta

Name Type Description
selsFormKode, selskFormTekst String, String Legal structure code, legal structure text
etablertAr Integer Established year
stiftetDato String Established date
aksjekapital, aksjekapitalStatus Long, String Share capital
registrertDato, registrertSted String, String Register date, register place
sektorKode, sektorTekst Integer, String Sector code, sector text
revisorOrgnr, revisorNavn Integer, String Auditor orgnr, auditor name
bankRegnr, bankNavn Integer, String Bank registration number, bank name
ansatteData List of AnsatteData Employee data
bransjeData List of BransjeData Industry data
revisorFravalgtDato String Auditor from date
regnskapsforerData List of RegnskapsførerData Accountant data
registrertMVA Boolean VAT registered

# AnsatteData

Name Type Description
AnsatteAr Integer Employee year
AnsatteAntall Integer Employee count

# RegnskapsførerData

Name Type Description
regnskapsforerOrgnr Integer Accountant orgnr
regnskapsforerInternref Long Accountant internalref
regnskapsforerNavn String Accountant name

# BransjeData

Name Type Description
bransjeKode Integer Industry code
bransjeTekst String Industry text

# Rettighetshavere

Name Type Description
navn String Name
adresse, postnr, poststed String, Integer, String Address
andel String Share
indirekteEier Boolean Indirect owner
fodtDato String Date of birth
interreferanse Long Internal ref

# Juridisk

Name Type Description
prokuraKode, prokuraKode Integer, String Procuration code
signaturKode, signaturTekst Integer, String Signature code, signature text
eierStrukturKode, eierStrukturTekst Integer, String Owner structure code, owner structure text

# Verv

Name Type Description
navn String Name
adresse, postnr, poststed String, Integer, String Address
vervKode,vervTekst String, String Role code, Role text
fodtDato String Date of birth
telefon List of String Phone
internRef Long Internalref

# FullmaktForetak

Name Type Description
navn String Name
orgnr Integer Organisational number
dunsnr Integer DUNS number
statusKode,statusTekst String, String Status code, status text
prokuraKode,prokuraTekst String, String Procuration code, Procuration text
signaturKode,signaturTekst String, String Signature code, signature text
selskapsform String Legal structure
fullmaktPerson List of FullmaktPerson Authorised Person

# FullmaktPerson

Name Type Description
navn String Name
fodtDato String Date of birth
adresse, postnr, poststed String,Integer,String Address
fullmaktTypeKode,fullmaktTypeTekst String, String Authorisation type code, authorisation type text
fullmaktKode,fullmaktTekst String, String Authorisation code, authorisation text
prioritet Integer Priority
antall Integer Amount
obligatorisk Boolean Required
verv List of VervData Role
internreferanse Long Internal ref

# VervData

Name Type Description
vervKode String Role code
vervTekst String Role text

# Meldinger

Name Type Description
meldingsKode Integer Message code
meldingsTekst String Message text

# Code example

# Request

curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -H "Authorization: Bearer <OIDC ACCESS TOKEN>" -d '{"orgnr":"937340303", "hent":["NAVNADRESSE","GRUNNFAKTA","RETTIGHETSHAVERE","JURIDISKVERV"]}'"<ENVIRONMENT>/bisnode/company/info"

# Response

{
    "identifikasjon":{
        "orgnr":937340303,
        "dunsnr":518304555
    },
    "navnAdresse":{
        "kodeType":"A",
        "kodeTekst":"Aktivt",
        "navn":"SVAR DIREKTE AS",
        "markedsnavn":"TESTFORETAK",
        "historiskNavnData":[],
        "gateAdresse":"C/o Testgruppen",
        "gatePostnr":580,
        "gatePoststed":"Oslo",
        "postPostboks":34,
        "postPosthus":"Økern",
        "postPostnr":508,
        "postPoststed":"Oslo",
        "jurAdresse":"C/o Testgruppen",
        "jurPostnr":580,
        "jurPoststed":"Oslo",
        "telefon":"22915200",
        "telefax":"22915295"
    },
    "histRating":[],
    "grunnfakta":{
        "selskFormKode":"AS",
        "selskFormTekst":"Privat aksjeselskap",
        "etablertAr":1960,
        "stiftetDato":"1985-12-30T23:00:00.000+0000",
        "aksjekapital":500000,
        "aksjekapitalStatus":"Fullt innbetalt",
        "registrertSted":"Foretaksregisteret",
        "registrertDato":"1989-12-20T23:00:00.000+0000",
        "revisorOrgnr":957834124,
        "revisorNavn":"Revisorgruppen AS",
        "bankRegnr":0,
        "sektorKode":0,
        "sektorTekst":"Uoppgitt",
        "regnskapsforerData":[],
        "bransjeData":[],
        "ansatteData":[
            {
                "ansatteAr":2017,
                "ansatteAntall":70
            },
            {
                "ansatteAr":2016,
                "ansatteAntall":70
            },
            {
                "ansatteAr":2015,
                "ansatteAntall":56
            },
            {
                "ansatteAr":2014,
                "ansatteAntall":56
            },
            {
                "ansatteAr":2013,
                "ansatteAntall":56
            },
            {
                "ansatteAr":2012,
                "ansatteAntall":56
            },
            {
                "ansatteAr":2011,
                "ansatteAntall":56
            },
            {
                "ansatteAr":2010,
                "ansatteAntall":56
            }
        ],
        "registrertMVA":false
    },
    "juridisk":[
        {
            "prokuraKode":33,
            "signaturKode":29
        }
    ],
    "verv":[
        {
            "internRef":12918138766266,
            "fodtDato":"1971-08-31T23:00:00.000+0000",
            "navn":"KVERNLAND LISE",
            "telefon":[],
            "adresse":"TYRISTUBBEN 100",
            "postnr":3742,
            "poststed":"SKIEN",
            "vervKode":"2",
            "vervTekst":"Nestleder"
        },
        {
            "internRef":34778828412478,
            "fodtDato":"1975-07-22T23:00:00.000+0000",
            "navn":"PERSON DEMO UNG",
            "telefon":[],
            "adresse":"SPERRET ADRESSE, STRENGT FORTR",
            "vervKode":"3",
            "vervTekst":"Styremedlem"
        },
        {
            "internRef":13318230358902,
            "fodtDato":"1986-06-07T22:00:00.000+0000",
            "navn":"BERG ELLA",
            "telefon":[],
            "adresse":"TYRISTUBBEN 2",
            "postnr":4825,
            "poststed":"ARENDAL",
            "vervKode":"3",
            "vervTekst":"Styremedlem"
        },
    ],
    "aksjonar":[],
    "datterselskap":[],
    "okonomiEnk":[],
    "nokkeltallForetak":[],
    "nokkeltallBransje":[],
    "nokkeltallKonsern":[],
    "betaDetaljer":[],
    "losore":[],
    "konsernLink":[],
    "okonomiSammendragForetak":[],
    "okonomiSammendragKonsern":[],
    "okonomiDetaljerForetak":[],
    "okonomiDetaljerKonsern":[],
    "eiendelerForetak":[],
    "eiendelerKonsern":[],
    "gjeldEgenkapitalForetak":[],
    "gjeldEgenkapitalKonsern":[],
    "revisoranmerkninger":[],
    "rettighetshavere":[],
    "eiendomNorgeListe":[],
    "fullmaktForetak":[
        {
            "dunsnr":518304555,
            "orgnr":937340303,
            "navn":"SVAR DIREKTE AS",
            "adresse":"c/o Testgruppen",
            "postnr":580,
            "poststed":"OSLO",
            "statusKode":"A",
            "statusTekst":"Aktivt",
            "selskapsform":"AS",
            "prokuraKode":"33",
            "signaturKode":"29",
            "fullmaktPerson":[
                {
                    "internreferanse":12909565045604,
                    "fodtDato":"2006-12-31T23:00:00.000+0000",
                    "navn":"TOPSTAD TOMAS",
                    "adresse":"BOKS 6300, ETTERSTAD",
                    "postnr":603,
                    "poststed":"OSLO",
                    "fullmaktTypeKode":"S",
                    "fullmaktTypeTekst":"Signatur",
                    "fullmaktKode":"AL","fullmaktTekst":"Alene",
                    "prioritet":1,
                    "antall":0,
                    "obligatorisk":false,
                    "verv":[]
                }
            ]
        }
    ],
    "meldinger":[
        {
            "meldingsKode":251,
            "meldingsTekst":"Prokura ikke funnet på forespurt objekt."
        },
        {
            "meldingsKode":252,"meldingsTekst":"Signatur ikke funnet på forespurt objekt."
        },
        {
            "meldingsKode":297,"meldingsTekst":"Reelle rettighetshavere kunne ikke identifiseres pga. eierstruktur."
        }
    ]
}
Last updated: 01/11/2022 08:35 UTC