Creditsafe Connect

Creditsafe Connect

(0 reviews)

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)

Company SummaryCommon Data Dictionary

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 IdentificationCommon Data Dictionary
Contains information covering company identification, company areas of activity, name changes and dates and previous legal forms

Section available across all countries

Credit ScoreCommon Data Dictionary
Detailed credit score information including current and historical ratings and credit limits plus change dates

Section not available for Sweden (Sole Trader)

Contact InformationCommon Data Dictionary
Contains data on current and historical addresses and phone numbers, plus current email and homepage URL

Section available across all countries

Financial StatementsCommon Data Dictionary
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 / ManagersCommon Data Dictionary
Details of current and previous Directors and their tenancy at the named company

Section not available for Mexico, Sweden (sole trader)

Share Capital StructureCommon Data Dictionary
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 InformationCountry 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 StructureCommon Data Dictionary
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 InformationCommon Data Dictionary
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 InformationCountry 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

Requesting a DE Report / Invalid Custom Data

Due to legal reasons all report requests of German companies must be accompanied with a reason code. Those codes are required by DE report order calls to be passed as Custom Data entries.

Include the parameter

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)