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: 
curl -X POST https://api.topograph.co/v2/company \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"country": "TEST", "companyId": "SUCCESS-12345"}'
Search returns your query plus example test IDs you can use: 
curl -X POST https://api.topograph.co/v2/search \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"country": "TEST", "query": "my-company"}'

​
Test Company IDs

​
Success Cases

Any ID that doesn’t match an error pattern returns a valid company:
Company IDDescription
Any valid IDReturns a complete company profile

​
Error Cases

Use these IDs to test every error response your integration needs to handle:
Company IDError CodeMessageHTTP Status
RESOURCE_NOT_FOUNDresource_not_foundThe requested resource was not found. Please verify the identifier and try again.404
INVALID_REQUESTinvalid_requestInvalid request. Please check the request parameters and try again.400
PROCESSING_FAILEDprocessing_failedUnable to process the request. Please try again later.422
SERVICE_UNAVAILABLEservice_unavailableService temporarily unavailable. Please try again in a few moments.503
These error IDs work across all request types: company profile, available documents, and document downloads. Use them as the companyId to trigger errors on any datapoint or document purchase.

​
Documents

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

​
Graph/Ownership Testing

IDs starting with GRAPH_ return specific ownership structures:
Company IDDescription
GRAPH_SIMPLE_0012 individual shareholders (30%, 20%)
GRAPH_CHAIN_001Company → Company → Individual chain
GRAPH_UBO_001Clear UBO structure (51%, 25%, 24%)
GRAPH_CIRCULAR_001Circular ownership (A owns B owns A)
GRAPH_WIDE_0015 individual shareholders (15% each)
GRAPH_MIXED_0012 individuals + 2 company shareholders
GRAPH_DEEP_001Deep chain up to 3 levels
GRAPH_EMPTY_001Company with no shareholders