APIs

Bisnode PersonInfo API

140 views October 17, 2018 November 2, 2018 1

Overview

This document describes how to interact with Bisnode’s PersonInfo 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 PersonInfo service.

Path
Verb
Scope
Content type
Input
Output
Description
/person/search POST client.bisnode.post.person application/json PersonSearchRequest PersonSokResponse Search for a person.
/person/info POST client.bisnode.post.person application/json PersonInfoRequest HentPersonResponse Obtain information about a person.
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

Person Search

Search for a person.

PersonSearchRequest

Name
Type
Required
Description
fodselsnr Long Yes: if fornavn and/or etternavn are not provided.
No: if fornavn and etternavn are both provided.
Norwegian national ID number.
fodselsdato String No Date of birth (format: yyyy-mm-dd)
etternavn String Yes: if fodselsnr is not provided.
No: if fodselsnr is provided.
Surname/ last name.
fornavn String Yes: if fodselsnr is not provided.
No: if fodselsnr is provided.
Given name/ first name.

PersonSokResponse

Name
Type
Description
personalia List<Personalia> List of Personalia objects, containing basic information on the person. In practice, since Bisnode only returns results for queries matching exactly 1 person, this list will contain between 0-1 items.
meldinger List<Meldinger> List of messages from Bisnode.

Personalia

Name
Type
Description
internref Long Bisnode’s internal reference number for the person. Can be used as input in a subsequent info request.
kilde String Source for the person’s name and address. Bisnode Name Database (P), Bisnode History Database (H).
status String Status code signifying if the individual has left the country (U), or is deceased (D).
statusDato XMLGregorianCalendar Date when status was last updated.
fodselsdato XMLGregorianCalendar Date of birth.
navn String Full name (Last First Middle).
fornavn String First name/ given name.
mellomnavn String Middle name.
etternavn String Last name/ surname.
adresse String Current address of residence.
postnr String Zip code.
poststed String City.
kommune String Municipality.
fylke String County.
postAdresse1 String Postal address 1.
postAdresse2 String Postal address 2.
postAdresse3 String Postal address 3.
postAdresseLandkode String Postal address and country code.
postAdresseLandtekst String Postal address and country full name.
alder Integer Age.
kjonn String Sex (F/M).
Telefon List<Telefon> List of phone numbers.

Telefon

Name Type
value String
type String

Code example

Request
Path /person/search
Verb POST
Headers  

Content-Type application/json
Accept application/json
Authorization Bearer xyz123

 

Body
{
	"fodselsnr": 01010012345,
	"fodselsdato": "1900-01-01",
	"fornavn": "Ola",
	"etternavn": "Nordmann"
}
Response
Headers Content-Type: application/json
Body
{
    "personalia": [
        {
            "internref": 123456789,
            "statusDato": "2016-10-06T22:00:00.000+0000",
            "fodselsdato": "1899-12-31T22:00:00.000+0000",
            "navn": "OLA NORDMANN",
            "fornavn": "OLA",
            "etternavn": "NORDMANN",
            "adresse": "ADRESSEVEIEN 1A",
            "postnr": "7010",
            "poststed": "TRONDHEIM",
            "kommune": "TRONDHEIM",
            "fylke": "TRØNDELAG",
            "alder": "118",
            "kjonn": "MANN",
            "telefon": []
        }
    ],
    "meldinger": []
}

Person Info

Fetch specific and detailed information about a person, such as current and prior places of residence, business/ commercial points of interests, or companies in which they hold power of attorney.

PersonInfoRequest

Name
Type
Required
Description
internref long Yes Bisnode’s internal reference number for the individual. A given person’s internref can be retrieved by first performing a search request.
hent List<PersonInfoType> Yes List of desired information elements to return.

PersonInfoType

Enum used to determine which information will be returned in the response.

Name Returned Objects Description
GRUNNFAKTA PersonIdentifikasjon, PersonNavnAdresse, TidligereNavnAdresse Information on the person’s current name and address, as well as any prior names/ addresses (if any).
NARINGSINTERESSER PersonIdentifikasjonNaringsInteresser Information regarding the person’s current and prior business and commercial points of interest, if any.
FULLMAKT PersonIdentifikasjonFullmaktForetak Information on companies in which the person holds power of attorney, if any.

HentPersonResponse

