Creditsafe

This service provides methods to determine company credit ratings.

Summary
This service provides methods to determine company credit ratings.
Retrieve a detailed company report.
Search for a company.
Search for a company.
Retrieve a detailed company report.
Retrieve a detailed company report in PDF format.
Basic information about a company.
An Address.
Retrieves all possible search parameters combinations that can be used for a specific country in a creditsafeSearchV2 request
A combination of parameters that can be used together in a creditsafeSearchV2 request
A parameter to be used in a creditsafeSearchV2 request
A detailed report about a company.
A detailed report about a company in PDF format.
Class ShareCapital.
Information on a share holder.
Class TrusteeData.
Class CourtData.
Basic information about a company.
Information on a financial statement.
Information from the profit and loss statement.
Other financial information.
name - date_appointed -
Current and previous credit rating.
Basic information on a company.
Generic description.
An Address.
Information about the status of the company.
Class Commentary.
Miscellaneous information about German companies.
A generic value.
Add a company to the creditsafe update monitor.
Remove a company from the creditsafe update monitor.
Retrieve a list of updated companies for which you are subscribed in the monitor.
Basic information about a company.
A detailed report about a company.
Basic information about a company.
Key figures and information about a company.
Current and previous contact information and company data.
A value which has changed value at some point in time.
Current and previous credit rating.
Current and previous addresses.
Information on share capital and share holders.
Information on current and previous directors.
Information on bankers, advisors and the number of employees.
Information on how this company relates to related companies.
Basic information on a company.
Address and telephone number.
Id, name and country of a company
Information on a financial statement.
Activity code and description.
Address.
Information on a share holder.
Information on a director.
Information about a resigned director.
Information on a banker.
Information on auditors and solicitors.
Information about the number of employees in a given year.
Information from the profit and loss statement.
Information from the balance statement.
Other financial information.
Calculation results which give information on the financial situation of the company.
A reference to an updated creditsafe company.
Aside from general information, a report also contains country specific information.
Country specific additional information.
Additional information for a company in the Netherlands.
Negative information for a company in the Netherlands.
Court information for a company in the Netherlands.
Court facts information for a company in the Netherlands.
Bankruptcy receiver information for a company bankruptcy in the Netherlands.
Miscellaneous information for a company in the Netherlands.
Quartily information for a company.
Statistical spread for a specific number.
Payment expectation information for a company in the Netherlands.
Letters of Liability (403 Statements) for a company in the Netherlands.
A Letters of Liability (403 Statement) for a company in the Netherlands.
Additional information for a company in Belgium.
Negative information for a company in Belgium.
Details about a NSSO (National Social Security Office) labour court case against a company.
A protested bill.
A bankruptcy event
Miscellaneous information for a company in Belgium.
Payment expectation information for a company in Belgium.
Industry sector comparison for a company in Belgium.
Registered contractor for a company in Belgium.
An official event for a company in Belgium.
The parameters that can be used in creditsafeFindCompanies are different for each country.
3 search variants available, reports contain country specific information.
3 search variants available, reports contain country specific information.
3 search variants available.
3 search variants available.
3 search variants available.
3 search variants available.
3 search variants available.

Service methods

creditsafeGetReportFull

Retrieve a detailed company report.

Parameters

company_idCompany ID, as returned by creditsafeSearch.  Due to legal reasons all report requests of German companies (DE) must be accompanied with a reason code.  To specify a report request reason code, append one of the following codes onto the company_id (without quotes):
’|1’Credit Decisioning
’|2’Credit Assessment - Future business connection (with credit risk)
’|3’Credit Assessment - Existing business connection (with credit risk)
’|4’Realisation check receivables collection
’|5’Purchase Contract - Intention of signature of purchase contract (with credit risk)
’|6’Goods Credit Insurance (with credit risk)
’|7’Contract - Intention of signature of leasing or rent contract (with credit risk)
’|8’Insurance Contract - Intention of signature of a insurance contract (with credit risk)
languageISO 639-1 notation language that the report should be returned in, for example: “EN”.  Available languages for a company are returned by creditsafeSearch.
documentSpecify to retrieve an extra document with an excerpt of the data.  Currently unused.  Possible values:
[empty string]Return no extra document.

Returns

outA CreditsafeCompanyReportFull entry.

creditsafeSearch

Search for a company.

The parameters which can be used differ for each country.  The parameters that can be used are described in Country parameters.

Parameters

countryThe country to search in, An ISO 3166-1 alpha-2 country code, required
idSearch a single company, using the Creditsafe company identifier, optional
registration_numberSearch using a company registration number, optional
statusSearch using a company status.  See Country parameters for allowed values per country, optional
office_typeSearch using a company office type.  See Country parameters for allowed values per country, optional
nameSearch using a company name, optional
name_match_typeHow to match the text in the name parameter, the default match and possibles types are given in Country parameters for each country, optional
addressSearch using a company’s complete address, optional
address_match_typeHow to match the text in the address parameter, the default match type and possibles types are given in Country parameters for each country, optional
streetSearch using a company’s address street, optional
house_numberSearch using a company’s address house number, optional
citySearch using a company’s address city, optional
postal_codeSearch using a company’s address postal code, optional
provinceSearch using a company’s address province, optional
phone_numberSearch using a company’s phone number, optional
pagePage of search results to retrieve

Returns

outA Patterns::{Type}PagedResult of CreditsafeCompany entries.

creditsafeSearchV2

Search for a company.

The parameters which can be used differ for each country.  The parameters that can be used are described in Country parameters.

Parameters

countriesArray of countries to search in, An ISO 3166-1 alpha-2 country code, required
idSearch a single company, using the Creditsafe company identifier, optional
statusSearch using a company status.  See Country parameters for allowed values per country, optional
registration_numberSearch using a company registration number, optional
registration_typeSearch using a company registration type, optional
vat_numberSearch using a company vat number, optional
provinceSearch using a company’s address province, optional
citySearch using a company’s address city, optional
streetSearch using a company’s address street, optional
postal_codeSearch using a company’s address postal code, optional
nameSearch using a company name, optional

Returns

outA CreditsafeSearchResultV2.

creditsafeGetReportFullV2

Retrieve a detailed company report.

Parameters

company_idCompany ID, as returned by creditsafeSearchV2.
languageISO 639-1 notation language that the report should be returned in, for example: “EN”.
reasonDue to legal reasons all report requests of German companies (DE) must be accompanied with a reason code.  To specify a report request reason code, use one of the following (without quotes):
’1’Credit Decision
’2’Credit Assessment - Future business connection (with credit risk)
’3’Credit Assessment - Existing business connection (with credit risk)
’4’Realisation check receivables collection
’5’Purchase Contract - Intention of signature of purchase contract (with credit risk)
’6’Goods Credit Insurance (with credit risk)
’7’Contract - Intention of signature of leasing or rent contract (with credit risk)
’8’Insurance Contract - Intention of signature of a insurance contract (with credit risk)

Returns

outA CreditsafeCompanyReportFullV2 entry.

creditsafeGetReportFullPdfV2

Retrieve a detailed company report in PDF format.

Parameters

company_idCompany ID, as returned by creditsafeSearchV2.
languageISO 639-1 notation language that the report should be returned in, for example: “EN”.
reasonDue to legal reasons all report requests of German companies (DE) must be accompanied with a reason code.  To specify a report request reason code, use one of the following (without quotes):
’1’Credit Decision
’2’Credit Assessment - Future business connection (with credit risk)
’3’Credit Assessment - Existing business connection (with credit risk)
’4’Realisation check receivables collection
’5’Purchase Contract - Intention of signature of purchase contract (with credit risk)
’6’Goods Credit Insurance (with credit risk)
’7’Contract - Intention of signature of leasing or rent contract (with credit risk)
’8’Insurance Contract - Intention of signature of a insurance contract (with credit risk)

Returns

outA CreditsafeCompanyReportFullPdfV2 entry.

CreditsafeSearchResultV2

CreditsafeCompanyV2

Basic information about a company.

addressA CreditsafeAddressV2.
creditsafe_numberCredit
date_last_accountDate of last account
date_last_changeDate of last change
trade_namesTrading names.
vat_numbersVAT Numbers.
countryThe ISO 3166-1-alpha-2 country code of the company’s country.
registration_numberCompany registration number according to country’s Chambre of Commerce.
nameCompany name.
idCreditsafe company identifier used to retrieve a report.
typeCompany type information (Ltd, NonLtd etc.)
statusCompany status information (Active, Closed etc.).
office_typeCompany office type information (Headoffice etc.).

CreditsafeAddressV2

An Address.

cityAddress city.
countryAddress country.
full_addressFull address.
house_numberAddress house number.
postal_codeAddress postal code.
streetAddress street.
telephonePhone number.

creditsafeSearchCriteria

Retrieves all possible search parameters combinations that can be used for a specific country in a creditsafeSearchV2 request

Parameters

countriesArray of countries to get the combinations from.  An ISO 3166-1 alpha-2 country code, required

Returns

outA CreditsafeSearchCriteria.

CreditsafeSearchCriteria

