Skip to main content
One API gives you company data for the United States, France, Germany and Ireland. The endpoint shape stays the same across all four markets. The classifications, identifiers and filters do not.

4 markets

United States, France, Germany and Ireland.

11 endpoints

The same API surface in every market.

1 API key

Bearer authentication across the whole API.
This API is in beta. It is stable enough to build against and serves production data. Keys are issued by hand, there is no self-service signup yet, and a key currently reaches all four markets. Tell us what you need at support@thedatacity.com — feedback now shapes what ships next.
This API does not serve UK company data. For the UK, use the Industry Engine API.

​
Choose a market

Start with the market you want to query. Each tab shows values taken from that market’s OpenAPI document. Run the request at the end of the tab first: it returns the filter values that market accepts, which you then use to build a company query.
Base path: /v1/us/

Industry classification

Primary filter: NAICSSecondary filter: RNAICS

Company identifier

Response field: CompanyNumber

Location

Top-level region filter: StateLocation filters: State, Town, HQPostcode

API surface

11 endpoints and 47 company filter fields.
Use only classification and location values returned by this market’s filters endpoint. An unrecognised value returns an empty result with 200, so a typo is indistinguishable from a query that legitimately matches nothing.
cURL

​
Make your first request

1

Choose the market

Use us, fr, de or ie after /v1/ in every path. A request never searches more than one market.
2

Send your API key

Pass your key as a bearer token. Select a market above and copy its cURL request.Requests without a valid key return 401.
3

Discover valid values

Call GET /filters before you filter companies. It returns the classifications, locations and other values accepted by that market.
4

Query companies

Send values returned by /filters to POST /companies. Do not reuse classification or location values from another market.

Rate limit

Each key can make 60 requests per minute. A 429 response includes a retry-after header.

Production data

There is no sandbox key. These docs provide copyable cURL with a placeholder key and do not send requests from this page.

​
Compare markets

Every market exposes the same 11 endpoints. What differs is the values they accept, which is where integrations break: an unrecognised filter key returns an empty result rather than an error, so a request written for one market can silently return nothing for another.
France has no region filter and no secondary scheme. “Not available” is a real answer, not a gap in this table. France filters location by Commune and HQPostcode; there is no RNAF equivalent of the other markets’ secondary codes. A request carrying State against France matches nothing and returns 200.
Generated from the four OpenAPI documents on 2026-08-20, so it cannot drift from what the API accepts.

​
Common workflows

Discover filters

GET /filters lists the valid values for the selected market.

Search by name

GET /search finds companies when you have a name rather than filter criteria.

Build a company list

POST /companies filters companies and returns aggregate insights with the results.

Classify records

POST /classification adds market-specific classifications to company records.

​
Endpoint reference

Use the market groups in the sidebar for parameters, request bodies and response schemas. Every reference page comes from that market’s OpenAPI document, so it matches what the API accepts.

​
Connect an AI assistant

Each market also exposes a Model Context Protocol server. Use the same API key and replace COUNTRY_CODE with us, fr, de or ie:
MCP endpoint
Connect more than one market server when you want an assistant to compare countries.
Last modified on August 20, 2026