Skip to main content
The TEST country allows you to test your integration without making real requests to external registries. It returns predictable mock data instantly.

​
Basic Usage

Use country code TEST with any company ID. Special IDs trigger specific behaviors:
Search returns your query plus example test IDs you can use:

​
Test Company IDs

​
Success Cases

Any ID that doesn’t match an error pattern returns a valid company:

​
Error Cases

Use these IDs to test every error response your integration needs to handle: These error IDs work across all request types: company data, available documents, and document downloads. Use them as the id to trigger errors on any datapoint or document retrieval.

​
Delivery Delays

By default the TEST country responds instantly. To test how your integration handles slow requests, such as polling, timeouts, and loading states, use an ID containing a DELAY_ token. The request stays pending for the given duration, then returns successful data. The delay applies to both company data and document downloads. Each request to the TEST country runs independently, so the same ID triggers the full delay every time, including on repeated and concurrent requests. You can still add a - or _ separated suffix such as DELAY_1M-001 to label requests in your own logs. The token also combines with the GRAPH_ prefixes below. GRAPH_CHAIN_DELAY_1M delays every company resolved in the ownership graph. Use the shorter durations (1M, 10M) for graph IDs, since the delay applies to each company in the chain.

​
Documents

All test companies return a free “Trade Register Extract” document.

​
Graph/Ownership Testing

IDs starting with GRAPH_ return specific ownership structures: These IDs work with the shareholders, ultimateBeneficialOwners, and graph data points:
  • shareholders returns the direct shareholders of the company.
  • ultimateBeneficialOwners returns the individual shareholders holding 25% or more. For GRAPH_UBO_001 this is the 51% and 25% holders; the 24% holder is excluded.
  • graph returns the full ownership tree, recursing through company shareholders and flagging beneficial owners on the individual nodes.