countriesA list of countries searched for
languagesA list of languages supported by creditsafe for those countries
combinationsA Patterns::{Type}Array of CreditsafeSearchCriteriaCombination entries.

CreditsafeSearchCriteriaCombination

A combination of parameters that can be used together in a creditsafeSearchV2 request

paramsA Patterns::{Type}Array of CreditsafeSearchCriteriaParam entries.

CreditsafeSearchCriteriaParam

A parameter to be used in a creditsafeSearchV2 request

nameThe name of the parameter
min_lengthIf specified, the parameter needs to be a minimum of x length
max_lengthIf specified, the parameter needs to be a maximum of x length
validation_regexpIf specified, the parameter is going to be validated against this regular expression
allowed_valuesIf specified, the parameter can be only one of these values
is_requiredWhether the parameter is required in that combination

CreditsafeCompanyReportFullV2

A detailed report about a company.

additional_informationA CreditsafeCompanyAdditionalInformationV2.
company_identificationA CreditsafeCompanyIdentificationV2.
company_summaryA CreditsafeCompanySummaryV2.
contact_informationA CreditsafeCompanyContactInformationV2.
credit_scoreA CreditsafeCompanyCreditScoreV2.
directorsA CreditsafePersonDirectorsV2.
financial_statementsA Patterns::{Type}Array of CreditsafeCompanyFinancialStatementV2 entries.
group_structureA CreditsafeCompanyGroupStructureV2.
local_financial_statementsA Patterns::{Type}Array of CreditsafeCompanyFinancialStatementV2 entries.
negative_informationA CreditsafeCompanyNegativeInformationV2.
order_numberUnique Creditsafe identifier for this specific order request.
other_informationA CreditsafeCompanyOtherInformationV2.
share_capital_structureA CreditsafeCompanyShareCapitalStructureV2.
payment_dataA CreditsafeCompanyPaymentDataV2.
company_idCompany’s Id.
languageISO 639-1 notation language that the report is returned in.

CreditsafeCompanyReportFullPdfV2

A detailed report about a company in PDF format.

report_pdfBase64-encoded contents of the PDF report

CreditsafeCompanyPaymentDataV2

CreditsafeCompanyShareCapitalStructureV2

Class ShareCapital.

issued_share_capitalThis is the issued and paid share capital from shareholders.
nominal_share_capitalThe maximum amount of share capital the company is authorised by its constitutional documents to issue to shareholders.
share_holdersA Patterns::{Type}Array of CreditsafeCompanyShareHolderV2 entries.

CreditsafeCompanyShareHolderV2

Information on a share holder.

addressA CreditsafeAddressV2.
share_percentPercentage this share holder has in shares.
nameName of the share holder.

CreditsafeCompanyOtherInformationV2

CreditsafeCompanyEmployeeInformationV2

number_of_employeesNumber of staff that the company employ directly.
yearYear that the figures were reordered.

CreditsafeCompanyAdvisorV2

auditor_nameFull name of the company who is responsible for auditing.
solicitor_nameName of solicitors.

CreditsafeCompanyBankerV2

addressA CreditsafeAddressV2.
bank_codeBank code associated with the bank.
nameName of bank that the company holds an account with.

CreditsafeCompanyNegativeInformationDEDirectorEventV2

nameThe name of the entity (in the case of DE, the company director/members of the board of owners) that has the negative information against them.
typeA look up stating the type.  ‘P’ = Person.
dateThe date the negativeEvent occurred/is registered.
descriptionThe description of the negativeEvent that is raised against the entity.
codeThe code that corresponds to the event description.

CreditsafeCompanyNegativeInformationDEInsolvencyInformationV2

insolvency_eventsA Patterns::{Type}Array of CreditsafeCompanyNegativeInformationDEInsolvencyEventV2 entries.
dateof_insolvencyDate of insolvency application.
trusteeA CreditsafeCompanyNegativeInformationDETrusteeV2.

CreditsafeCompanyNegativeInformationDETrusteeV2

Class TrusteeData.

nameName of the trustee in charge of the insolvency.
titleTitle trustee.
first_nameFirst name trustee.
last_nameLast name trustee.
codeName and ZIP code of trustee.
cityCity where trustee is located.
telephone_numberPhone number trustee.
fax_numberFax number trustee.
email_addressEmail address of the trustee.

CreditsafeCompanyNegativeInformationDEInsolvencyEventV2

reference_number_courtFile number of the insolvency at the court.
created_atRecord creation time.

CreditsafeCompanyNegativeInformationDEBankruptcyV2

has_bankruptcyIndicates if there is bankruptcy information for the company.

CreditsafeCompanyNegativeInformationNLV2

CreditsafeCompanyNegativeInformationNLCourtItemV2

Class CourtData.

court_actionIndicates if there is a court action.
date_of_bankruptcyDate of company’s bankruptcy.
addressAddress of the receiver that deals with the bankruptcy of this company.

CreditsafeCompanyGroupStructureV2

ultimate_parentA CreditsafeCompanyCompanyV2.
immediate_parentA CreditsafeCompanyCompanyV2.
subsidiary_companiesA Patterns::{Type}Array of CreditsafeCompanyCompanyV2 entries.
affiliated_companiesA Patterns::{Type}Array of CreditsafeCompanyCompanyV2 entries.

CreditsafeCompanyCompanyV2

Basic information about a company.

addressA CreditsafeAddressV2.
creditsafe_numberCreditSafe number
date_last_accountDate of last account
date_last_changeDate of last change
trade_namesTrading names.
vat_numbersVAT Numbers.
countryThe ISO 3166-1-alpha-2 country code of the company’s country.
registration_numberCompany registration number according to country’s Chambre of Commerce, optional.
nameCompany name.
idCreditsafe company identifier used to retrieve a report.
typeCompany type information (Ltd, NonLtd etc.), optional.
statusCompany status information (Active, Closed etc.), optional.
office_typeCompany office type information (Headoffice etc.), optional.

CreditsafeCompanyFinancialStatementV2

Information on a financial statement.

balance_sheetA CreditsafeCompanyBalanceSheetV2.
consolidated_accountsAre the accounts consolidated.
currencyCurrency the figures are displayed in.
number_of_weeksNumber of weeks in the year.
other_financialsA CreditsafeCompanyOtherFinancialsV2.
profit_and_lossA CreditsafeCompanyProfitAndLossV2.
ratiosA CreditsafeCompanyRatiosV2.
typeThe type of financial statement.
year_end_dateYear to which the annual account relates to.

CreditsafeCompanyRatiosV2

creditor_daysTrade Creditors / Turnover x 365 days.  This is a calculation that predicts the average time taken for the company to settle its invoices for goods and services provided by it suppliers.
current_debt_ratioTotal Current Liabilities / Shareholders Funds.  This measures the amount of short term debt in relation to the value of shareholders funds.
current_ratioTotal Current Assets / Total Current Liabilities.  This is an indication of a company’s ability to meet short-term debt obligations; the higher the ratio, the more liquid the company is.
debtor_daysTrade Debtors / Turnover x 365 days.  This is a calculation that predicts the average time taken for the company to collect its invoices for goods and services provided to its customers.
equity_in_percentageShareholder Funds / (Total Current Assets + Tangible Fixed Assets) x 100.  This ratio shows the worth of the company (shareholders funds) as a percentage of total current and tangible assets. .
gearingBank Overdraft & Loans + Total Long Term Liabilities/Shareholders funds x 100.  This is the relationship between the size of the companies debt in proportion to Equity (Shareholders Funds).
liquidity_ratio_or_acid_testCurrent assets - Stocks/Current Liabilities.  This, like the current ratio, measures how quickly in the short term a company can meet its debts.  However, this ratio excludes stock as there is no guarantee the value of Stocks can be realised quickly.
pre_tax_profit_marginPre-tax profits / Turnover x 100.  This shows the percentage of Profit on each pound of sales or the equivalent of retailers ‘mark-up’.
return_on_capital_employedPre-Tax Profit / Capital Employed x 100.  This ratio measures the profits a business yields in return for the money (Capital) invested.
return_on_net_assets_employedPre-Tax Profits / Net Assets x 100.  This shows the ‘return’ in percent on the net assets of the company.  The higher the percentage the more profitable the company.
return_on_total_assets_employedPre-Tax Profits / Total Assets x 100.  This shows the ‘return’ or ‘profit’ on each pound of Assets used as a percentage.
sales_or_net_working_capitalTurnover / (Total Current Assets - Total Current Liabilities).  The higher the ratio the higher the volume of Sales made per the companies working capital.
stock_turnover_ratioStocks / Turnover x 100.  This shows the number of times the trading stock of a company is ‘turned over’ in a trading period.  If the ratio is low this indicates that relatively little money is tied up in Stocks.
total_debt_ratioTotal Short Term & Long Term Debt / Shareholder Funds x 100.  This shows the relative indebtedness of a company in relation to the worth of the company.

CreditsafeCompanyProfitAndLossV2

Information from the profit and loss statement.

