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

IDs starting with ERROR_ trigger specific errors:
Company IDError TypeHTTP Status
ERROR_NOT_FOUNDCompany not found404
ERROR_INVALID_INPUTInvalid request400
ERROR_AUTH_FAILEDService unavailable503
ERROR_TIMEOUTService unavailable503
ERROR_RATE_LIMITEDService unavailable503
ERROR_SERVICE_DOWNService unavailable503
ERROR_NETWORKService unavailable503
ERROR_PARSING_FAILEDProcessing failed422
ERROR_EXTRACTIONProcessing failed422
ERROR_UNAVAILABLEService unavailable503
ERROR_PERMISSIONService unavailable503
ERROR_INVALID_RESPONSEService unavailable503
ERROR_UNKNOWNService unavailable503

​
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