CreditsafeThis service provides methods to determine company credit ratings. Summary | This service provides methods to determine company credit ratings. | | | | Retrieve a detailed company report. | | | | | | Basic information about a company. | | A detailed report 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. | | | | Information on a share holder. | | Information on a director. | | Information about a resigned director. | | | | 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. | | 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. | | | | | | 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. |
creditsafeGetReportFullRetrieve a detailed company report. Parameters| company_id | Company 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 inquiry | | ’|2’ | Business Relationship | | ’|3’ | Solvency Check | | ’|4’ | Claim | | ’|5’ | Contract | | ’|6’ | Commercial Credit Insurance |
| | language | ISO 639-1 notation language that the report should be returned in, for example: “EN”. Available languages for a company are returned by creditsafeSearch. | | document | Specify to retrieve an extra document with an excerpt of the data. Currently unused. Possible values:| [empty string] | Return no extra document. |
|
ReturnscreditsafeSearchSearch 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| country | The country to search in, An ISO 3166-1 alpha-2 country code, optional | | id | Search a single company, using the Creditsafe company identifier, optional | | registration_number | Search using a company registration number, optional | | status | Search using a company status. See Country parameters for allowed values per country, optional | | office_type | Search using a company office type. See Country parameters for allowed values per country, optional | | name | Search using a company name, optional | | name_match_type | How to match the text in the name parameter, the default match and possibles types are given in Country parameters for each country, optional | | address | Search using a company’s complete address, optional | | address_match_type | How to match the text in the address parameter, the default match type and possibles types are given in Country parameters for each country, optional | | street | Search using a company’s address street, optional | | house_number | Search using a company’s address house number, optional | | city | Search using a company’s address city, optional | | postal_code | Search using a company’s address postal code, optional | | province | Search using a company’s address province, optional | | phone_number | Search using a company’s phone number, optional | | page | Page of search results to retrieve |
ReturnsCreditsafeCompanyBasic information about a company. | name | Company name. | | registration_number | Company registration number according to country’s Chambre of Commerce, optional. | | type | Company type information (Ltd, NonLtd etc.), optional. | | status | Company status information (Active, Closed etc.), optional. | | office_type | Company office type information (Headoffice etc.), optional. | | address | Company full address, optional. | | available_report_types | List of report types that are available for ordering for this company. Possible Values:| Basic | Basic credit report. Currently not in use. | | Full | Complete credit report. Use creditsafeGetReportFull to retrieve the record, if online_reports is set to true. |
| | available_languages | List of languages (in ISO 639-1 notation) that reports are available in for this company. | | id | Creditsafe company identifier used to retrieve a report. | | country | The ISO 3166-1-alpha-2 country code of the company’s country. | | online_reports | Whether available reports can be retrieved online. creditsafeGetReportFull will not return a report if this value is false. |
CreditsafeCompanyReportFullA detailed report about a company. CreditsafeLtdCompanySummaryKey figures and information about a company. | business_name | Registered company name/trading name of the business. | | country | Country where the company is registered. | | number | Number reserved for future use with the Creditsafe Global number. Optional. | | company_registration_number | Official company registration number. Optional. | | main_activity | A CreditsafeCompanyActivity with description of the main company activity. Optional. | | company_status | Company status, E.g. Trading, Non Trading, Dissolved, Liquidation etc. Optional. | | latest_turnover_figure | Latest value for the previous year’s Net Sales. Optional. | | latest_shareholders_equity_figure | The total of Called up Share Capital, Revenue Reserves, Share Premium and Other Reserves. Optional. | | credit_rating | Credit score used by the supplier in that particular country. | | credit_limit | Amount of credit advisable at any one time. | | rating_description | Description of the credit score. Optional. |
CreditsafeLtdCompanyIdentificationCurrent and previous contact information and company data. CreditsafeChangedStringA value which has changed value at some point in time. | value | Value as of date_changed. | | date_changed | Date the value was changed to the given value. Optional. |
CreditsafeLtdCreditScoreCurrent and previous credit rating. | current_credit_rating | Credit score used by the supplier in that particular country. | | current_rating_description | Description of the credit score. Optional. | | current_credit_limit | Amount of credit advisable at any one time. | | current_contract_limit | A 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_limit | Previous limit before it was last changed. Optional. | | previous_credit_rating | Previous rating before it was last changed. Optional. | | previous_rating_description | Description of the previous rating. Optional. | | date_of_latest_rating_change | Last date that the credit rating changed. Optional. |
CreditsafeLtdContactInformationCurrent and previous addresses. CreditsafeLtdShareCapitalStructureInformation on share capital and share holders. | nominal_share_capital | The maximum amount of share capital the company is authorised by its constitutional documents to issue to shareholders. Optional. | | issued_share_capital | This is the issued and paid share capital from shareholders. Optional. | | share_holders | A Patterns::{Type}Array of CreditsafeShareHolder entries. Optional. |
CreditsafeLtdDirectorsInformation on current and previous directors. CreditsafeLtdOtherInformationInformation on bankers, advisors and the number of employees. CreditsafeLtdGroupStructureInformation on how this company relates to related companies. CreditsafeLtdCompanyBasicInformationBasic information on a company. | business_name | The trading name of business. | | registered_company_name | Registered company name. | | company_registration_number | Official registration number. Optional. | | country | Country where the company is registered | | vat_registration_number | Local VAT Number. Optional. | | vat_registration_date | Registration date of the local VAT number. Optional. | | dateof_company_registration | The date the company was registered. Optional. | | dateof_starting_operations | The date the company began trading. Optional. | | commercial_court | The local commercial court the company was registered at. Optional. | | legal_form | The legal type of the company e.g. S.A., GmbH, Ltd, N.V. etc. Optional. | | typeof_ownership | Whether the company is wholly, part owned etc. Optional. | | company_status | E.g. Active, Non Trading, Dissolved, Liquidation etc. Optional. | | report_currency | Local currency that all figures are report in inc credit limit | | principal_activity | A CreditsafeCompanyActivity. Description of companies main activity. Optional. | | contact_address | Registered address of the company | | contact_telephone_number | Registered telephone number. Optional. |
CreditsafeStreetAddressWithTelephoneAddress and telephone number. | address | Registered address of the company | | country | Country the address is in. Optional. | | telephone | Registered telephone number. Optional. |
CreditsafeCompanyListEntryId, name and country of a company | country | The country the company is located. Optional. | | company_name | The name of the company. | | company_id | Company Id, can be used to get a report in creditsafeGetReportFull. Optional. | | number | Number reserved for future use with the Creditsafe Global number. Optional. |
CreditsafeLtdFinancialStatementInformation on a financial statement. CreditsafeCompanyActivityActivity code and description. | activity_code | SIC/NACE Industry activity code | | activity_description | Description of activity |
CreditsafeStreetAddressAddress. | address | Address. | | country | Country. Optional. |
CreditsafeShareHolderInformation on a share holder. | name | Name of the share holder. | | address | Address of the share holder. Optional. | | share_percent | Percentage this share holder has in shares. Optional. |
CreditsafeDirectorInformation on a director. | name | Full name of director. | | address | Address of the director. Optional. | | gender | Male or Female. Optional. | | appointment_date | Date of appointment. Optional. | | date_of_birth | Date of birth. Optional. | | position | Position within the company. Optional. |
CreditsafePreviousDirectorInformation about a resigned director. CreditsafeBankerInformation on a banker. | name | Name of bank that the company holds an account with | | address | Address where the bank is registered. Optional. | | bank_code | Bank code associated with the bank. Optional. |
CreditsafeAdvisorInformation on auditors and solicitors. | auditor_name | Full name of the company who is responsible for auditing. Optional. | | solicitor_name | Name of solicitors. Optional. |
CreditsafeEmployeeInformationInformation about the number of employees in a given year. | year | Year that the figures were reordered | | number_of_employees | Number of staff that the company employ directly |
CreditsafeProfitAndLossFiguresInformation from the profit and loss statement. | year_end_date | Year to which the annual accounts relate to | | number_of_weeks | Number of weeks in the year | | currency | Currency the figures are displayed in | | consolidated_accounts | Are the accounts consolidated. Optional. | | revenue | Income earned from normal business activities, including the sale of goods and services. Optional. | | operating_costs | Costs incurred in the general running of the business. Optional. | | operating_profit | The results of the company after deducting Operating Costs from its Revenue. Optional. | | wages_and_salaries | Wages and salaries paid to employees of the company. Optional. | | pension_costs | The cost of pension benefits for employees of the company. Optional. | | depreciation | The amount written off Tangible Fixed Assets during the year. Optional. | | amortisation | The amount written off Intangible Fixed Assets during the year. Optional. | | financial_income | Interest income earned during the year. Optional. | | financial_expenses | Interest expenses incurred during the year. Optional. | | extraordinary_income | Income arising due to events of a non-recurring nature. Optional. | | extraordinary_costs | Costs incurred due to events of a non-recurring nature. Optional. | | profit_before_tax | The results of the company before deducting any charge for taxation. Optional. | | tax | Taxation payable on the profits of the company. Optional. | | profit_after_tax | The results of the company after deducting any charge for taxation. Optional. | | dividends | The total amount of profits distributed to shareholders. Optional. | | minority_interests | Profits attributable to shareholders holding a minority interest in the company. Optional. | | other_appropriations | Other miscellaneous items that are deducted / added to affect the Retained Profit / Loss of a company. Optional. | | retained_profit | The results of the company after all income and expenses have been credited /debited. Optional. |
CreditsafeBalanceSheetInformation from the balance statement. | year_end_date | Year to which the annual accounts relate to | | number_of_weeks | Number of weeks in the year | | currency | Currency the figures are displayed in | | consolidated_accounts | Are the accounts consolidated - Y = Yes, N = No. Optional. | | land_and_buildings | Land and buildings owned by the company for long term use. Optional. | | plant_and_machinery | Plant and machinery owned by the company for long term use. Optional. | | other_tangible_assets | Tangible fixed assets other than Land & Buildings or Plant & Machinery. Optional. | | total_tangible_assets | Physical assets owned by the company for long term use. Optional. | | goodwill | The premium paid or accumulated on the purchase of an asset. Optional. | | other_intangible_assets | Intangible fixed assets other than goodwill such as Trade Marks, Patents, Research & Development etc. Optional. | | total_intangible_assets | Assets that have a value but no physical existence. Optional. | | investments | Long term investments including shares and securities. Optional. | | loans_to_group | Long term loans made by the company to related businesses. Optional. | | other_loans | Other long term loans made by the company. Optional. | | miscellaneous_fixed_assets | Long term assets other than Tangible Assets, Intangible Assets, Investments or Loans. Optional. | | total_other_fixed_assets | Total long term assets other than Tangible Assets or Intangible Assets. Optional. | | total_fixed_assets | The total of Tangible and Intangible Assets | | raw_materials | Materials held by the company that have not yet been processed. Optional. | | work_in_progress | Goods or contracts that are in the process of manufacture or completion. Optional. | | finished_goods | Goods held that are ready for sale or use. Optional. | | other_inventories | Other amounts classed as Inventory but not included above. Optional. | | total_inventories | The total of stocks held by the company and work in progress. Optional. | | trade_receivables | Amounts due within one year from customers for goods and services supplied on credit. Optional. | | group_receivables | Amounts due within one year from related businesses. Optional. | | receivables_due_after1year | Amounts due after one year owing to the company (including trade and group receivables due after one year) | | miscellaneous_receivables | Amounts due within one year owing to the company other than trade and group receivables. Optional. | | total_receivables | Total amounts receivable by the company. Optional. | | cash | Cash at bank, cash in hand and cash equivalents. Optional. | | other_current_assets | Any short term assets that have not already been included as Inventory, Receivables or Cash. Optional. | | total_current_assets | The total of Stocks, Debtors, Cash and other assets due within one year. Optional. | | total_assets | The total of Current and Fixed Assets. Optional. | | trade_payables | Amount due within one year owing to suppliers for goods and services provided on credit. Optional. | | bank_liabilities | Amount due within one year owing to banks for overdrafts and loans. Optional. | | other_loans_or_finance | Loans or finance due within one year owing to parties other than banks or related businesses. Optional. | | group_payables | Amounts due within one year to related businesses. Optional. | | miscellaneous_liabilities | Other amounts due within one year owing by the company. Optional. | | total_current_liabilities | Total short term liabilities of the company. Optional. | | trade_payables_due_after1year | Amount due after one year owing to suppliers for goods and services provided on credit. Optional. | | bank_liabilities_due_after1year | Amount due after one year owing to banks for overdrafts and loans. Optional. | | other_loans_or_finance_due_after1year | Loans or finance due after one year owing to parties other than banks or related businesses. Optional. | | group_payables_due_after1year | Amounts due after one year to related businesses. Optional. | | miscellaneous_liabilities_due_after1year | Other amounts due after one year owing by the company. Optional. | | total_long_term_liabilities | Total long term liabilities of the company. Optional. | | total_liabilities | The total of Total Long Term Liabilities and Total Current Liabilities. Optional. | | called_up_share_capital | The issued and paid share capital from shareholders. Optional. | | share_premium | The excess of the amount received on the issue of shares over their value. Optional. | | revenue_reserves | The accumulation of profits/losses from previous trading periods. Optional. | | other_reserves | Other capital and reserves that form part of shareholders equity. Optional. | | total_shareholders_equity | The total capital and reserves of the company. Optional. |
CreditsafeOtherFinancialsOther financial information. | contingent_liabilities | Potential liabilities that are not recognised in the balance sheet. Optional. | | working_capital | Total Current Assets less Total Current Liabilities. This represents the surplus/deficit of funds from normal trading activities. Optional. | | net_worth | Often referred to as the ‘book value’ of the business this equals Shareholders Funds less Intangible Assets. Optional. |
CreditsafeFinancialRatiosCalculation results which give information on the financial situation of the company. | pre_tax_profit_margin | Pre-tax profits / Turnover x 100. This shows the percentage of Profit in each pound of sales or the equivalent of retailers ‘mark-up’. Optional. | | return_on_capital_employed | Pre-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_employed | Pre-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_employed | Pre-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_capital | Turnover / (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_ratio | Stocks / 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_days | Trade 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_days | Trade 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_ratio | Total 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_test | Current 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_ratio | Total Current Liabilities / Shareholders Funds. This measures the amount of short term debt in relation to the value of shareholders funds. Optional. | | gearing | Bank 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_percentage | Shareholder 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_ratio | Total 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. |
Country specific additional informationAside 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. CreditsafeAdditionalInformationCountry specific additional information. Only one of the following elements will be set, depending on the country of the requested company. CreditsafeNlAdditionalInformationAdditional information for a company in the Netherlands. CreditsafeNlNegativeInformationNegative information for a company in the Netherlands. CreditsafeNlCourtDataCourt information for a company in the Netherlands. CreditsafeNlCourtDataFactsCourt facts information for a company in the Netherlands. | court_action | Indicates if there is a court action. | | date_of_bankruptcy | Date of company’s bankruptcy | | details | The verdict from the bankruptcy court |
CreditsafeNlCourtDataReceiverBankruptcy receiver information for a company bankruptcy in the Netherlands. | name | Name of the receiver that deals with the bankruptcy of this company. | | address | Address of the receiver that deals with the bankruptcy of this company. |
CreditsafeNlMiscMiscellaneous information for a company in the Netherlands. | ceased_trading_date | Date of when the company has stopped trading. Optional | | exporter | Indicates if a company exports into foreign countries | | importer | Indicates if a company imports from foreign countries |
CreditsafeIndustryQuartilyAnalysisQuartily information for a company. CreditsafeQuartilesStatistical spread for a specific number. | lower | Lower quartile. 25th percentile. | | median | Median. 50th percentile. | | upper | Upper quartile. 75th percentile. |
CreditsafeNlPaymentExpectationsSummaryPayment expectation information for a company in the Netherlands. | suspension_of_payments_mora | Indicates if the company has a Suspensions of Payments. Optional. | | payment_expectation_days | The estimated number of days until payment from the business. Optional. | | day_sales_outstanding | The estimated number of days taken to pay the business. Optional. | | industry_average_payment_expectation_days | The estimated industry average number of days until payment. | | industry_average_day_sales_outstanding | The estimated industry average number of days taken to pay. |
CreditsafeNlLettersOfLiabilityInformation403Letters of Liability (403 Statements) for a company in the Netherlands. CreditsafeNlLettersOfLiabilityA Letters of Liability (403 Statement) for a company in the Netherlands. | start_date | The start date for this 403 statement. | | submitted_date | The submit date for this 403 statement, optional. | | removal_submitted_date | The removal submit date for this 403 statement, optional. | | removal_date | The removal date for this 403 statement, optional. |
CreditsafeBeAdditionalInformationAdditional information for a company in Belgium. CreditsafeBeNegativeInformationNegative information for a company in Belgium. CreditsafeBeNSSODetailDetails about a NSSO (National Social Security Office) labour court case against a company. | business_number | Registered number of the business. | | name_of_defendant | The business name of the defendant. | | legal_form_of_defendant | The description of the legal form of the business. | | date_of_summons | The date the case was brought against the business. | | labour_court | The court where the case was brought against the business. |
CreditsafeBeProtestedBillA protested bill. | drawee_name | The name of the business the bill is against. | | drawee_address | The address of the business the bill is against. | | bill_amount | The amount of the bill brought against the business. | | bill_currency | The currency of the Bill Amount. | | maturity_of_bill_in_months | The time since the bill was brought against the business. | | payment_date | The date the bill was settled. | | name_of_drawer | The name of the business that issued the bill. | | city_of_drawer | The city of Drawer. |
CreditsafeBeBankruptcyEventA bankruptcy event | bankruptcy_type | The type of bankruptcy proceeding including bankruptcy, withdrawal, closing. | | company_name | The name of the business the bankruptcy is brought against. | | street_of_registered_office | The street of the registered office of the bankrupt company. | | city_of_registered_office | The city of the registered office of the bankrupt company. | | postcode_of_registered_office | The postcode of the registered office of the bankrupt company. | | nace_bel_code | The industry code of the bankrupt company. | | nace_bel_description | The industry description of the bankrupt company. | | commercial_court | The court where the bankruptcy was brought against the company. | | source_date | The date the bankruptcy was received. | | source | The source of the bankruptcy data. | | date_of_decreee_of_bankruptcy | The date of the bankruptcy ruling. | | closing_date_of_summons | The closing date of the bankruptcy. | | name_of_trustee | The name of the trustee (manager) of the bankrupt business. | | street_of_trustee | The street of the trustee. | | city_of_trustee | The city of the trustee. | | postcode_of_trustee | The postcode of the trustee. |
CreditsafeBeMiscMiscellaneous information for a company in Belgium. | fax_number | Fax number of the company. Optional |
CreditsafeBePaymentExpectationsSummaryPayment expectation information for a company in Belgium. | payment_expectation_days | The estimated number of days until payment from the business. | | day_sales_outstanding | The estimated number of days taken to pay the business. |
CreditsafeBeIndustryComparisonIndustry sector comparison for a company in Belgium. | activity_code | Activity code of the company, and is used to identify the sector. | | activity_description | Activity description relating to the activity code. | | industry_average_payment_expectation_days | The estimated industry average number of days until payment for companies in this sector. | | industry_average_day_sales_outstanding | The estimated industry average number of days taken to pay for companies in this sector. | | industry_average_credit_rating | The estimated industry average credit rating for companies in this sector. |
CreditsafeBeRegisteredContractorRegistered contractor for a company in Belgium. | registration_number | Contractor registration number. | | contractor_description | Description of the registered activity. | | striking_off_date | Date the business was removed from the register. Optional. |
CreditsafeBeEventAn official event for a company in Belgium. | serial_number | The serial number of the event. | | description | A description of the event. |
Country parametersThe 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| id | Graydon identification number. 18 characters, regular expression ‘^(NL)\d{3}/\d{12}$’. |
Find companies using registration number| country | An ISO 3166-1 alpha-2 country code. Value must be ‘NL’ (Netherlands). | | registration_number | County specific registration code. 8 characters, regular expression ‘\d{8}’. | | office_type | Type of company. Optional. One of the following:| HeadOffice | Company is a head office. | | Branch | Company is a branch office. |
|
Find companies using name, address and/or phone number| country | An ISO 3166-1 alpha-2 country code. Value must be ‘NL’ (Netherlands). | | office_type | Type of company. Optional. One of the following:| HeadOffice | Company is a head office. | | Branch | Company is a branch office. |
| | name | Name of the company. Minimum length 2, optional. | | name_match_type | How to match the text in the name parameter. Optional, defaults to ‘MatchBlockOrWords’. One of the following:| MatchBeginning | Matches exact first chararcters of the string. | | MatchBlockOrWords | Matches either a block of text anywhere in the string or whole words (order insensitive). | | MatchWords | Matches whole words (order insensitive). |
| | street | Address street name. Optional. | | house_number | Address house number. Optional. | | city | Address city name. Optional. | | postal_code | Address postal code. Optional. | | phone_number | Company phone number. Optional. |
Belgium (BE)3 search variants available, reports contain country specific information. Find companies using unique Creditsafe ID| id | Graydon identification number. 15 characters, regular expression ‘^(BE)\d{3}/\d{9}$’. |
Find companies using registration number| country | An ISO 3166-1 alpha-2 country code. Value must be ‘BE’ (Belgium). | | registration_number | County specific registration code. 9 characters, regular expression ‘\d{9}’. | | office_type | Type of company. Optional. One of the following:| Registered | Company is a registered company. | | Trading | Company is a trading company. |
|
Find companies using name, address and/or phone number| country | An ISO 3166-1 alpha-2 country code. Value must be ‘BE’ (Belgium). | | office_type | Type of company. Optional. One of the following:| Registered | Company is a registered company. | | Trading | Company is a trading company. |
| | name | Name of the company. Minimum length 2, optional. | | name_match_type | How to match the text in the name parameter. Optional, defaults to ‘MatchBlockOrWords’. One of the following:| MatchBeginning | Matches exact first chararcters of the string. | | MatchBlockOrWords | Matches either a block of text anywhere in the string or whole words (order insensitive). | | MatchWords | Matches whole words (order insensitive). |
| | street | Address street name. Optional. | | house_number | Address house number. Optional. | | city | Address city name. Optional. | | postal_code | Address postal code. Optional. | | phone_number | Company phone number. Optional. |
France (FR)3 search variants available. Find companies using unique Creditsafe ID| id | Graydon identification number. 15 to 20 characters, regular expression ‘^(FR)\d{3}/(\d{9}|\d{14})$’. |
Find companies using registration number| country | An ISO 3166-1 alpha-2 country code. Value must be ‘FR’ (France). | | registration_number | County specific registration code. 9 to 14 characters, regular expression ‘(\d{9}|\d{14})’. |
Find companies using name, address and/or phone number| country | An ISO 3166-1 alpha-2 country code. Value must be ‘FR’ (France). | | status | Status of the company. Optional. One of the following:| Active | Company is active. | | NonActive | Company is non-active. | | Active, NonActive | Company is either active or non-active. |
| | office_type | Type of company. Optional. One of the following:| HeadOffice | Company is a head office. | | Branch | Company is a branch office. |
| | name | Name of the company. Minimum length 2, optional. | | name_match_type | How to match the text in the name parameter. Optional, defaults to ‘ClosestKeywords’. One of the following:| MatchBeginning | Matches exact first chararcters of the string. | | ClosestKeywords | Matches whole words as well as similar words. | | ExactValue | Matches the whole text. |
| | address | Freeform address input. Minimum length 2, optional. | | address_match_type | How to match the text in the address parameter. Optional, defaults to ‘MatchBlock’. One of the following: | | postal_code | Address postal code. Optional. | | phone_number | Company phone number. Optional. |
United Kingdom (GB)3 search variants available. Find companies using unique Creditsafe ID| id | Graydon identification number. Minimum length 8, regular expression ‘^(GB)\d{3}/.+$’. |
Find companies using registration number| country | An ISO 3166-1 alpha-2 country code. Value must be ‘GB’ (United Kingdom). | | registration_number | County specific registration code. Minimum length 2. | | status | Status of the company. Optional. One of the following:| Active | Company is active. | | Active, NonActive | Company is either active or non-active. |
|
Find companies using name, address and/or phone number| country | An ISO 3166-1 alpha-2 country code. Value must be ‘GB’ (United Kingdom). | | status | Status of the company. Optional. One of the following:| Active | Company is active. | | Active, NonActive | Company is either active or non-active. |
| | name | Name of the company. Minimum length 2, optional. | | name_match_type | How to match the text in the name parameter. Optional, defaults to ‘MatchBlockOrWords’. One of the following:| MatchBeginning | Matches exact first chararcters of the string. | | MatchBlockOrWords | Matches either a block of text anywhere in the string or whole words (order insensitive). | | ExactValue | Matches the whole text. |
| | street | Address street name. Optional. | | city | Address city name. Optional. | | postal_code | Address postal code. Optional. | | phone_number | Company phone number. Optional. |
Ireland (IE)3 search variants available. Find companies using unique Creditsafe ID| id | Graydon identification number. Minimum length 8, regular expression ‘^(IE)\d{3}/.+$’. |
Find companies using registration number| country | An ISO 3166-1 alpha-2 country code. Value must be ‘IE’ (Ireland). | | registration_number | County specific registration code. Minimum length 2. |
Find companies using name, address and/or phone number| country | An ISO 3166-1 alpha-2 country code. Value must be ‘IE’ (Ireland). | | name | Name of the company. Minimum length 2, optional. | | name_match_type | How to match the text in the name parameter. Optional, defaults to ‘MatchWords’. One of the following:| MatchBeginning | Matches exact first chararcters of the string. | | MatchBlock | Matches a block of text anywhere in the string. | | MatchWords | Matches whole words (order insensitive). |
| | address | Freeform address input. Minimum length 2, optional. | | address_match_type | How to match the text in the address parameter. Optional, defaults to ‘MatchBlockOrWords’. One of the following:| MatchBeginning | MatchBeginning. | | MatchBlockOrWords | MatchBlockOrWords. | | MatchWords | MatchWords. |
| | postal_code | Address postal code. Optional. | | phone_number | Company phone number. Optional. |
Germany (DE)3 search variants available. Find companies using unique Creditsafe ID| id | Graydon identification number. Minimum length 14, regular expression ‘^(DE)\d{3}/.+$’. |
Find companies using registration number and/or address| country | An ISO 3166-1 alpha-2 country code. Value must be ‘DE’ (Germany). | | registration_number | County specific registration code. Minimum length 4. | | city | Address city name. Optional. |
Find companies using name, address and/or phone number| country | An ISO 3166-1 alpha-2 country code. Value must be ‘DE’ (Germany). | | status | Status of the company. Optional. One of the following:| Active | Company is active. | | Active, NonActive | Company is either active or non-active. |
| | name | Name of the company. Minimum length 2, optional. | | name_match_type | How to match the text in the name parameter. Optional, defaults to ‘MatchWords’. One of the following:| MatchBeginning | Matches exact first chararcters of the string. | | MatchBlock | Matches a block of text anywhere in the string. | | ExactValue | Matches the whole text. | | MatchWords | Matches whole words (order insensitive). |
| | street | Address street name. Optional. | | city | Address city name. Optional. | | postal_code | Address postal code. Optional. | | phone_number | Company phone number. Optional. |
Sweden (SE)3 search variants available. Find companies using unique Creditsafe ID| id | Graydon identification number. 16 to 18 characters, regular expression ‘^(SE)\d{3}/\d{10,12}$’. |
Find companies using registration number| country | An ISO 3166-1 alpha-2 country code. Value must be ‘SE’ (Sweden). | | registration_number | County specific registration code. 10 to 12 characters, regular expression ‘\d{10,12}’. | | status | Status of the company. Optional. One of the following:| Active | Company is active. | | Active, NonActive | Company is either active or non-active. |
|
Find companies using name, address and/or phone number| country | An ISO 3166-1 alpha-2 country code. Value must be ‘SE’ (Sweden). | | status | Status of the company. Optional. One of the following:| Active | Company is active. | | Active, NonActive | Company is either active or non-active. |
| | name | Name of the company. Minimum length 3, optional. | | name_match_type | How to match the text in the name parameter. Optional, defaults to ‘MatchBlockOrWords’. One of the following:| MatchBlockOrWords | Matches either a block of text anywhere in the string or whole words (order insensitive). |
| | street | Address street name. Minimum length 3, optional. | | city | Address city name. Minimum length 3, optional. | | postal_code | Address postal code. Minimum length 5, optional. | | phone_number | Company phone number. Minimum length 3, optional. |
|