depreciationThe amount written off Tangible Fixed Assets during the year.
dividendsThe total amount of profits distributed to shareholders.
financial_expensesInterest expenses incurred during the year.
financial_incomeInterest income earned during the year.
operating_costsCosts incurred in the general running of the business.
operating_profitThe results of the company after deducting Operating Costs from its Revenue.
other_appropriationsOther miscellaneous items that are deducted / added to affect the Retained Profit / Loss of a company.
pension_costsThe cost of pension benefits for employees of the company.
profit_after_taxThe results of the company after deducting any charge for taxation.
profit_before_taxThe results of the company before deducting any charge for taxation.
retained_profitThe results of the company after all income and expenses have been credited /debited.
revenueIncome earned from normal business activities, including the sale of goods and services.
taxTaxation payable on the profits of the company.
wages_and_salariesWages and salaries paid to employees of the company.

CreditsafeCompanyOtherFinancialsV2

Other financial information.

net_worthOften referred to as the ‘book value’ of the business this equals Shareholders Funds less Intangible Assets.
working_capitalTotal Current Assets less Total Current Liabilities.  This represents the surplus/deficit of funds from normal trading activities.

CreditsafeCompanyBalanceSheetV2

bank_liabilitiesAmount due within one year owing to banks for overdrafts and loans.
bank_liabilities_due_after1yearAmount due after one year owing to banks for overdrafts and loans.
called_up_share_capitalThe issued and paid share capital from shareholders.
cashCash at bank, cash in hand and cash equivalents.
consolidated_accountsAre the accounts consolidated.
finished_goodsGoods held that are ready for sale or use.
goodwillThe premium paid or accumulated on the purchase of an asset.
group_payablesAmounts due within one year to related businesses.
group_payables_due_after1yearAmounts due after one year to related businesses.
group_receivablesAmounts due within one year from related businesses.
investmentsLong term investments including shares and securities.
land_and_buildingsLand and buildings owned by the company for long term use.
loans_to_groupLong term loans made by the company to related businesses.
miscellaneous_fixed_assetsLong term assets other than Tangible Assets, Intangible Assets, Investments or Loans.
miscellaneous_liabilitiesOther amounts due within one year owing by the company.
miscellaneous_liabilities_due_after1_yearOther amounts due after one year owing by the company.
miscellaneous_receivablesAmounts due within one year owing to the company other than trade and group receivables.
other_current_assetsAny short term assets that have not already been included as Inventory, Receivables or Cash.
other_intangible_assetsIntangible fixed assets other than goodwill such as Trade Marks, Patents, Research & Development etc.
other_inventoriesOther amounts classed as Inventory but not included above.
other_loansOther long term loans made by the company.
other_loans_or_financeLoans or finance due within one year owing to parties other than banks or related businesses.
other_loans_or_finance_due_after1_yearLoans or finance due after one year owing to parties other than banks or related businesses.
other_reservesOther capital and reserves that form part of shareholders equity.
other_tangible_assetsTangible fixed assets other than Land & Buildings or Plant & Machinery.
plant_and_machineryPlant and machinery owned by the company for long term use.
raw_materialsMaterials held by the company that have not yet been processed.
receivables_due_after1yearAmounts due after one year owing to the company (including trade and group receivables due after one year).
revenue_reservesThe accumulation of profits/losses from previous trading periods.
share_premiumThe excess of the amount received on the issue of shares over their value.
total_assetsThe total of Current and Fixed Assets.
total_current_assetsThe total of Stocks, Debtors, Cash and other assets due within one year.
total_current_liabilitiesTotal short term liabilities of the company.
total_fixed_assetsThe total of Tangible and Intangible Assets.
total_intangible_assetsAssets that have a value but no physical existence.
total_inventoriesThe total of stocks held by the company and work in progress.
total_liabilitiesThe total of Total Long Term Liabilities and Total Current Liabilities.
total_long_term_liabilitiesTotal long term liabilities of the company.
total_other_fixed_assetsTotal long term assets other than Tangible Assets or Intangible Assets.
total_receivablesTotal amounts receivable by the company.
total_shareholders_equityThe total capital and reserves of the company.
total_tangible_assetsPhysical assets owned by the company for long term use.
trade_payablesAmount due within one year owing to suppliers for goods and services provided on credit.
trade_payables_due_after1yearAmount due after one year owing to suppliers for goods and services provided on credit.
trade_receivablesAmounts due within one year from customers for goods and services supplied on credit.
work_in_progressGoods or contracts that are in the process of manufacture or completion.

CreditsafePersonDirectorsV2

CreditsafePersonPreviousDirectorV2

resignation_dateThe date of resignation.
addressA CreditsafeAddressV2.
director_typeType of director (example Person or Company).
idDirector id.
positionsA Patterns::{Type}Array of CreditsafePersonPositionV2 entries.
nameThe director’s name.
date_of_birthThe director’s date of birth.
genderThe director’s gender.

CreditsafePersonDirectorV2

addressA CreditsafeAddressV2.
director_typeType of director (example Person or Company).
idDirector id.
positionsA Patterns::{Type}Array of CreditsafePersonPositionV2 entries.
nameThe director’s name.
date_of_birthThe director’s date of birth.
genderThe director’s gender.

CreditsafePersonPositionV2

name - date_appointed -

CreditsafeCompanyCreditScoreV2

Current and previous credit rating.

current_credit_ratingA CreditsafeCompanyCreditRatingV2.
previous_credit_ratingA CreditsafeCompanyCreditRatingV2.

CreditsafeCompanyContactInformationV2

main_addressA CreditsafeAddressV2.
other_addressesA Patterns::{Type}Array of CreditsafeAddressV2 entries.

CreditsafeCompanySummaryV2

company_statusA CreditsafeCompanyStatusV2.
credit_ratingA CreditsafeCompanyCreditRatingV2.
latest_shareholders_equity_figureThe total of Called up Share Capital, Revenue Reserves, Share Premium and Other Reserves.
latest_turnover_figureLatest value for the previous year’s Net Sales.
main_activityA CreditsafeCompanyActivityV2.
countryCountry where the company is registered.
numberNumber reserved for future use with the Creditsafe Global number.
company_registration_numberOfficial company registration number.
business_nameRegistered company name/trading name of the business.

CreditsafeCompanyCreditRatingV2

common_descriptionDescription of the credit score.
common_valueValue of the credit score.
credit_limitAmount of advisable credit.
provider_descriptionProvider description.
provider_valueA CreditsafeValueV2.

CreditsafeCompanyIdentificationV2

CreditsafeCompanyActivityClassificationV2

activitiesA Patterns::{Type}Array of CreditsafeCompanyActivityV2 entries.
classificationActivity classification.

CreditsafeCompanyActivityV2

classificationActivity classification.
activity_codeActivity code of the company, and is used to identify the sector.
activity_descriptionActivity description relating to the activity code.

CreditsafeCompanyBasicInformationV2

Basic information on a company.

company_statusA CreditsafeCompanyStatusV2.
contact_addressA CreditsafeAddressV2.
legal_formA CreditsafeDescriptionV2.
principal_activityA CreditsafeDescriptionV2.
business_nameThe trading name of business.
company_registration_numberOfficial registration number.
countryCountry where the company is registered.
dateof_company_registrationThe date the company was registered.
dateof_starting_operationsThe date the company began trading.
registered_company_nameRegistered company name.
vat_registration_numberLocal VAT Number.

CreditsafeDescriptionV2

Generic description.

codeDescription code.
descriptionDescription.
valueValue.

CreditsafeAddressV2

An Address.

cityAddress city.
countryAddress country.
full_addressFull address.
house_numberAddress house number.
postal_codeAddress postal code.
streetAddress street.
telephonePhone number.

CreditsafeCompanyStatusV2

Information about the status of the company.

descriptionThe description of the status.
statusThe status of the company.

CreditsafeCompanyKeyValueV2

keyAdditional information key.
valueAdditional information value.

CreditsafeCompanyAdditionalInformationNLLetterOfLiabilityInformation403V2

financial_yearDisplays the year of the 403 Statement.
company_nameDisplays the mother company’s name that has deposit the 403 Statement.
company_numberDisplays the mother company’s chamber of commerce number that has deposit the 403 Statement.
date_submittedShows when the 403 statement has been deposit by the mother company.
letter_of_liability1_start_dateShows the start date for this 403 statement.
letter_of_liability1_submitted_dateShows the submit date for this 403 statement.
letter_of_liability1_removal_submittedShows when the removal date for this 403 statement has been submitted.
letter_of_liability1_removal_dateShows the removal date for this 403 statement.
letter_of_liability2_start_dateShows the start date for this 403 statement.
letter_of_liability2_submitted_dateShows the submit date for this 403 statement.
letter_of_liability2_removal_submittedShows when the removal date for this 403 statement has been submitted.
letter_of_liability2_removal_dateShows the removal date for this 403 statement.
letter_of_liability1_start_date_parent2Shows the start date for this 403 statements of mother company 2.
letter_of_liability1_submitted_date_parent2Shows the submit date for this 403 statement of mother company 2.
letter_of_liability1_removal_submitted_parent2Shows when the removal date for this 403 statement has been submitted of mother company 2.
letter_of_liability1_removal_date_parent2Shows the removal date for this 403 statement of mother company 2.
letter_of_liability2_start_date_parent2Shows the start date for this 403 statements of mother company 2.
letter_of_liability2_submitted_date_parent2Shows the submit date for this 403 statement of mother company 2.
letter_of_liability2_removal_submitted_parent2Shows when the removal date for this 403 statement has been submitted of mother company 2.
letter_of_liability2_removal_date_parent2Shows the removal date for this 403 statement of mother company 2.