Elements that may be returned in the response, depending on which PersonInfoTypes were provided in the request. For all successful requests, PersonIdentifikasjon is returned. Meldinger generally contains messages describing errors or notices about requested information which Bisnode was unable to provide, usually because Bisnode does not have the information, or because the client is not authorized to access it.

Name
Type
Description
identifikasjon PersonIdentifikasjon PersonIdentifikasjon object.
navnAdresse PersonNavnAdresse PersonNavnAdresse object.
tidligereNavnAdresse List<TidligereNavnAdresse> List of TidligereNavnAdresse objects. Prior names and addresses.
naringsInteresser List<NaringsInteresser> List of NaringsInteresser objects. Commercial and business points of interest.
fullmaktForetak List<FullmaktForetak> List of FullmaktForetak objects.
meldinger List<Meldinger> List of Meldinger objects.

PersonIdentifikasjon

Consists of Bisnode’s internal reference number for the person.

Name Type
internref long

PersonNavnAdresse

Current name and address, as well as date of birth, age, sex, and phone number(s).

Name
Type
Description
status String Status code signifying if the individual has left the country (U), or is deceased (D).
statusDato XMLGregorianCalendar Date when status was last updated.
fodselsdato XMLGregorianCalendar Date of birth.
navn String  Full name (Last First Middle).
fornavn String  First name/ given name.
mellomnavn String  Middle name.
etternavn String  Last name/ surname.
adresse String  Street address.
postnr String  Zip code.
poststed String  City.
kommune String  Municipality.
fylke String  County.
postAdresse1 String  Postal address 1.
postAdresse2 String  Postal address 2.
postAdresse3 String  Postal address 3.
postAdresseLandkode String Postal address with country code.
postAdresseLandtekst String Postal address with country full name.
alder Integer  Age.
kjonn String  Sex (F/M).
telefon List<String>  List of phone numbers.

TidligereNavnAdresse

Name
Type
Description
tidligereNavnAdresse String Previous name and street address.
endringsDato XMLGregorianCalendar Date of change.
endringsType String Type of change, either name or address.
tidligerePostAdresse String Previous zip code and place.

NaringsInteresser

Name
Type
Description
orgnr Integer Company organization number.
statusKode String Status code. Active (A), Liquidated (L), bankrupt (K), inactive (I).
statusTekst String Status text. Aktiv (active), Likvidert (liquidated), Konkurs (bankrupt), Inaktiv (inactive), and date.
statusDato XMLGregorianCalendar Registration date of status code.
navn String Name of company.
selskForm String Company structure (PLC, Ltd, etc.).
rolle String Person’s role in the company. Partnership/ owner.
eierandel Double Shareholder share.
vervKode String Code for the person’s role in the company, if partnership.
vervTekst String Full text of the role code.

FullmaktForetak

Name
Type
Description
dunsnr Integer DUNS number.
orgnr Integer Organization number.
navn String Name of company.
adresse String Address of company.
postnr Integer Zip code.
poststed String City.
statusKode String Status code. Active (A), Liquidated (L), bankrupt (K), inactive (I).
statusTekst String Full text of the status code.
selskapsform String Company structure (PLC, Ltd, etc.).
prokuraKode String Group code for procuration text.
prokuraTekst String Procuration text.
signaturKode String Group code for signature text.
signaturTekst String Signature text.
fullmaktPerson List<FullmaktPerson> Information on persons who hold power of attorney in the company.

FullmaktPerson

Information from the signature and procuration register regarding the holder of power of attorney in question.

Name
Type
Description
internreferanse Long Bisnode’s internal reference number for the individual.
fodtDato XMLGregorianCalendar Date of birth.
navn String Full name (Last First Middle)
adresse String Street address.
postnr Integer Zip code.
poststed String City.
fullmaktTypeKode String Codified signature/ procuration.
fullmaktTypeTekst String Signature/ procuration.
fullmaktKode String Codified type of authority, e.g. FEALHV, etc.
fullmaktTekst String Type of authority, e.g. Fellesskap (jointly), Alene (alone), Hver for seg (separately), etc.
prioritet Integer Group priority number for the authority. For example, a value of 1 entails a higher priority than a value of 2.
antall Integer Number of persons required in the signature. 0 if alone.
obligatorisk Boolean Whether or not the person is required in the authority, e.g. in cases of joint powers of attorney.
verv List<VervData> List of the person’s roles/ posts/ positions in the company.

VervData

