Overview

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.

Using the service

Authentication

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

API

Environment
Base URL
Beta https://beta.signicat.com
Preproduction 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, please refer to Accessing Signicat REST services.

 


Operations

Search

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 Organization 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 Organizational 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) Organization 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 IdentifikasjonNavnAdresse Name, Address
GrunnFakta IdentifikasjonGrunnfakta Company information
RettighetsHavere IdentifikasjonRettighetshavere Legal owner
JuridiskVerv IdentifikasjonJuridiskVerv Juridical role
Fullmakt Identifikasjon, FullmaktForetak Authorized

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

NavnAdresse

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 Organizational 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 Authorized Person

FullmaktPerson

Name
Type
Description
navn String Name
fodtDato String Date of birth
adresse, postnr, poststed String,Integer,String Address
fullmaktTypeKode,fullmaktTypeTekst String, String Authorization type code, authorization type text
fullmaktKode,fullmaktTekst String, String Authorization code, authorization 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."
}
]
}