Company Credit Data API

Search official company registers in over 100 countries and pull credit scores, credit limits, turnover, shareholders, directors and filed accounts as flat rows.

Marketing databases tell you what a company says about itself. A register tells you what it filed. This actor wraps a company credit and business information API that sits on national registers, so the rows it returns carry a registration number, a status, filed accounts dates and a credit rating rather than a scraped headcount estimate.

Four modes

Mode	What it does	What you give it
company-search	Finds companies in the register and returns identity, status and address	A country plus a name, number or address
credit-report	Orders the full credit report for identifiers you already hold	A list of company ids
confidence-match	Scores a name and address against the register and reports how sure the match is	A list of company names
director-search	Finds company officers by name	A country plus a name

Confidence match is the one worth knowing about. Feed it a messy list of company names from a CRM, set a threshold, and every candidate above that score comes back with a registration number and a confidence figure, so you can decide which matches to accept rather than trusting a fuzzy join.

What comes back

Search rows carry the provider's cross-border company id, safe number, registration number and VAT number; company name, country, status, company type, office type and legal form; activity code, activity description, industry sector and classification; the full address split into street, house number, city, postcode, province and country; and the dates of the latest filed accounts and the latest register change.

Credit report rows add the credit rating value and description, credit limit and currency, contract limit, previous rating and the date it last changed; latest turnover and shareholders equity; date of incorporation; email addresses and websites; issued share capital, currency, number of shares issued and a shareholder count; a current director count and their names; an employee count; and a flag for whether the report carries negative information.

Match rows add matchScoreConfidence, the score that candidate reached.

Director rows carry the person id, first and last name, date of birth, country, status, local director number, and the company they are an officer of.

Every row carries raw, the untouched provider record, so nothing is lost by the flattening. A credit report is a large nested document and raw keeps all of it, including financial statements and group structure.

Example output

{
  "recordType": "credit-report",
  "matched": true,
  "connectId": "GB-0-01234567",
  "name": "Example Trading Limited",
  "country": "GB",
  "companyRegistrationNumber": "01234567",
  "companyStatus": "Active",
  "legalForm": "Private limited with share capital",
  "mainActivity": "Manufacture of electrical equipment",
  "activityCode": "27900",
  "creditRatingValue": "71",
  "creditRatingDescription": "Very low risk",
  "creditLimitValue": 250000,
  "creditLimitCurrency": "GBP",
  "latestTurnover": 18400000,
  "latestTurnoverCurrency": "GBP",
  "dateOfIncorporation": "2004-06-18",
  "city": "Manchester",
  "postalCode": "M1 2AB",
  "issuedShareCapital": 100000,
  "currentDirectorCount": 4,
  "employeeCount": 112,
  "hasNegativeInformation": false,
  "dateOfOrder": "2026-08-06T09:14:02Z"
}

Pricing

Pay per result. You are charged once per record saved to the dataset. Duplicates are removed before charging, and an identifier or name that resolves to nothing is stored with matched: false free of charge, so a list of dead identifiers costs you nothing. Apify platform usage is included in the per-result price. Your own provider plan is billed separately by the provider, and credit reports consume report credits on that plan.

Bring your own API key

This actor does not include data access. You use your own account with Creditsafe, which is the provider whose API this actor calls. That API issues short lived tokens rather than static keys, so the usual setup is to put your provider username in the username field and your password in the API key field: the actor exchanges them for a token and renews it silently whenever it expires. If you already hold a token, paste it into the API key field on its own and leave the username empty. Credentials travel in request headers, never in a URL, so they never appear in a log line or a redirect.

FAQ

What is a company credit data API?

A company credit data API returns register-sourced business information: legal identity, registration number, status, filed accounts, directors, shareholders and a credit score with a suggested credit limit. It differs from a marketing company database in that every field traces back to a filing rather than to a website. This actor wraps one and turns its results into a dataset you can export as CSV, JSON or Excel, or pull from another tool.

How do I check the credit risk of a list of customers?

Run confidence-match with your customer names and a country to get their register ids, take the connectId from the rows that scored high enough, then run credit-report with those ids. The report rows carry creditRatingValue, creditLimitValue and latestTurnover, which is what a credit committee actually asks for.

Why does every search need a country?

There is no single global index behind this API. Each country is a separate register with its own identifiers and its own searchable fields, so the country decides which register is queried and which criteria are allowed. A criterion one country supports may be rejected outright by another, and the error names the field when that happens.

What does the match threshold mean?

The confidence match returns a score per candidate and only keeps candidates at or above your threshold. The provider documents 898 as a good match on name alone, with higher bands requiring stronger agreement on identifiers and address. Raise the threshold when a false positive is expensive, lower it when you would rather review more candidates by hand.

Can I get directors and shareholders?

Yes. Credit report rows carry a current director count and their names, plus issued share capital, share currency, number of shares issued and a shareholder count, with the full director and shareholder records preserved under raw. To search officers by name instead of by company, use director-search.

Can I test without spending report credits?

Yes. Switch on the sandbox option and every request goes to the provider's sandbox environment instead of production, which is the safe way to check a filter set or a template name before a real run.

How do I get a full report for every company a search finds?

Switch on the option to order a report for each search hit. The run then makes one extra provider call per company and stores the full report row instead of the short search row. That consumes a report credit per company on your own plan, so pair it with a tight maxResults.

How many results can one run return?

Up to 25,000 per run, paged at up to 200 records per request.

Do I need my own API key?

Yes. This actor is bring your own key, and your usage is billed on your own provider plan. The actor charges separately for each result it returns.

Keyword map

company credit data API, business credit score API, company credit check API, company registry API, company registration number lookup, business information API, firmographics API, company financials API, filed accounts data, director search API, shareholder data API, company status API, KYB data API, know your business API, confidence match API, company name matching API, credit limit API, international company data API