Name
Type
Description
vervKode String Role code.
vervTekst String Full title of the role, e.g. Styreformann (chairman), Styremedlem (board member) Daglig Leder (general manager), etc.

Meldinger

Name
Type
Description
meldingsKode Integer Message code.
meldingsTekst String Message text.

Code example

Request
Path /person/info
Verb POST
Headers  

Content-Type application/json
Accept application/json
Authorization Bearer xyz123

 

Body
{
	"internref": 123456789,
        "hent": [
            "GRUNNFAKTA",
            "NARINGSINTERESSER",
            "FULLMAKT"
         ]
}
Response
Headers Content-Type: application/json
Body
{
    "identifikasjon": {
        "internref": 123456789
    },
    "navnAdresse": {
        "status": "0",
        "statusDato": "2016-10-06T22:00:00.000+0000",
        "fodselsdato": "1899-12-31T22:00:00.000+0000",
        "navn": "NORDMANN OLA",
        "fornavn": "OLA",
        "etternavn": "NORDMANN",
        "adresse": "ADRESSEVEIEN 1 A",
        "postnr": "7010",
        "poststed": "TRONDHEIM",
        "kommune": "TRONDHEIM",
        "fylke": "TRØNDELAG",
        "alder": 118,
        "kjonn": "MANN",
        "telefon": []
    },
    "delomrader": [],
    "betaDetaljer": [],
    "ligning": [],
    "disponibelInntekt": [],
    "naringsInteresser": [
        {
            "orgnr": 123123123,
            "statusKode": "A",
            "statusTekst": "Aktivt",
            "navn": "EKSEMPELSELSKAP 1 AS",
            "selskForm": "AS",
            "rolle": "Eier",
            "eierandel": 50.01
        },
        {
            "orgnr": 987987987,
            "statusKode": "A",
            "statusTekst": "Aktivt",
            "navn": "EKSEMPELSELSKAP 2 DA",
            "selskForm": "DA",
            "rolle": "Ansvar",
            "eierandel": 0,
            "vervKode": "20",
            "vervTekst": "Daglig leder"
        }
    ],
    "eiendomListe": [],
    "losore": [],
    "tidligereNavnAdresse": [
        {
            "tidligereNavnAdresse": "ADRESSEVEIEN 2 B",
            "endringsDato": "2010-11-09T23:00:00.000+0000",
            "endringsType": "Adresse",
            "tidligerePostAdresse": "7010 TRONDHEIM"
        }
    ],
    "fullmaktForetak": [
        {
            "dunsnr": 345345345,
            "orgnr": 123123123,
            "navn": "EKSEMPELSELSKAP 1 AS",
            "adresse": "EKSEMPELVEIN 12 B",
            "postnr": 7079,
            "poststed": "FLATÅSEN",
            "statusKode": "A",
            "statusTekst": "Aktivt",
            "selskapsform": "AS",
            "prokuraKode": "33",
            "signaturKode": "25",
            "signaturTekst": "Deltakerne hver for seg.",
            "fullmaktPerson": [
                {
                    "internreferanse": 123456789,
                    "fodtDato": "1899-12-31T22:00:00.000+0000",
                    "navn": "NORDMANN OLA",
                    "adresse": "ADRESSEVEIEN 1 A",
                    "postnr": 7010,
                    "poststed": "TRONDHEIM",
                    "fullmaktTypeKode": "S",
                    "fullmaktTypeTekst": "Signatur",
                    "fullmaktKode": "HV",
                    "fullmaktTekst": "Hver for seg",
                    "prioritet": 1,
                    "antall": 0,
                    "obligatorisk": false,
                    "verv": [
                        {
                            "vervKode": "20",
                            "vervTekst": "Daglig leder"
                        }
                    ]
                },
                {
                    "internreferanse": 456456456456,
                    "fodtDato": "1950-07-25T22:00:00.000+0000",
                    "navn": "NORDMANN KARI",
                    "adresse": "ADRESSEVEIEN 1 A",
                    "postnr": 7010,
                    "poststed": "TRONDHEIM",
                    "fullmaktTypeKode": "S",
                    "fullmaktTypeTekst": "Signatur",
                    "fullmaktKode": "HV",
                    "fullmaktTekst": "Hver for seg",
                    "prioritet": 1,
                    "antall": 0,
                    "obligatorisk": false,
                    "verv": []
                }
            ]
        }
    ],
    "meldinger": []
}

 

Was this helpful?