Creditsafe Connect icon

Creditsafe Connect

(1 review)

Requesting a Company Report


Before you can request an Online Company Report you must have obtained the following:

  • A valid Authorization token
  • A Company's Connect ID
  • Access to Company Reports

Please see Getting Authenticated and Searching Companies for instructions on how to do this. If you are out of Company Reports, please speak to your Creditsafe Account Manager.

Report Data

A Company Report is a JSON collection of Business Information fields grouped into sections, such as Summary, Directors and Financials. A full list of data points can be found in the Data Dictionaries.

To order a Company Report, call GET on the /companies resource with your target company's Connect ID

Key: Authorization, Value: authToken
Key: Content-Type, Value: application/json

For a description of the Company Report order interface, please see the Connect API Interface RAML

GET \companies\{id}

Report Sections

Due to the nature of company information and local filing standards many companies will not have all report sections and fields. This can be due to a number of factors such as

  • Company does not have any information relevant to the section (Company has no negative data).
  • Data Partner does not provide this common section.
  • Legal restrictions (Cannot provide ratings on certain sole traders)
  • You are calling a Report with a Template (please see Templates for more information)

Requesting a DE Report / Invalid Custom Data

Due to legal reasons, all report requests of German companies must be accompanied with a 'Reason for Viewing'. To submit the required reason, you must pass the associated reason code (using the below table) with your report request. This is done by using a Parameter called "Custom Data"

Parameter Name: customData

Parameter Value: de_reason_code::{reason code}{version}/companies/{id}?customData=de_reason_code::{reasonCode}
Reason CodeDescription
1Credit Decisioning
2Credit Assessment - Future business connection (with credit risk)
3Credit Assessment - Existing business connection (with credit risk)
4Realisation check receivables collection
5Purchase Contract - Intention of signature of purchase contract (with credit risk)
6Goods Credit Insurance (with credit risk)
7Contract - Intention of signature of leasing or rent contract (with credit risk)
8Insurance Contract - Intention of signature of a insurance contract (with credit risk)

Company Summary

Contains summarised information that will provide the basic data required to make a decision on the credit worthiness of a company including credit rating

Section available across all countries

Company Identification

Contains information covering company identification, company areas of activity, name changes and dates and previous legal forms

Section available across all countries

Credit Score

Detailed credit score information including current and historical ratings and credit limits plus change dates

Section not available for Sweden (Sole Trader)

Contact Information

Contains data on current and historical addresses and phone numbers, plus current email and homepage URL

Section available across all countries

Financial Statements

Contains data for assets, inventories, receivables, liabilities and shareholder equity, there is also a sub section that refers to ratios

Section not available for Australia, Australia (Sole Trader), Brazil, Canada, Liechtenstein, Mexico, New Zealand, Sweden (sole trader), Switzerland, UK (Non Limited)

Negative Information

Country specific Data Dictionary

Information describing company activity described as negative, an example would be a UK CCJ

Section not available for Afghanistan, Cambodia, Colombia, Ecuador, Indonesia, Laos, Liechtenstein, Malaysia, Myanmar, New Zealand, PLC, Poland, Sweden (Sole Trader), Thailand, Venezuela, Vietnam

Directors / Managers

Details of current and previous Directors and their tenancy at the named company

Section not available for Mexico, Sweden (sole trader)

Share Capital Structure

Data on share capital and shareholders including percent owned

Section not available for Australia (Sole Trader), Canada, Luxemburg, Mexico, Sweden (sole trader), UK (Non Limited), USA

Payment Information

Country specific Data Dictionary

Data relating to payments made, timeliness and values

Section not available for Afghanistan, Albania, Armenia, Australia, Australia (sole trader), Austria, Azerbaijan, Bahrain, Bangladesh, Belarus, Benin, Bosnia, Brazil, Bulgaria, Burkina Faso, Cambodia, Canada, China, Colombia, Congo, Croatia, Czech Rep, Denmark, Ecuador, Egypt, Estonia, Finland, France, Georgia, Germany, Greece, Hong Kong, Hungary, Iceland, India, Indonesia, Ireland, Italy, Japan, Jordan, Kazakhstan, Kosovo, Kuwait, Kyrgyzstan, Laos, Latvia, Lebanon, Liechtenstein, Lithuania, Luxemburg, Macedonia, Malaysia, Malta, Mexico, Moldova, Montenegro, Myanmar, Nepal, New Zealand, Norway, Oman, Pakistan, Palestine, PLC, Poland, Portugal, Qatar, Romania, Russia, Saudi Arabia, Serbia, Singapore, Slovakia, Slovenia, South Korea, Spain, Sri Lanka, Sudan, Syria, Sweden, Sweden(sole trader), Switzerland, Taiwan, Tajikistan, Thailand, Turkey, Turkmenistan, UK, UK(Non Limited), Ukraine, United Arab Emirates, USA, Uzbekistan, Venezuela, Vietnam, Western Sahara, Yemen

Group Structure

Lists of the queried companies ultimate and immediate holding company plus subsidiaries and affiliated companies, including their country

Section not available for Australia, Australia (Sole Trader), Canada, Luxembourg, Mexico, Singapore, Sweden (Sole Trader), UK (Non Limited)

Other Information

Data concerning appointed Banks, Solicitors and Auditors. Also includes Employee number information

Section not available for Australia, Australia (Sole Trader), Luxemburg, New Zealand, Sweden (sole trader)

Additional Information

Country specific Data Dictionary

This section contains data that is country specific, see the Connect Data Dictionary in the resources section for further information

Section available across all countries