Overview

The advantages of using our API to consume monitoring is to be able to set up an automatic flow. By setting up an integration to your CRM or ERP system, you can ensure that the right people in your organization can get information about various events daily and thus minimize credit losses and through continuous updates ensure that necessary information reaches the right department or person.

Credit Monitoring provides an API that allows an integrated user to manage a portfolio of monitored companies and retrieve new events that are relevant to managing their credit portfolio risk. The service covers events on companies in Sweden, Finland, Demark and Norway. Events are updated daily and holds a full year of historical updates.

  
Authentication

To use the Credit Monitoring B2B API, you need a client ID and a secret. Use OAuth2 for authentication. More information here.

To access the Monitoring API you need to set the scope to: credit_data_monitoring

Get started

You’ll need to create a Bisnode ID or you can use your GitHub account to login here.

  • Sandbox API Key (you need to be logged in with your Bisnode ID or GitHub account)

  • For easy access we have provided you with a postman collection here.

For questions and support, please contact us at api-support@bisnode.com.
Key Features

Company data available through an API

Provides you with high quality analyzed risk and credit data.

You’re able to fetch the latest updates of companies you are monitoring in your portfolio. This is a key for you as company to be able to detect risk in an early state.

This is a key for you as company to be able to detect risk in an early state.

Avoid credit losses by doing business with the right customers
Technical documentation
Please check our technical documentation for our API here.
 
Documentation

How to use the API

This guide is intended to help you get going with your integration against the B2B Monitoring API. It serves as a complement to the  Swagger documentation and aims to bring a high level understanding of how to use the API.

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

 

Portfolio

A portfolio is a collection of companies for which you want to monitor changes. A user by default has a main portfolio. If you add companies to the main portfolio, you will be able to get financial updates on those companies. The following actions can be performed on the main portfolio:

  • add companies to portfolio
  • get events for companies in portfolio
  • get events for a single company
  • get companies in the portfolio
  • check if a company exists in the portfolio
  • remove companies from the portfolio
  • get portfolio base data
  • get event codes by cathegory (only available trough the API)
  • add/remove references per company

Sandbox Test objects

