APIs

Bisnode ForetaksInfo API

460 views April 30, 2018 November 6, 2018 0

Overview

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

Using the service

Authentication

See: Bisnode API.

API

See: Bisnode API.

Queries

The service provides two types of operations for interaction with Bisnode’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.

ForetakData

Name
Type
navn String
orgnr Integer
dunsnr Integer
adresse, postnr, poststed String, Integer, String
postAdresse, postPostnr, postPoststed String, Integer, String
jurAdresse, jurPostnr, jurPoststed String, Integer, String
sisteRegnskapsAr, sisteRegnskapsMnd Integer, Integer
selskapsform String
kodeType, kodeTekst String, String
sektorKode, sektorTekst Integer, String
etablertDato String
bransjeData List of BransjeData
gjenpartsIndikator String

 

BransjeData

Name
Type
bransjeKode Integer
bransjeTekst String

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’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’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
NavnAdresse IdentifikasjonNavnAdresse
GrunnFakta IdentifikasjonGrunnfakta
RettighetsHavere IdentifikasjonRettighetshavere
JuridiskVerv IdentifikasjonJuridiskVerv
Fullmakt
Identifikasjon. FullmaktForetak

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
navn String
kodeType, kodeTekst String, String
markedsnavn String
historiskNavnData List of HistoriskNavnData
gateAdresse, gatePostnr, gatePoststed, gatePostboks String, Integer, String, String
postAdresse, postPostnr, postPoststed, postPostboks, postPosthus String, Integer, String, Integer, String
andel String
jurAdresse, jurPostnr, jurPoststed String, Integer, String
telefon String
telefax String
webadresse String
epost String

HistoriskNavnData

Name
Type
navnType String
navn String
aktivFra String
aktivTil String

Grunnfakta

Name
Type
selsFormKode, selskFormTekst String, String
etablertAr Integer
stiftetDato String
aksjekapital, aksjekapitalStatus Long, String
registrertDato, registrertSted String, String
sektorKode, sektorTekst Integer, String
revisorOrgnr, revisorNavn Integer, String
bankRegnr, bankNavn Integer, String
ansatteData List of AnsatteData
bransjeData List of BransjeData
revisorFravalgtDato String
regnskapsforerData List of RegnskapsførerData
registrertMVA Boolean

AnsatteData

Name
Type
AnsatteAr Integer
AnsatteAntall Integer

RegnskapsførerData

Name
Type
regnskapsforerOrgnr Integer
regnskapsforerInternref Long
regnskapsforerNavn String

BransjeData

Name
Type
bransjeKode Integer
bransjeTekst String

 


Rettighetshavere

Name
Type
navn String
adresse, postnr, poststed String, Integer, String
andel String
indirekteEier Boolean
fodtDato String
interreferanse Long

Juridisk

Name
Type
prokuraKode, prokuraKode Integer, String
signaturKode, signaturTekst Integer, String
eierStrukturKode, eierStrukturTekst Integer, String

Verv

Name
Type
navn String
adresse, postnr, poststed String, Integer, String
vervKode,vervTekst String, String
fodtDato String
telefon List of String
internRef Long

FullmaktPerson

Name
Type
navn String
fodtDato String
adresse, postnr, poststed String,Integer,String
fullmaktTypeKode,fullmaktTypeTekst String, String
fullmaktKode,fullmaktTekst String, String
prioritet Integer
antall Integer
obligatorisk Boolean
verv List of VervData
internreferanse Long

VervData

Name
Type
vervKode String
vervTekst String

 

Meldinger

Name
Type
meldingsKode Integer
meldingsTekst String

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."
}
]
}

Was this helpful?