CreditsafeCompanyAdditionalInformationNLKvkFilingV2

dateThe date of the KVK filing.
eventA description of the KVK filing.

CreditsafeCompanyAdditionalInformationNLFinancialItemV2

date_year_endThe end date of the financial period that the accounts relate to.
judgementThe auditing judgement (have the accounts been approved?).
consolidated_subsidiariesThe number of consolidated subsidiaries.

CreditsafeCompanyAdditionalInformationNLIndustryQuartileAnalysisV2

CreditsafeCompanyAdditionalInformationNLIndustryQuartileAnalysisDayV2

lowerThe lower value for the company ranked 1/4 divided by industry code.
medianThe middle value of the estimated number of days taken to pay the business.
upperThe higher value for the company ranked 3/4 divided by industry code.

CreditsafeCompanyAdditionalInformationNLIndustryComparisonV2

industry_average_credit_ratingThe average credit rating for the company’s activity code.
industry_average_credit_limitThe average credit limit for the company’s activity code.

CreditsafeCompanyAdditionalInformationNLMiscellaneousV2

date_of_legal_formThe date the company changed its legal form.
date_of_cessation_tradingDate when the company has stopped trading.
exporterIndicates if a company exports into foreign countries.
importerIndicates if a company imports from foreign countries.
rsin_numberThe Legal Entities and Partnerships Information Number.
branch_numberThe branch number.
negative_ratingThe negative credit rating if it exists for a company.

CreditsafeCompanyAdditionalInformationNLPaymentExpectationsSummaryV2

suspension_of_payments_moraIndicates if the company has a suspensions of payments.
payment_expectation_daysThe estimated number of days until payment from the business.
day_sales_outstandingThe estimated number of days taken to pay the business.
industry_average_payment_expectation_daysThis is the guideline expectations, based upon our analysis, as to this company’s payment behaviour.
industry_average_day_sales_outstandingThe number of days it takes this company to collect their debts.

CreditsafeCompanyAdditionalInformationHistoricalEventV2

dateThe date of the event.
descriptionA description of the event.
previous_valueThe previous value before the event.
current_valueThe current value after the event.

CreditsafeCompanyAdditionalInformationCommentV2

Class Commentary.

textThe commentary text shows different trends within the business which have changed.
sentimentThis shows an arrow indicating if the trend has improved or decreased etc.

CreditsafeCompanyAdditionalInformationDETurnoverRangeV2

yearTurnover year.
rangeTurnover range.

CreditsafeCompanyAdditionalInformationDEOwnerV2

nameOwner Name.
cityOwner city.
postal_codeOwner postal code.
countryOwner country.
share_percentThe percentage of shares owned.

CreditsafeCompanyAdditionalInformationDEImageAccountV2

serial_numberThe identification number of the image document.
start_dateFinancial statement date start.
end_dateFinancial statement date end.
published_dateFinancial statement date published at German „Bundesanzeiger”.
document_typeThe document type.
financials_typeThe financials type.  Is one of: 0 = Individual, 1 = Consolidated.

CreditsafeCompanyAdditionalInformationDEMiscellaneousV2

Miscellaneous information about German companies.

turnover_rangeA banding that gives an estimation of the company’s turnover.
commercial_register_cityThe city in which the company is registered.
commercial_register_zipThe postal code in which the company is registered.
financials_qualityThe quality standard of the accounts data.
current_ratingA CreditsafeValueV2.
previous_ratingA CreditsafeValueV2.
premise_typeThe type of premises this business is run from for example house or office ect.
small_office(Small office/Home Company) This signifies if a business is trading from a consumers address.  0 = No, 1 = Yes, NULL = no data available.
fax_numberThe Fax number of the business.
company_typeThis indicates if the company is a branch or headquarter.
negative_ratingThe negative credit rating if it exists for a company.
complementary_companyDetails the complementary company.
business_purposeA text description of the companies business purpose in German language.

CreditsafeValueV2

A generic value.

max_valueMax value.
min_valueMin value.
valueValue.

Update Monitor

creditsafeMonitorAddCompany

Add a company to the creditsafe update monitor.  Updates regarding the given company identifier will now be tracked by the monitor.  The list of of updated companies can be retrieved using creditsafeMonitorGetUpdatedCompanies.  To remove a company identifier from the monitor use creditsafeMonitorRemoveCompany.

Parameters

company_idCompany ID, as returned by creditsafeSearch.

Returns

Nothing

creditsafeMonitorRemoveCompany

Remove a company from the creditsafe update monitor.  Updates regarding the given company identifier will not be tracked by the monitor anymore.  To add a company to the monitor again use creditsafeMonitorAddCompany.  Or, when the monitor auto-add feature is enabled for your account (by default).it will be added automatically when invoking creditsafeGetReportFull.

Parameters

company_idCompany ID, as returned by creditsafeSearch.

Returns

Nothing

creditsafeMonitorGetUpdatedCompanies

Retrieve a list of updated companies for which you are subscribed in the monitor.  Every company in the list can be retrieved using creditsafeGetReportFull

Parameters

changed_sinceDate in yyyy-mm-dd format.  Return only companies that have changed on or after this date.  Defaults to 30 days ago.  [optional]
pageThe page of updated company references to retrieve.  [optional]

Returns

outA Patterns::{Type}PagedResult of CreditsafeCompanyUpdate

Type definitions

CreditsafeCompany

Basic information about a company.

nameCompany name.
registration_numberCompany registration number according to country’s Chambre of Commerce, optional.
typeCompany type information (Ltd, NonLtd etc.), optional.
statusCompany status information (Active, Closed etc.), optional.
office_typeCompany office type information (Headoffice etc.), optional.
addressCompany full address, optional.
available_report_typesList of report types that are available for ordering for this company.  Possible Values:
BasicBasic credit report.  Currently not in use.
FullComplete credit report.  Use creditsafeGetReportFull to retrieve the record, if online_reports is set to true.
available_languagesList of languages (in ISO 639-1 notation) that reports are available in for this company.
idCreditsafe company identifier used to retrieve a report.
countryThe ISO 3166-1-alpha-2 country code of the company’s country.
online_reportsWhether available reports can be retrieved online.  creditsafeGetReportFull will not return a report if this value is false.

CreditsafeCompanyReportFull

A detailed report about a company.

company_idCompany’s Id string.
order_numberUnique Creditsafe identifier for this specific order request.
languageISO 639-1 notation language that the report is returned in.
company_summaryA CreditsafeLtdCompanySummary
company_identificationA CreditsafeLtdCompanyIdentification
credit_scoreA CreditsafeLtdCreditScore
contact_informationA CreditsafeLtdContactInformation
share_capital_structureA CreditsafeLtdShareCapitalStructure
directorsA CreditsafeLtdDirectors
other_informationA CreditsafeLtdOtherInformation
group_structureA CreditsafeLtdGroupStructure.  Optional.
financial_statementsA Patterns::{Type}Array of CreditsafeLtdFinancialStatement entries.
additional_informationA CreditsafeAdditionalInformation, see Country specific additional information.  Optional.
documentA base64 encoded document file, optional.  Contents determined by the ‘document’ parameter of creditsafeGetReportFull.

CreditsafeCompanyV2

Basic information about a company.

nameCompany name.
registration_numberCompany registration number according to country’s Chambre of Commerce, optional.
typeCompany type information (Ltd, NonLtd etc.), optional.
statusCompany status information (Active, Closed etc.), optional.
office_typeCompany office type information (Headoffice etc.), optional.
addressCompany full address, optional.
available_report_typesList of report types that are available for ordering for this company.  Possible Values:
BasicBasic credit report.  Currently not in use.
FullComplete credit report.  Use creditsafeGetReportFull to retrieve the record, if online_reports is set to true.
available_languagesList of languages (in ISO 639-1 notation) that reports are available in for this company.
idCreditsafe company identifier used to retrieve a report.
countryThe ISO 3166-1-alpha-2 country code of the company’s country.
online_reportsWhether available reports can be retrieved online.  creditsafeGetReportFull will not return a report if this value is false.

CreditsafeLtdCompanySummary

Key figures and information about a company.

business_nameRegistered company name/trading name of the business.
countryCountry where the company is registered.
numberNumber reserved for future use with the Creditsafe Global number.  Optional.
company_registration_numberOfficial company registration number.  Optional.
main_activityA CreditsafeCompanyActivity with description of the main company activity.  Optional.
company_statusCompany status, E.g.  Trading, Non Trading, Dissolved, Liquidation etc.  Optional.
latest_turnover_figureLatest value for the previous year’s Net Sales.  Optional.
latest_shareholders_equity_figureThe total of Called up Share Capital, Revenue Reserves, Share Premium and Other Reserves.  Optional.
credit_ratingCredit score used by the supplier in that particular country.
credit_limitAmount of credit advisable at any one time.
rating_descriptionDescription of the credit score.  Optional.

