Company Financials and Ownership Data API - Global

Query a global company reference database and pull the matches as flat rows: registered identity, address and industry codes, financial statement figures, the ownership chain from shareholders up to the global ultimate owner, beneficial owners, ESG scores and sanctions, watchlist, PEP and adverse media flags.

What this actor does

• Finds companies the way a reference database expects. By registered name including former and also-known-as names, by country, region, NUTS area, city or street, by NACE, NAICS or US SIC industry classification, by legal form, entity type, status and listing status, or directly by entity ID, LEI, ISIN or ticker.
• Resolves a domain list to registered entities with a single filter matched across the website, domain and email fields.
• Requests the fields you actually need through six presets: identity, firmographics, financials, ownership, risk and ESG. Add any further field by name, or replace the list entirely with a raw field document for year-indexed financials.
• Tells you what your own subscription supports. Turn on dumpFields and the run fetches the provider's own filter and field dictionaries and writes them to the key-value store, collecting nothing and charging nothing. That beats guessing a field name and getting an opaque HTTP 400.
• Stops the moment paging stalls. An offset that is not honoured returns the same records again, so the run halts rather than re-collecting and re-charging for companies it already has.
• Keeps the untouched API record under raw alongside the flat promoted columns.

Input

Field	What it does
companyName, includeBranches, includePreviousNames	Name search, optionally widened to branches and former names.
bvdIds, orbisIds, recordIds, leis, isins, tickers	Direct lookups by identifier.
countryRegions, cities, streetAddress, nutsCodes	Geographic narrowing.
status, listingStatus, standardisedLegalForms, entityTypeIds	Legal and market classification.
nace2, nace2CodeType, naics2017, usSic	Industry classification, with control over which assignment NACE matches.
websiteDomainEmail, phones	Match a domain or contact list to registered entities.
fieldPreset, extraFields, preferences	Which fields to request, and which accounting statements to read them from.
advancedWhere, advancedSelect	Raw filter and field documents for boolean trees, financial screens and year-indexed figures.
entity	Companies, contacts or news, subject to your subscription.
dumpFields	List your subscription's own filters and fields instead of collecting records.
useBearerToken	Send the credential as a bearer header for OAuth or JWT accounts.
pageSize, maxResults	Page size and the hard cap on spend.
apiKey	Your own API token, sent in the ApiToken header. Stored as a secret.

Example output

{
  "recordType": "company",
  "matched": true,
  "bvdId": "BE0435604729",
  "orbisId": "008326720",
  "name": "MELEXIS NV",
  "status": "Active",
  "legalForm": "Public limited company",
  "country": "Belgium",
  "countryCode": "BE",
  "city": "IEPER",
  "postcode": "8900",
  "addressLine1": "ROZENDAALSTRAAT 12",
  "website": "www.melexis.com",
  "phone": "+32 57 300 800",
  "vatNumber": "BE0435604729",
  "lei": "5493006W3QUS5LMH6R84",
  "nace2Code": "2611",
  "nace2Label": "Manufacture of electronic components",
  "employees": 2087,
  "operatingRevenue": 962400000,
  "profitBeforeTax": 187300000,
  "totalAssets": 812500000,
  "currency": "EUR",
  "closingDate": "2024-12-31",
  "guoName": "XTRION NV",
  "guoBvdId": "BE0475721554",
  "raw": { }
}

Frequently asked questions

What data does this company data API return?

Depending on the field preset: registered name, entity ID, Orbis ID, status, legal form, VAT number, LEI, ISIN and trade register number; full address with country, region, city, postcode and coordinates; website, domain, email and phone; NACE, NAICS and US SIC industry codes with labels and a trade description; operating revenue, profit before tax, profit and loss, cash flow, total assets, shareholders' funds, headcount, currency, closing date and consolidation code; the global ultimate owner, shareholder list with direct percentages and beneficial owner list; environmental, social, governance and global ESG scores; and sanctions, watchlist, PEP, adverse media and legal event flags.

Do I need my own API key?

Yes. This actor does not include data access. You use your own API token for the Orbis API from Moody's, which is the provider whose API this actor calls; tokens are issued by their customer support rather than self-serve. Your own subscription, entitlement and terms apply. Paste the token into the apiKey field, where it is stored as an Apify secret and sent in the ApiToken request header rather than as a URL parameter, so it never appears in a log line or a redirect. If your account was provisioned with OAuth or JWT rather than a static token, turn on useBearerToken.

How do I find out which fields my subscription includes?

Run the actor once with dumpFields turned on. It fetches the provider's own filter and field dictionaries for the selected entity and writes them to the key-value store as COMPANIES_METADATA_WHERE and COMPANIES_METADATA_SELECT. No records are collected and nothing is charged. Those dictionaries are the authority on what your plan accepts.

How do I pull financial statements for specific years?

Use advancedSelect with a year-indexed field object, which is what the provider's own examples do. For example ["NAME", {"OPRE": {"IndexOrYear": "2023", "Currency": "USD", "Unit": 3}}] returns operating revenue for the 2023 statement in thousands of US dollars. Set preferences to AnnualReport or AllStatement to control which statements those figures are read from.

Can I screen for sanctioned or high-risk entities?

Yes. Choose the risk field preset, which requests the sanctions, watchlist, PEP and adverse media match indicators, the OFAC and EU consolidated list flags, and legal event details. Combine it with a country or industry filter to screen a defined population rather than the whole database.

How do I find the owners of a company?

Choose the ownership preset and pass the company's entity ID in bvdIds. The row then carries the global ultimate owner's name and ID, the shareholder list with each holder's ID, country, entity type and direct percentage, and the beneficial owner list with names, countries and birthdates.

How do I write a filter this form does not offer?

Use advancedWhere with a raw JSON filter document. It accepts the provider's boolean operators, so {"AND": [{"Status": "Active"}, {"NOT": [{"CountryRegion": {"Text": "Russia"}}]}]} works, as do financial screens and update windows. A raw array is appended to the form criteria; a boolean object is combined with them.

How much does a run cost?

Pricing is pay per result: you are charged for each company record returned to the dataset, and duplicates are not charged. Dictionary dump runs collect nothing and are not charged at all. Apify platform usage is included in the per-result price. Your own provider entitlement is separate and billed by them.

Keyword map

company data API, company financials API, ownership data API, beneficial ownership API, shareholder data API, global ultimate owner lookup, company reference data, LEI lookup, ISIN company lookup, NACE code search, KYC company screening API, sanctions screening data, PEP watchlist flags, ESG score API, private company financials, corporate structure API, entity resolution by domain