This guide is intended to help you get going with your integration against the Bisnode Credit Information B2B API. It serves as a complement to the  Endpoint Reference  and aims to bring a high level understanding of the key concepts of the platform.

For questions and support, please contact Bisnode at api-bisnode@bisnode.com

 

A more detailed view of the swagger documentation can be found on swaggerhub: https://app.swaggerhub.com/apis-docs/bisnode-apis/CompanyCreditDataAPI/2.0.0

 

A postman collection for accessing sandbox data can be found here: https://github.com/Bisnode/api-stuff/tree/master/apis/brigs/company/postman-collections

 

Instructions on how to generate keys to access sandbox and production environments can also be found on the link above.

API version is provided in the base of the requested URL in the form of "v1", "v2" etc. Only major version numbers are used.

 

API versions are raised only on breaking (i.e. backwards incompatible) changes in the API. Fields may be added but will never be removed during an API version lifecycle. When developing your application, take care to ensure that your application is able to handle additional fields.

  

 

Instead of the ISO 8601 format "yyyy-MM-dd" we added a model for setting year, month and day separately:

 

before:

 

"someDate": "2019-01-16"

 

after:

 

someDate": {
    "year": 2019,
    "month": 1,
    "day": 16
}

 

This gives us the flexibility to deliver dates where we only have a fraction of the data, For instance we may only have the year.

 

 

 

before:

 

"dunsNumber": "343630447"

 

after:

 

"identifiers": {
      "registrationNumber": "260428882",
      "dunsNumber": "343630447"
    }

 

 

 

 

 

before:

 

"amount": {
    "currency”: "SEK",
   "monetaryAmount": 70000
}

 

after:

 

"amount": {
    "currency": "SEK",
   "amount": “70000"
}

 

 

 

Introduced an Address model which may contain either a StreetAddress or a PostalOfficeBox.

 

before:

 

"registeredAddress": {
        "town": "Søborg",
        "countryCode": "DK",
        "postalCode": "2860",
        "street": "Gyngemose Parkvej 50, 8."
      }

 

after:

 

"registeredAddress": {
        "streetAddress": {
          "town": "Søborg",
          "countryCode": "DK",
          "postalCode": "2860",
          "street": "Gyngemose Parkvej 50, 8."
        }
      }