CreditsafeLtdCompanyIdentification

Current and previous contact information and company data.

basic_informationA CreditsafeLtdCompanyBasicInformation
activitiesA Patterns::{Type}Array of CreditsafeCompanyActivity entries.  Optional.
previous_namesA Patterns::{Type}Array of CreditsafeChangedString entries.  Any previous name under which the company was registered.  Optional.
previous_legal_formsA Patterns::{Type}Array of CreditsafeChangedString entries.  The previous legal type of the company e.g.  S.A., GmbH, Ltd, N.V. etc.  Optional.

CreditsafeChangedString

A value which has changed value at some point in time.

valueValue as of date_changed.
date_changedDate the value was changed to the given value.  Optional.

CreditsafeLtdCreditScore

Current and previous credit rating.

current_credit_ratingCredit score used by the supplier in that particular country.
current_rating_descriptionDescription of the credit score.  Optional.
current_credit_limitAmount of credit advisable at any one time.
current_contract_limitA yardstick for the maximum contract capacity on a single contract over a 12-month period.  This measurement views the applicant as a supplier of goods and services whereas a credit limit assesses the applicant as a purchaser.  Optional.
previous_credit_limitPrevious limit before it was last changed.  Optional.
previous_credit_ratingPrevious rating before it was last changed.  Optional.
previous_rating_descriptionDescription of the previous rating.  Optional.
date_of_latest_rating_changeLast date that the credit rating changed.  Optional.

CreditsafeLtdContactInformation

Current and previous addresses.

main_addressA CreditsafeStreetAddressWithTelephone, containing the registered address of the company
other_addressesA Patterns::{Type}Array of CreditsafeStreetAddressWithTelephone entries, containing other trading address of the company, optional
previous_addressesA Patterns::{Type}Array of CreditsafeStreetAddress entries, containing previous addresses where the company was officially registered, optional
email_addressesEmail addresses for the company, optional
websitesWebsite addresses of the company, optional

CreditsafeLtdShareCapitalStructure

Information on share capital and share holders.

nominal_share_capitalThe maximum amount of share capital the company is authorised by its constitutional documents to issue to shareholders.  Optional.
issued_share_capitalThis is the issued and paid share capital from shareholders.  Optional.
share_holdersA Patterns::{Type}Array of CreditsafeShareHolder entries.  Optional.

CreditsafeLtdDirectors

Information on current and previous directors.

current_directorsA Patterns::{Type}Array of CreditsafeDirector entries, optional.
previous_directorsA Patterns::{Type}Array of CreditsafePreviousDirector entries, optional.

CreditsafeLtdOtherInformation

Information on bankers, advisors and the number of employees.

bankersA Patterns::{Type}Array of CreditsafeBanker entries, optional.  Name of bank that the company holds an account with.
advisorsA Patterns::{Type}Array of CreditsafeAdvisor entries, optional.
employees_informationA Patterns::{Type}Array of CreditsafeEmployeeInformation entries, optional

CreditsafeLtdGroupStructure

Information on how this company relates to related companies.

ultimate_parentA CreditsafeCompanyListEntry.  Full company name of Ultimate Holding Company.  Optional.
immediate_parentA CreditsafeCompanyListEntry.  Full company name of Immediate Holding Company.  Optional.
subsidiary_companiesA Patterns::{Type}Array of CreditsafeCompanyListEntry entries.  Full company name of subsidiary.  Optional.
affiliated_companiesA Patterns::{Type}Array of CreditsafeCompanyListEntry entries.  Full company name of Affiliate.  Optional.

CreditsafeLtdCompanyBasicInformation

Basic information on a company.

business_nameThe trading name of business.
registered_company_nameRegistered company name.
company_registration_numberOfficial registration number.  Optional.
countryCountry where the company is registered
vat_registration_numberLocal VAT Number.  Optional.
vat_registration_dateRegistration date of the local VAT number.  Optional.
dateof_company_registrationThe date the company was registered.  Optional.
dateof_starting_operationsThe date the company began trading.  Optional.
commercial_courtThe local commercial court the company was registered at.  Optional.
legal_formThe legal type of the company e.g.  S.A., GmbH, Ltd, N.V. etc.  Optional.
typeof_ownershipWhether the company is wholly, part owned etc.  Optional.
company_statusE.g.  Active, Non Trading, Dissolved, Liquidation etc.  Optional.
report_currencyLocal currency that all figures are report in inc credit limit
principal_activityA CreditsafeCompanyActivity.  Description of companies main activity.  Optional.
contact_addressRegistered address of the company
contact_telephone_numberRegistered telephone number.  Optional.

CreditsafeStreetAddressWithTelephone

Address and telephone number.

addressRegistered address of the company
countryCountry the address is in.  Optional.
telephoneRegistered telephone number.  Optional.

CreditsafeCompanyListEntry

Id, name and country of a company

countryThe country the company is located.  Optional.
company_nameThe name of the company.
company_idCompany Id, can be used to get a report in creditsafeGetReportFull.  Optional.
numberNumber reserved for future use with the Creditsafe Global number.  Optional.

CreditsafeLtdFinancialStatement

Information on a financial statement.

profit_and_lossA CreditsafeProfitAndLossFigures.  Optional.
balance_sheetA CreditsafeBalanceSheet.  Optional.
other_financialsA CreditsafeOtherFinancials.  Optional.
ratiosA CreditsafeFinancialRatios.  Optional.

CreditsafeCompanyActivity

Activity code and description.

activity_codeSIC/NACE Industry activity code
activity_descriptionDescription of activity

CreditsafeStreetAddress

Address.

addressAddress.
countryCountry.  Optional.

CreditsafeShareHolder

Information on a share holder.

nameName of the share holder.
addressAddress of the share holder.  Optional.
share_percentPercentage this share holder has in shares.  Optional.

CreditsafeDirector

Information on a director.

nameFull name of director.
addressAddress of the director.  Optional.
genderMale or Female.  Optional.
appointment_dateDate of appointment.  Optional.
date_of_birthDate of birth.  Optional.
positionPosition within the company.  Optional.

CreditsafePreviousDirector

Information about a resigned director.

directorA CreditsafeDirector.
resignation_dateDate the director resigned.  Optional.

CreditsafeBanker

Information on a banker.

nameName of bank that the company holds an account with
addressAddress where the bank is registered.  Optional.
bank_codeBank code associated with the bank.  Optional.

CreditsafeAdvisor

Information on auditors and solicitors.

auditor_nameFull name of the company who is responsible for auditing.  Optional.
solicitor_nameName of solicitors.  Optional.

CreditsafeEmployeeInformation

Information about the number of employees in a given year.

yearYear that the figures were reordered
number_of_employeesNumber of staff that the company employ directly

CreditsafeProfitAndLossFigures

Information from the profit and loss statement.

year_end_dateYear to which the annual accounts relate to
number_of_weeksNumber of weeks in the year
currencyCurrency the figures are displayed in
consolidated_accountsAre the accounts consolidated.  Optional.
revenueIncome earned from normal business activities, including the sale of goods and services.  Optional.
operating_costsCosts incurred in the general running of the business.  Optional.
operating_profitThe results of the company after deducting Operating Costs from its Revenue.  Optional.
wages_and_salariesWages and salaries paid to employees of the company.  Optional.
pension_costsThe cost of pension benefits for employees of the company.  Optional.
depreciationThe amount written off Tangible Fixed Assets during the year.  Optional.
amortisationThe amount written off Intangible Fixed Assets during the year.  Optional.
financial_incomeInterest income earned during the year.  Optional.
financial_expensesInterest expenses incurred during the year.  Optional.
extraordinary_incomeIncome arising due to events of a non-recurring nature.  Optional.
extraordinary_costsCosts incurred due to events of a non-recurring nature.  Optional.
profit_before_taxThe results of the company before deducting any charge for taxation.  Optional.
taxTaxation payable on the profits of the company.  Optional.
profit_after_taxThe results of the company after deducting any charge for taxation.  Optional.
dividendsThe total amount of profits distributed to shareholders.  Optional.
minority_interestsProfits attributable to shareholders holding a minority interest in the company.  Optional.
other_appropriationsOther miscellaneous items that are deducted / added to affect the Retained Profit / Loss of a company.  Optional.
retained_profitThe results of the company after all income and expenses have been credited /debited.  Optional.

CreditsafeBalanceSheet

Information from the balance statement.