Swedish Test objects
Name Registration Number Event Category Event Code Description
Skuldman & Son, TEST AB 5561234567  RISK  RATING_CHANGED  Rating changed from AA to AAA
Skuldman & Son, TEST AB 5561234567  RISK  RATING_CHANGED  Rating changed from A to AA
Skuldman & Son, TEST AB 5561234567  PAYMENT_ABILITY  ORDER_TO_PAY  Injunction to pay
Skuldman & Son, TEST AB 5561234567  MANAGEMENT  TOTAL_BOARD_CHANGE_NOT_UNAUTHORIZED  Change of board total unauthorized
Skuldman & Son, TEST AB 5561234567  MANAGEMENT  BOARDMEMBER_CHANGED  Change of board- notification at Bolagsverket
Test No 3 mining enterprise 5561234567  MANAGEMENT  EXIT_BOARD_MEMBER_CEO_AUTHORIZED_SIGNATORY_NOTIFIED  Exit of board member - notification at Bolagsverket
Test No 3 mining enterprise 5562000116  RISK  RATING_CHANGED  Rating changed from B to A
Test No 3 mining enterprise 5562000116  RISK  RATING_CHANGED  Rating changed from A to B
Test No 3 mining enterprise 5562000116  PAYMENT_ABILITY  PETITION_INJUNCTION_PAY  Petition injunction to pay
Test No 3 mining enterprise 5562000116  INSOLVENCY_INACTIVITY  LIQUIDATION_ANNOUNCEMENT  Liquidation announcement
Test No 3 mining enterprise 5562000116  REGISTRATION_STATUS  DEREGISTERED_FTAX_DECLARATION_MISSING  Deregistered for F-tax declaration missing
Test Tourism bank 5562000116  PAYMENT_ABILITY  ORDER_TO_PAY_FEE_ANNUAL_REPORT_OVERDUE  Fee for late annual report overdue
Test Tourism bank 5563035798  RISK  RATING_CHANGED  Rating changed from B to A
Test Tourism bank 5563035798  PAYMENT_ABILITY  ORDER_TO_PAY_PASSED_COURT_ASSET_RECOVERY  Injunction to pay passed to court due to asset recovery
Test Tourism bank 5563035798  MANAGEMENT  BOARDMEMBER_CHANGED  Exit of board member
ÁàèôÑ ÅäöáàéèÔÑ AB 5563035798  REGISTRATION_STATUS  DEREGISTERED_FTAX_BUSINESS_CEASED  Deregistered for F-tax business ceased
ÁàèôÑ ÅäöáàéèÔÑ AB 5562187129  REGISTRATION_STATUS  NOT_REGISTERED_FTAX  Not registred for F-tax
ÁàèôÑ ÅäöáàéèÔÑ AB 5562187129  REGISTRATION_STATUS  DEREGISTERED_FTAX_DECLARATION_MISSING  Deregistered for F-tax declaration missing
ÁàèôÑ ÅäöáàéèÔÑ AB 5562187129  PAYMENT_ABILITY  ORDER_TO_PAY_PASSED_COURT  Injunction to pay passed to court due to appeal
ÁàèôÑ ÅäöáàéèÔÑ AB 5562187129  RISK  LIMIT_CHANGED  Recommended limit changed from 0 kEUR to 2 kEUR
Konkursen TEST AB 5562187129  RISK  RATING_CHANGED  Rating changed from A to AA
Konkursen TEST AB 5561060111  RISK  RATING_CHANGED  Rating changed from B to A
Konkursen TEST AB 5561060111  RISK  RATING_CHANGED  Rating changed from A to B
Konkursen TEST AB 5561060111  PAYMENT_ABILITY  INJUNCTION_PAY_TO_COURT  Petition injunction to pay passed to court
Hema Test i Konkurs AB 5561060111  REGISTRATION_STATUS  DEREGISTERED_FTAX_OWN_REQUEST  Deregistered for F-tax by own requset
Hema Test i Konkurs AB 5561080101  RISK  RATING_CHANGED  Rating changed from B to C
Hema Test i Konkurs AB 5561080101  REGISTRATION_STATUS  DEREGISTERED_FTAX_OWN_REQUEST  Deregistered for F-tax by own request
Hema Test i Konkurs AB 5561080101  INSOLVENCY_INACTIVITY  COMPANY_CEASED  Company ceased
Hema Test i Konkurs AB 5561080101  REGISTRATION_STATUS  DEREGISTERED_FTAX_ACCOUNTING_PAYMENT  Deregistered for F-tax incomplete accounting/payment
Hema Test i Konkurs AB 5561080101  INSOLVENCY_INACTIVITY  LIQUIDATION_STARTED  Liquidation
Hema Test i Konkurs AB 5561080101  INSOLVENCY_INACTIVITY  COMPANY_DEREGISTERED  Company is deregistered
Test Tangun trading AB 5561080101  PAYMENT_ABILITY  DEBT_BALANCE_OPENED  Debt balance opened
Test Tangun trading AB 5561070102  INSOLVENCY_INACTIVITY  BANKRUPTCY_CASE_RECEIVED  Bankruptcy issue received by Bolagsverket
Test Tangun trading AB 5561070102  INSOLVENCY_INACTIVITY  BANKRUPTCY_PROCEEDINGS_CLOSED_REGISTERED  Bankruptcy proceedings concluded registered at Bolagsverket
Testföretag 1954 AB 5561070102  RISK  RATING_CHANGED  Rating changed from A to B
Testföretag 1954 AB 5560391954  INSOLVENCY_INACTIVITY  INJUNCTION_LIQUIDATION_REGISTERED  Injunction of liquidation registered at Bolagsverket
Testföretag 1954 AB 5560391954  MANAGEMENT  CHANGE_BOARD_CEO_AUTHORIZED_SIGNATORY_NOTIFIED  Change of board- notification at Bolagsverket
Testföretag 1954 AB 5560391954  RISK  RATING_CHANGED  Rating changed from A to B
Testbolag 9255 5560391954  RISK  RATING_CHANGED  Rating changed from B to A
Testbolag 9255 7502199255  PAYMENT_ABILITY  ORDER_TO_PAY_PARKING_OVERDUE  Parking fee overdue
Testbolag 9255 7502199255  REGISTRATION_STATUS  DEREGISTERED_FTAX_INCOMPLETE_ACCOUNTING_PAYMENT  Deregistered for F-tax incomplete accounting/payment
Testbolag 6990 KB 7502199255  RISK  RATING_CHANGED  Rating changed from A to B
Testbolag 6990 KB 9696096990  RISK  RATING_CHANGED  Rating changed from B to A
Testbolag 6990 KB 9696096990  REGISTRATION_STATUS  DEREGISTERED_FOR_BUSINESS_CEASED  Deregistered for F-tax business ceased
Testbolag 6990 KB 9696096990  REGISTRATION_STATUS  DEREGISTERED_FTAX_NEGLECT_COMPANY_MANAGEMENT  Deregistered for F-tax neglect by company management
Testbolag 6990 KB 9696096990  INSOLVENCY_INACTIVITY  BANKRUPTCY_PETITION  Bankruptcy petition
Testbolag 6990 KB 9696096990  INSOLVENCY_INACTIVITY  BANKRUPTCY_INITIATED  Bankruptcy initiated
Testföretag 238 9696096990  REGISTRATION_STATUS  DEREGISTERED_FTAX_NEGLECT_COMPANY  Deregistered for F-tax neglect by company
Testföretag 238 7601022382  RISK  RATING_CHANGED  Rating changed to NEW
Testföretag 238 7601022382  RISK  RATING_CHANGED  Rating changed from NEW to A
Testföretag 238 7601022382  RISK  LIMIT_CHANGED  Recommended limit changed from 271 kSEK to 271 kSEK
Testföretag 238 7601022382  REGISTRATION_STATUS  DEREGISTERED_FTAX_NEGLECT_COMPANY  Deregistered for F-tax neglect by company
Testföretag 238 7601022382  PAYMENT_ABILITY  PAYMENT_INDEX_CHANGED  Payment index changed from 80 to 79
Testföretag 238 7601022382  REGISTRATION_STATUS  DEREGISTERED_FTAX_NEGLECT_COMPANY_MANAGEMENT  Deregistered for F-tax neglect by company management
Testföretag 238 7601022382  PAYMENT_ABILITY  DISTRAINT_PAID  Distraint not paid
Testföretag 238 7601022382  MANAGEMENT  TOTAL_BOARD_CHANGED  Change of board total
Finish Test objects
Name Registration Number Event Category Event Code Description
Intelacard Oy 200967437  INSOLVENCY_INACTIVITY  BANKRUPTCY_REQUEST  Proof of debt in bankruptcy
Intelacard Oy 200967437  FINANCIAL_INFORMATION  NEW_ANNUAL_ACCOUNTS  New annual report
Intelacard Oy 200967437  RISK  RATING_CHANGED  Rating changed from A to B
DECO FRESH OY 228810019  INSOLVENCY_INACTIVITY  BANKRUPTCY_REQUEST  Proof of debt in bankruptcy
DECO FRESH OY 228810019  MANAGEMENT  BOARDMEMBER_CHANGED  Board of directors changed
DECO FRESH OY 228810019  RISK  RATING_CHANGED  Rating changed from A to B
DECO FRESH OY 228810019  RISK  RATING_CHANGED  Rating changed from B to A
DECO FRESH OY 228810019  RISK  RATING_CHANGED  Rating changed from C to B
Second Time Around 246926306  INSOLVENCY_INACTIVITY  LIQUIDATION_REQUEST  Declared liquidation
Second Time Around 246926306  BASIC_INFORMATION  NAME_CHANGED  Name changed
Rolling Thunder Oy 251631316  REGISTRATION_STATUS  TRADE_REGISTER_ADDED  Added to Trade register
Rolling Thunder Oy 251631316  PAYMENT_ABILITY  PAYMENT_INDEX_CHANGED  Payment index changed
Rolling Thunder Oy 251631316  REGISTRATION_STATUS  TRADE_REGISTER_REMOVED  Removed from Trade register
Rolling Thunder Oy 251631316  RISK  RATING_CHANGED  Rating changed from B to A
Deco Refreshments Oy 260428882  INSOLVENCY_INACTIVITY  BANKRUPTCY_LAPSED  Bankruptcy petition by creditor
Deco Refreshments Oy 260428882  PAYMENT_ABILITY  DISTRAINT_NOT_PAID  Enforcement action barred for lack of means
Deco Refreshments Oy 260428882  RISK  RATING_CHANGED  Rating changed from B to A
Deco Refreshments Oy 260428882  RISK  RATING_CHANGED  Rating changed from A to B
Grass Roots Yard Services Oy 280429609  BASIC_INFORMATION  POSTAL_ADDRESS_CHANGED  Postal address changed
Grass Roots Yard Services Oy 280429609  INSOLVENCY_INACTIVITY  DISSOLVED  Dissolved
Grass Roots Yard Services Oy 280429609  RISK  RATING_CHANGED  Rating changed from A to B
Tytärtesti100 Oy 11111111  RISK  CREDITLIMIT_CHANGED  Recommended limit changed
Tytärtesti100 Oy 11111111  MANAGEMENT  MANAGEMENT_CHANGED  Managing director changed
Tytärtesti100 Oy 11111111  RISK  RATING_CHANGED  Rating changed from A to B
Tytärtesti100 Oy 11111111  RISK  RATING_CHANGED  Rating changed from B to A
Tytärtesti200 Oy 22222222  RISK  RATING_CHANGED  Rating changed from B to A
Tytärtesti200 Oy 22222222  RISK  RATING_CHANGED  Rating changed from A to B
Tytärtesti200 Oy 22222222  RISK  CREDITLIMIT_CHANGED  Recommended limit changed
Danish Test objects
Name Registration Number Event Category Event Code Description
D&B Demo A/S 13287511  BASIC_INFORMATION  NAME_CHANGED  Name changed
D&B Demo A/S 13287511  FINANCIAL_INFORMATION  ANNUALREPORT_NEW  New annual report
D&B Demo A/S 13287511  RISK  RATING_CHANGED  Rating changed from A to B
D&B Demo Datter ApS 13287554  INSOLVENCY_INACTIVITY  BANKRUPTCY_REQUEST  Proof of debt in bankruptcy
D&B Demo Datter ApS 13287554  MANAGEMENT  BOARDMEMBER_CHANGED  Board of directors changed
D&B Demo Datter ApS 13287554  RISK  RATING_CHANGED  Rating changed from A to B
D&B Demo Datter ApS 13287554  RISK  RATING_CHANGED  Rating changed from B to C
D&B Demo Datter ApS 13287554  RISK  RATING_CHANGED  Rating changed from C to B
Eisner Food Stores Under Konkurs 173989737  RISK  CREDITLIMIT_CHANGED  Recommended limit changed
Eisner Food Stores Under Konkurs 173989737  BASIC_INFORMATION  NAME_CHANGED  Name changed
id Boutiques ApS 534259076  REGISTRATION_STATUS  TRADEREGISTER_ADDED  Added to Trade register
id Boutiques ApS 534259076  PAYMENT_ABILITY  PAYDEX_CHANGED  Payment index changed
id Boutiques ApS 534259076  RISK  CREDITLIMIT_CHANGED  Recommended limit changed
id Boutiques ApS 534259076  RISK  RATING_CHANGED  Rating changed from B to A
Zany Brainy 596490479  INSOLVENCY_INACTIVITY  BANKRUPTCY_KR  Bankruptcy petition by creditor
Zany Brainy 596490479  RISK  CREDITLIMIT_CHANGED  Recommended limit changed
Zany Brainy 596490479  RISK  RATING_CHANGED  Rating changed from B to A
Zany Brainy 596490479  RISK  RATING_CHANGED  Rating changed from A to B
Brendles ApS 738297771  BASIC_INFORMATION  POSTADDR_CHANGED  Postal address changed
Brendles ApS 738297771  INSOLVENCY_INACTIVITY  DISSOLVED  Dissolved
Brendles ApS 738297771  RISK  RATING_CHANGED  Rating changed from A to B
Multicerv ApS 795312324  RISK  CREDITLIMIT_CHANGED  Recommended limit changed
Multicerv ApS 795312324  MANAGEMENT  MANAGEMENT_CHANGED  Managing director changed
Multicerv ApS 795312324  RISK  RATING_CHANGED  Rating changed from A to B
Multicerv ApS 795312324  RISK  RATING_CHANGED  Rating changed from B to A
Powerbod ApS 863638466  RISK  RATING_CHANGED  Rating changed from B to A
Powerbod ApS 863638466  RISK  RATING_CHANGED  Rating changed from A to B
Powerbod ApS 863638466  RISK  CREDITLIMIT_CHANGED  Recommended limit changed
Patterson-Fletcher A/S 991387035  RISK  CREDITLIMIT_CHANGED  Recommended limit changed
Patterson-Fletcher A/S 991387035  RISK  CREDITLIMIT_CHANGED  Recommended limit changed
Patterson-Fletcher A/S 991387035  RISK  RATING_CHANGED  Rating changed from A to AA
Norwegian Test objects
Name Registration Number Event Category Event Code Description
SVAR DIREKTE AS 937340303  BASIC_INFORMATION  NAME_CHANGED  Name changed
SVAR DIREKTE AS 937340303  RISK  CREDITLIMIT_CHANGED  Recommended limit changed
SVAR DIREKTE AS 937340303  RISK  RATING_CHANGED  Rating changed from A to B
TESTFORETAKET FOR ÆØÅ AS 911642190  INSOLVENCY_INACTIVITY  BANKRUPTCY_REQUEST  Proof of debt in bankruptcy
TESTFORETAKET FOR ÆØÅ AS 911642190  MANAGEMENT  BOARDMEMBER_CHANGED  Board of directors changed
TESTFORETAKET FOR ÆØÅ AS 911642190  RISK  RATING_CHANGED  Rating changed from B to A
TESTFORETAKET FOR ÆØÅ AS 911642190  RISK  RATING_CHANGED  Rating changed from C to B
TESTFORETAKET FOR ÆØÅ AS 911642190  RISK  CREDITLIMIT_CHANGED  Recommended limit changed
CREDIT CONTROL AS 918189254  RISK  CREDITLIMIT_CHANGED  Recommended limit changed
CREDIT CONTROL AS 918189254  BASIC_INFORMATION  NAME_CHANGED  Name changed
DIN SOLIDE ENTREPRENØR AS 935276608  REGISTRATION_STATUS  TRADEREGISTER_ADDED  Added to Trade register
DIN SOLIDE ENTREPRENØR AS 935276608  PAYMENT_ABILITY  PAYDEX_CHANGED  Payment index changed
DIN SOLIDE ENTREPRENØR AS 935276608  RISK  CREDITLIMIT_CHANGED  Recommended limit changed
DIN SOLIDE ENTREPRENØR AS 935276608  RISK  RATING_CHANGED  Rating changed from A to AA
SVAR DIREKTE PERSON 937400322  INSOLVENCY_INACTIVITY  BANKRUPTCY_KR  Bankruptcy petition by creditor
SVAR DIREKTE PERSON 937400322  RISK  CREDITLIMIT_CHANGED  Recommended limit changed
SVAR DIREKTE PERSON 937400322  RISK  RATING_CHANGED  Rating changed from B to A
SVAR DIREKTE PERSON 937400322  RISK  RATING_CHANGED  Rating changed from A to B
COBRA DEMO PERSON 812345672  BASIC_INFORMATION  POSTADDR_CHANGED  Postal address changed
COBRA DEMO PERSON 812345672  INSOLVENCY_INACTIVITY  DISSOLVED  Dissolved
COBRA DEMO PERSON 812345672  RISK  RATING_CHANGED  Rating changed from A to B
Soliditet Test 2 Ltd 927822334  RISK  CREDITLIMIT_CHANGED  Recommended limit changed
Soliditet Test 2 Ltd 927822334  MANAGEMENT  MANAGEMENT_CHANGED  Managing director changed
Soliditet Test 2 Ltd 927822334  RISK  RATING_CHANGED  Rating changed from A to B
Soliditet Test 2 Ltd 927822334  RISK  RATING_CHANGED  Rating changed from B to A
BARE SKRAP DA 842852102  RISK  RATING_CHANGED  Rating changed from B to A
BARE SKRAP DA 842852102  RISK  RATING_CHANGED  Rating changed from A to B
BARE SKRAP DA 842852102  RISK  CREDITLIMIT_CHANGED  Recommended limit changed
General Bureau of Atomic Energy 923313850  RISK  CREDITLIMIT_CHANGED  Recommended limit changed
General Bureau of Atomic Energy 923313850  RISK  CREDITLIMIT_CHANGED  Recommended limit changed
General Bureau of Atomic Energy 923313850  RISK  RATING_CHANGED  Rating changed from A to AA
HELT NYTT FORETAK AS 931024280  RISK  RATING_CHANGED  Rating changed from A to B
HELT NYTT FORETAK AS 931024280  RISK  RATING_CHANGED  Rating changed from B to A
HELT NYTT FORETAK AS 931024280  RISK  CREDITLIMIT_CHANGED  Recommended limit changed
HELT NYTT FORETAK AS 931024280  BASIC_INFORMATION  NAME_CHANGED  Name changed
Changes and versioning

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.