year_end_dateYear to which the annual accounts relate to
number_of_weeksNumber of weeks in the year
currencyCurrency the figures are displayed in
consolidated_accountsAre the accounts consolidated - Y = Yes, N = No.  Optional.
land_and_buildingsLand and buildings owned by the company for long term use.  Optional.
plant_and_machineryPlant and machinery owned by the company for long term use.  Optional.
other_tangible_assetsTangible fixed assets other than Land & Buildings or Plant & Machinery.  Optional.
total_tangible_assetsPhysical assets owned by the company for long term use.  Optional.
goodwillThe premium paid or accumulated on the purchase of an asset.  Optional.
other_intangible_assetsIntangible fixed assets other than goodwill such as Trade Marks, Patents, Research & Development etc.  Optional.
total_intangible_assetsAssets that have a value but no physical existence.  Optional.
investmentsLong term investments including shares and securities.  Optional.
loans_to_groupLong term loans made by the company to related businesses.  Optional.
other_loansOther long term loans made by the company.  Optional.
miscellaneous_fixed_assetsLong term assets other than Tangible Assets, Intangible Assets, Investments or Loans.  Optional.
total_other_fixed_assetsTotal long term assets other than Tangible Assets or Intangible Assets.  Optional.
total_fixed_assetsThe total of Tangible and Intangible Assets
raw_materialsMaterials held by the company that have not yet been processed.  Optional.
work_in_progressGoods or contracts that are in the process of manufacture or completion.  Optional.
finished_goodsGoods held that are ready for sale or use.  Optional.
other_inventoriesOther amounts classed as Inventory but not included above.  Optional.
total_inventoriesThe total of stocks held by the company and work in progress.  Optional.
trade_receivablesAmounts due within one year from customers for goods and services supplied on credit.  Optional.
group_receivablesAmounts due within one year from related businesses.  Optional.
receivables_due_after1yearAmounts due after one year owing to the company (including trade and group receivables due after one year)
miscellaneous_receivablesAmounts due within one year owing to the company other than trade and group receivables.  Optional.
total_receivablesTotal amounts receivable by the company.  Optional.
cashCash at bank, cash in hand and cash equivalents.  Optional.
other_current_assetsAny short term assets that have not already been included as Inventory, Receivables or Cash.  Optional.
total_current_assetsThe total of Stocks, Debtors, Cash and other assets due within one year.  Optional.
total_assetsThe total of Current and Fixed Assets.  Optional.
trade_payablesAmount due within one year owing to suppliers for goods and services provided on credit.  Optional.
bank_liabilitiesAmount due within one year owing to banks for overdrafts and loans.  Optional.
other_loans_or_financeLoans or finance due within one year owing to parties other than banks or related businesses.  Optional.
group_payablesAmounts due within one year to related businesses.  Optional.
miscellaneous_liabilitiesOther amounts due within one year owing by the company.  Optional.
total_current_liabilitiesTotal short term liabilities of the company.  Optional.
trade_payables_due_after1yearAmount due after one year owing to suppliers for goods and services provided on credit.  Optional.
bank_liabilities_due_after1yearAmount due after one year owing to banks for overdrafts and loans.  Optional.
other_loans_or_finance_due_after1yearLoans or finance due after one year owing to parties other than banks or related businesses.  Optional.
group_payables_due_after1yearAmounts due after one year to related businesses.  Optional.
miscellaneous_liabilities_due_after1yearOther amounts due after one year owing by the company.  Optional.
total_long_term_liabilitiesTotal long term liabilities of the company.  Optional.
total_liabilitiesThe total of Total Long Term Liabilities and Total Current Liabilities.  Optional.
called_up_share_capitalThe issued and paid share capital from shareholders.  Optional.
share_premiumThe excess of the amount received on the issue of shares over their value.  Optional.
revenue_reservesThe accumulation of profits/losses from previous trading periods.  Optional.
other_reservesOther capital and reserves that form part of shareholders equity.  Optional.
total_shareholders_equityThe total capital and reserves of the company.  Optional.

CreditsafeOtherFinancials

Other financial information.

contingent_liabilitiesPotential liabilities that are not recognised in the balance sheet.  Optional.
working_capitalTotal Current Assets less Total Current Liabilities.  This represents the surplus/deficit of funds from normal trading activities.  Optional.
net_worthOften referred to as the ‘book value’ of the business this equals Shareholders Funds less Intangible Assets.  Optional.

CreditsafeFinancialRatios

Calculation results which give information on the financial situation of the company.

pre_tax_profit_marginPre-tax profits / Turnover x 100.  This shows the percentage of Profit on each pound of sales or the equivalent of retailers ‘mark-up’.  Optional.
return_on_capital_employedPre-Tax Profit / Capital Employed x 100.  This ratio measures the profits a business yields in return for the money (Capital) invested.  Optional.
return_on_total_assets_employedPre-Tax Profits / Total Assets x 100.  This shows the ‘return’ or ‘profit’ on each pound of Assets used as a percentage.  Optional.
return_on_net_assets_employedPre-Tax Profits / Net Assets x 100.  This shows the ‘return’ in percent on the net assets of the company.  The higher the percentage the more profitable the company.  Optional.
sales_or_net_working_capitalTurnover / (Total Current Assets - Total Current Liabilities).  The higher the ratio the higher the volume of Sales made per the companies working capital.  Optional.
stock_turnover_ratioStocks / Turnover x 100.  This shows the number of times the trading stock of a company is ‘turned over’ in a trading period.  If the ratio is low this indicates that relatively little money is tied up in Stocks.  Optional.
debtor_daysTrade Debtors / Turnover x 365 days.  This is a calculation that predicts the average time taken for the company to collect its invoices for goods and services provided to its customers.  Optional.
creditor_daysTrade Creditors / Turnover x 365 days.  This is a calculation that predicts the average time taken for the company to settle its invoices for goods and services provided by it suppliers.  Optional.
current_ratioTotal Current Assets / Total Current Liabilities.  This is an indication of a company’s ability to meet short-term debt obligations; the higher the ratio, the more liquid the company is.  Optional.
liquidity_ratio_or_acid_testCurrent assets - Stocks/Current Liabilities.  This, like the current ratio, measures how quickly in the short term a company can meet its debts.  However, this ratio excludes stock as there is no guarantee the value of Stocks can be realised quickly.  Optional.
current_debt_ratioTotal Current Liabilities / Shareholders Funds.  This measures the amount of short term debt in relation to the value of shareholders funds.  Optional.
gearingBank Overdraft & Loans + Total Long Term Liabilities/Shareholders funds x 100.  This is the relationship between the size of the companies debt in proportion to Equity (Shareholders Funds).  Optional.
equity_in_percentageShareholder Funds / (Total Current Assets + Tangible Fixed Assets) x 100.  This ratio shows the worth of the company (shareholders funds) as a percentage of total current and tangible assets.  Optional.
total_debt_ratioTotal Short Term & Long Term Debt / Shareholder Funds x 100.  This shows the relative indebtedness of a company in relation to the worth of the company.  Optional.

CreditsafeCompanyUpdate

A reference to an updated creditsafe company.

company_idCompany Id, can be used to get a report in creditsafeGetReportFull.
changesA list of changes that occurred for the company.
date_last_updateDate when the last change has occurred for the company

Country specific additional information

Aside from general information, a report also contains country specific information.  This information includes, but is not limited to, negative information such as bankruptcies, payment information and other miscellaneous data such as fax numbers.

CreditsafeAdditionalInformation

Country specific additional information.  Only one of the following elements will be set, depending on the country of the requested company.

nlCreditsafeNlAdditionalInformation, set for companies in the Netherlands.  Optional.
beCreditsafeBeAdditionalInformation, set for companies in Belgium.  Optional.

CreditsafeNlAdditionalInformation

Additional information for a company in the Netherlands.

negative_informationA CreditsafeNlNegativeInformation.  Optional.
miscA CreditsafeNlMisc.
industry_quartile_analysisA CreditsafeIndustryQuartilyAnalysis.
payment_expectations_summaryA CreditsafeNlPaymentExpectationsSummary.
letters_of_liability_information_403A CreditsafeNlLettersOfLiabilityInformation403.  Optional.

CreditsafeNlNegativeInformation

Negative information for a company in the Netherlands.

court_dataA CreditsafeNlCourtData.  Optional.

CreditsafeNlCourtData

Court information for a company in the Netherlands.

factsA CreditsafeNlCourtDataFacts.
receiver_detailsA CreditsafeNlCourtDataReceiver.  Optional.

CreditsafeNlCourtDataFacts

Court facts information for a company in the Netherlands.

court_actionIndicates if there is a court action.
date_of_bankruptcyDate of company’s bankruptcy
detailsThe verdict from the bankruptcy court

CreditsafeNlCourtDataReceiver

Bankruptcy receiver information for a company bankruptcy in the Netherlands.

nameName of the receiver that deals with the bankruptcy of this company.
addressAddress of the receiver that deals with the bankruptcy of this company.

CreditsafeNlMisc

Miscellaneous information for a company in the Netherlands.

ceased_trading_dateDate of when the company has stopped trading.  Optional
exporterIndicates if a company exports into foreign countries
importerIndicates if a company imports from foreign countries

CreditsafeIndustryQuartilyAnalysis

Quartily information for a company.

payment_expectation_daysA CreditsafeQuartiles for the number of days until payment.
day_sales_outstandingA CreditsafeQuartiles for the number of outstanding day sales.

CreditsafeQuartiles

Statistical spread for a specific number.

lowerLower quartile.  25th percentile.
medianMedian.  50th percentile.
upperUpper quartile.  75th percentile.

CreditsafeNlPaymentExpectationsSummary

Payment expectation information for a company in the Netherlands.

suspension_of_payments_moraIndicates if the company has a Suspensions of Payments.  Optional.
payment_expectation_daysThe estimated number of days until payment from the business.  Optional.
day_sales_outstandingThe estimated number of days taken to pay the business.  Optional.
industry_average_payment_expectation_daysThe estimated industry average number of days until payment.
industry_average_day_sales_outstandingThe estimated industry average number of days taken to pay.

CreditsafeNlLettersOfLiabilityInformation403

Letters of Liability (403 Statements) for a company in the Netherlands.

financial_yearYear the letters are valid for.
company_nameName of the company that has filed the letter.
company_numberRegistration number for the company that has filed the letter.
date_submittedDate of submission
letters_of_liabilityA Patterns::{Type}Array of CreditsafeNlLettersOfLiability entries.
letters_of_liability_2nd_parentA Patterns::{Type}Array of CreditsafeNlLettersOfLiability entries.  Used in the rare case that a second parent company has also filed a letter.  Optional.

CreditsafeNlLettersOfLiability

A Letters of Liability (403 Statement) for a company in the Netherlands.

start_dateThe start date for this 403 statement.
submitted_dateThe submit date for this 403 statement, optional.
removal_submitted_dateThe removal submit date for this 403 statement, optional.
removal_dateThe removal date for this 403 statement, optional.

CreditsafeBeAdditionalInformation

Additional information for a company in Belgium.

negative_informationA CreditsafeBeNegativeInformation.  Optional.
miscA CreditsafeBeMisc.  Optional.
industry_quartile_analysisA CreditsafeIndustryQuartilyAnalysis.  Optional.
payment_expectations_summaryA CreditsafeBePaymentExpectationsSummary.  Optional.
industry_comparisonA CreditsafeBeIndustryComparison.  Optional.
registered_contractorsA Patterns::{Type}Array of CreditsafeBeRegisteredContractor entries.  Optional.
eventsA Patterns::{Type}Array of CreditsafeBeEvent entries.  Optional.

CreditsafeBeNegativeInformation

Negative information for a company in Belgium.

nsso_detailsA Patterns::{Type}Array of CreditsafeBeNSSODetail entries.  Optional.
protested_billsA Patterns::{Type}Array of CreditsafeBeProtestedBill entries.  Optional.
bankruptcy_eventsA Patterns::{Type}Array of CreditsafeBeBankruptcyEvent entries.  Optional.

CreditsafeBeNSSODetail

Details about a NSSO (National Social Security Office) labour court case against a company.

business_numberRegistered number of the business.
name_of_defendantThe business name of the defendant.
legal_form_of_defendantThe description of the legal form of the business.
date_of_summonsThe date the case was brought against the business.
labour_courtThe court where the case was brought against the business.

CreditsafeBeProtestedBill

A protested bill.

drawee_nameThe name of the business the bill is against.
drawee_addressThe address of the business the bill is against.
bill_amountThe amount of the bill brought against the business.
bill_currencyThe currency of the Bill Amount.
maturity_of_bill_in_monthsThe time since the bill was brought against the business.
payment_dateThe date the bill was settled.
name_of_drawerThe name of the business that issued the bill.
city_of_drawerThe city of Drawer.

CreditsafeBeBankruptcyEvent

A bankruptcy event

bankruptcy_typeThe type of bankruptcy proceeding including bankruptcy, withdrawal, closing.
company_nameThe name of the business the bankruptcy is brought against.
street_of_registered_officeThe street of the registered office of the bankrupt company.
city_of_registered_officeThe city of the registered office of the bankrupt company.
postcode_of_registered_officeThe postcode of the registered office of the bankrupt company.
nace_bel_codeThe industry code of the bankrupt company.
nace_bel_descriptionThe industry description of the bankrupt company.
commercial_courtThe court where the bankruptcy was brought against the company.
source_dateThe date the bankruptcy was received.
sourceThe source of the bankruptcy data.
date_of_decreee_of_bankruptcyThe date of the bankruptcy ruling.
closing_date_of_summonsThe closing date of the bankruptcy.
name_of_trusteeThe name of the trustee (manager) of the bankrupt business.
street_of_trusteeThe street of the trustee.
city_of_trusteeThe city of the trustee.
postcode_of_trusteeThe postcode of the trustee.

CreditsafeBeMisc

Miscellaneous information for a company in Belgium.

fax_numberFax number of the company.  Optional

CreditsafeBePaymentExpectationsSummary

Payment expectation information for a company in Belgium.

payment_expectation_daysThe estimated number of days until payment from the business.
day_sales_outstandingThe estimated number of days taken to pay the business.

CreditsafeBeIndustryComparison

Industry sector comparison for a company in Belgium.

activity_codeActivity code of the company, and is used to identify the sector.
activity_descriptionActivity description relating to the activity code.
industry_average_payment_expectation_daysThe estimated industry average number of days until payment for companies in this sector.
industry_average_day_sales_outstandingThe estimated industry average number of days taken to pay for companies in this sector.
industry_average_credit_ratingThe estimated industry average credit rating for companies in this sector.

CreditsafeBeRegisteredContractor

Registered contractor for a company in Belgium.

registration_numberContractor registration number.
contractor_descriptionDescription of the registered activity.
striking_off_dateDate the business was removed from the register.  Optional.

CreditsafeBeEvent

An official event for a company in Belgium.

serial_numberThe serial number of the event.
descriptionA description of the event.

Country parameters

The parameters that can be used in creditsafeFindCompanies are different for each country.  For each country there are several search options.  For example, in the Netherlands you can search companies on identifier, registration number and office type, or on name and address.  Supplying any of the other fields will result in an error.

Netherlands (NL)

3 search variants available, reports contain country specific information.

Find companies using unique Creditsafe ID

idCreditSafe identification number.  20 characters, regular expression ‘^(NL)\d{3}/(X)/(\d{12}|\d{8})$’.

Find companies using registration number

countryAn ISO 3166-1 alpha-2 country code.  Value must be ‘NL’ (Netherlands).
registration_numberCounty specific registration code.  8 characters, regular expression ‘\d{8}’.
office_typeType of company.  Optional.  One of the following:
HeadOfficeCompany is a head office.
BranchCompany is a branch office.

Find companies using name, address and/or phone number

countryAn ISO 3166-1 alpha-2 country code.  Value must be ‘NL’ (Netherlands).
office_typeType of company.  Optional.  One of the following:
HeadOfficeCompany is a head office.
BranchCompany is a branch office.
nameName of the company.  Minimum length 2, optional.
name_match_typeHow to match the text in the name parameter.  Optional, defaults to ‘MatchBlockOrWords’.  One of the following:
MatchBeginningMatches exact first chararcters of the string.
MatchBlockOrWordsMatches either a block of text anywhere in the string or whole words (order insensitive).
MatchWordsMatches whole words (order insensitive).
streetAddress street name.  Optional.
house_numberAddress house number.  Optional.
cityAddress city name.  Optional.
postal_codeAddress postal code.  Optional.
phone_numberCompany phone number.  Optional.

Belgium (BE)

3 search variants available, reports contain country specific information.

Find companies using unique Creditsafe ID

idCreditSafe identification number.  17 characters, regular expression ‘^(BE)\d{3}/(X)/\d{9}$’.

Find companies using registration number

countryAn ISO 3166-1 alpha-2 country code.  Value must be ‘BE’ (Belgium).
registration_numberCounty specific registration code.  9 characters, regular expression ‘\d{9}’.

Find companies using name, address and/or phone number

countryAn ISO 3166-1 alpha-2 country code.  Value must be ‘BE’ (Belgium).
nameName of the company.  Minimum length 2, optional.
name_match_typeHow to match the text in the name parameter.  Optional, defaults to ‘MatchBlockOrWords’.  One of the following:
MatchBeginningMatches exact first chararcters of the string.
MatchBlockOrWordsMatches either a block of text anywhere in the string or whole words (order insensitive).
MatchWordsMatches whole words (order insensitive).
streetAddress street name.  Optional.
house_numberAddress house number.  Optional.
cityAddress city name.  Optional.
postal_codeAddress postal code.  Optional.
phone_numberCompany phone number.  Optional.

France (FR)

3 search variants available.

Find companies using unique Creditsafe ID

idCreditSafe identification number.  17 to 22 characters, regular expression ‘^(FR)\d{3}/(X)/(\d{9}|\d{14})$’.

Find companies using registration number

countryAn ISO 3166-1 alpha-2 country code.  Value must be ‘FR’ (France).
registration_numberCounty specific registration code.  9 to 14 characters, regular expression ‘(\d{9}|\d{14})’.
statusStatus of the company.  Optional.  One of the following:
ActiveCompany is active.
NonActiveCompany is non-active.
PendingNegative information is found.
OtherSpecific notification is mentioned.
Active, NonActiveCompany is either active or non-active.
office_typeType of company.  Optional.  One of the following:
HeadOfficeCompany is a head office.
BranchCompany is a branch office.

Find companies using name, address and/or phone number

countryAn ISO 3166-1 alpha-2 country code.  Value must be ‘FR’ (France).
statusStatus of the company.  Optional.  One of the following:
ActiveCompany is active.
NonActiveCompany is non-active.
PendingNegative information is found.
OtherSpecific notification is mentioned.
Active, NonActiveCompany is either active or non-active.
office_typeType of company.  Optional.  One of the following:
HeadOfficeCompany is a head office.
BranchCompany is a branch office.
nameName of the company.  Minimum length 2, optional.
name_match_typeHow to match the text in the name parameter.  Optional, defaults to ‘ClosestKeywords’.  One of the following:
MatchBeginningMatches exact first chararcters of the string.
ClosestKeywordsMatches whole words as well as similar words.
ExactValueMatches the whole text.
addressFreeform address input.  Minimum length 2, optional.
address_match_typeHow to match the text in the address parameter.  Optional, defaults to ‘MatchBlock’.  One of the following:
MatchBlockMatchBlock.
postal_codeAddress postal code.  Optional.
phone_numberCompany phone number.  Optional.

United Kingdom (GB)

3 search variants available.

Find companies using unique Creditsafe ID

idCreditSafe identification number.  Minimum length 8, regular expression ‘^(GB)\d{3}/(0|1)/.+$’.

Find companies using registration number

countryAn ISO 3166-1 alpha-2 country code.  Value must be ‘GB’ (United Kingdom).
registration_numberCounty specific registration code.  Minimum length 2.

Find companies using name, address and/or phone number

countryAn ISO 3166-1 alpha-2 country code.  Value must be ‘GB’ (United Kingdom).
statusStatus of the company.  Optional.  One of the following:
ActiveCompany is active.
NonActiveCompany is non-active.
PendingNegative information is found.
OtherSpecific notification is mentioned.
Active, NonActiveCompany is either active or non-active.
nameName of the company.  Minimum length 2, optional.
name_match_typeHow to match the text in the name parameter.  Optional, defaults to ‘MatchBlockOrWords’.  One of the following:
MatchBeginningMatches exact first chararcters of the string.
MatchBlockOrWordsMatches either a block of text anywhere in the string or whole words (order insensitive).
ExactValueMatches the whole text.
streetAddress street name.  Optional.
cityAddress city name.  Optional.
postal_codeAddress postal code.  Optional.
phone_numberCompany phone number.  Optional.

Ireland (IE)

3 search variants available.

Find companies using unique Creditsafe ID

idCreditSafe identification number.  Minimum length 8, regular expression ‘^(IE)\d{3}/(0)/.+$’.

Find companies using registration number

countryAn ISO 3166-1 alpha-2 country code.  Value must be ‘IE’ (Ireland).
registration_numberCounty specific registration code.  Minimum length 2.

Find companies using name, address and/or phone number

countryAn ISO 3166-1 alpha-2 country code.  Value must be ‘IE’ (Ireland).
statusStatus of the company.  Optional.  One of the following:
ActiveCompany is active.
NonActiveCompany is non-active.
PendingNegative information is found.
OtherSpecific notification is mentioned.
Active, NonActiveCompany is either active or non-active.
nameName of the company.  Minimum length 2, optional.
name_match_typeHow to match the text in the name parameter.  Optional, defaults to ‘MatchWords’.  One of the following:
MatchBeginningMatches exact first chararcters of the string.
MatchBlockMatches a block of text anywhere in the string.
MatchWordsMatches whole words (order insensitive).
addressFreeform address input.  Minimum length 2, optional.
address_match_typeHow to match the text in the address parameter.  Optional, defaults to ‘MatchBlockOrWords’.  One of the following:
MatchBeginningMatchBeginning.
MatchBlockOrWordsMatchBlockOrWords.
MatchWordsMatchWords.
postal_codeAddress postal code.  Optional.

Germany (DE)

3 search variants available.

Find companies using unique Creditsafe ID

idCreditSafe identification number.  Minimum length 14, regular expression ‘^(DE)\d{3}/(0|1)/DE\d{8}$’.

Find companies using registration number and/or address

countryAn ISO 3166-1 alpha-2 country code.  Value must be ‘DE’ (Germany).
registration_numberCounty specific registration code.  Minimum length 4.
cityAddress city name.  Optional.

Find companies using name, address and/or phone number

countryAn ISO 3166-1 alpha-2 country code.  Value must be ‘DE’ (Germany).
statusStatus of the company.  Optional.  One of the following:
ActiveCompany is active.
NonActiveCompany is non-active.
PendingNegative information is found.
OtherSpecific notification is mentioned.
Active, NonActiveCompany is either active or non-active.
nameName of the company.  Minimum length 2, optional.
name_match_typeHow to match the text in the name parameter.  Optional, defaults to ‘MatchWords’.  One of the following:
MatchBeginningMatches exact first chararcters of the string.
MatchBlockMatches a block of text anywhere in the string.
ExactValueMatches the whole text.
MatchWordsMatches whole words (order insensitive).
streetAddress street name.  Optional.
cityAddress city name.  Optional.
postal_codeAddress postal code.  Optional.
phone_numberCompany phone number.  Optional.

Sweden (SE)

3 search variants available.

Find companies using unique Creditsafe ID

idCreditSafe identification number.  18 to 20 characters, regular expression ‘^(SE)\d{3}/(0|1)/\d{10,12}$’.

Find companies using registration number

countryAn ISO 3166-1 alpha-2 country code.  Value must be ‘SE’ (Sweden).
registration_numberCounty specific registration code.  10 to 12 characters, regular expression ‘\d{10,12}’.

Find companies using name, address and/or phone number

countryAn ISO 3166-1 alpha-2 country code.  Value must be ‘SE’ (Sweden).
statusStatus of the company.  Optional.  One of the following:
ActiveCompany is active.
NonActiveCompany is non-active.
PendingNegative information is found.
OtherSpecific notification is mentioned.
Active, NonActiveCompany is either active or non-active.
nameName of the company.  Minimum length 3, optional.
name_match_typeHow to match the text in the name parameter.  Optional, defaults to ‘MatchBlockOrWords’.  One of the following:
MatchBlockOrWordsMatches either a block of text anywhere in the string or whole words (order insensitive).
ClosestKeywordsEach query word is matched with a set of keywords describing each company and a set of closest matches is returned
streetAddress street name.  Minimum length 3, optional.
cityAddress city name.  Minimum length 3, optional.
postal_codeAddress postal code.  Minimum length 5, optional.
phone_numberCompany phone number.  Minimum length 3, optional.
Search for a company.
Search for a company.
A detailed report about a company.
The parameters that can be used in creditsafeFindCompanies are different for each country.
A structure that shows a page of a specific result type {Type}.
Basic information about a company.
A detailed report about a company.
A detailed report about a company in PDF format.
An array of type {Type} entries.
Basic information about a company.
An Address.
A combination of parameters that can be used together in a creditsafeSearchV2 request
A parameter to be used in a creditsafeSearchV2 request
Current and previous credit rating.
Information on a financial statement.
Class ShareCapital.
Information on a share holder.
Class TrusteeData.
Class CourtData.
Basic information about a company.
Other financial information.
Information from the profit and loss statement.
name - date_appointed -
Information about the status of the company.
A generic value.
Basic information on a company.
Generic description.
Class Commentary.
Miscellaneous information about German companies.
Retrieve a list of updated companies for which you are subscribed in the monitor.
Remove a company from the creditsafe update monitor.
Add a company to the creditsafe update monitor.
Retrieve a detailed company report.
A reference to an updated creditsafe company.
Key figures and information about a company.
Current and previous contact information and company data.
Current and previous credit rating.
Current and previous addresses.
Information on share capital and share holders.
Information on current and previous directors.
Information on bankers, advisors and the number of employees.
Information on how this company relates to related companies.
Information on a financial statement.
Country specific additional information.
Aside from general information, a report also contains country specific information.
Activity code and description.
Basic information on a company.
A value which has changed value at some point in time.
Address and telephone number.
Address.
Information on a share holder.
Information on a director.
Information about a resigned director.
Information on a banker.
Information on auditors and solicitors.
Information about the number of employees in a given year.
Id, name and country of a company
Information from the profit and loss statement.
Information from the balance statement.
Other financial information.
Calculation results which give information on the financial situation of the company.
Additional information for a company in the Netherlands.
Additional information for a company in Belgium.
Negative information for a company in the Netherlands.
Miscellaneous information for a company in the Netherlands.
Quartily information for a company.
Payment expectation information for a company in the Netherlands.
Letters of Liability (403 Statements) for a company in the Netherlands.
Court information for a company in the Netherlands.
Court facts information for a company in the Netherlands.
Bankruptcy receiver information for a company bankruptcy in the Netherlands.
Statistical spread for a specific number.
A Letters of Liability (403 Statement) for a company in the Netherlands.
Negative information for a company in Belgium.
Miscellaneous information for a company in Belgium.
Payment expectation information for a company in Belgium.
Industry sector comparison for a company in Belgium.
Registered contractor for a company in Belgium.
An official event for a company in Belgium.
Details about a NSSO (National Social Security Office) labour court case against a company.
A protested bill.
A bankruptcy event