Sandbox test cases

The sandbox is preloaded with a fixed set of companies and individuals you can create and run. You create a company case by searching for it and then creating it by its exact name. Individuals are created directly by name. Every case you create is visible in the API, in the Workspace console, and in the sample onboarding app, because all three connect with the same credentials.

Two kinds of test entity

Synthetic cases are hand-built to exercise a specific scenario, such as a PEP match or a long processing delay. They are the fastest way to test a particular code path. A synthetic case carries a generated placeholder document and report, not a real registry document.

Synthetic cases also return contract-shaped provenance metadata (registry source, the field it backs, and a retrieval timestamp) matching the API shape, so you can exercise your source-document and retrieval-time rendering against them. On a synthetic case this provenance is illustrative, not a record of a real registry retrieval.

Registry-original cases are real companies drawn from live registries. They carry real registry documents. Use these when you want realistic structure and document data.

Synthetic companies

Company	Jurisdiction	What it exercises
Dragon Pearl Holdings Limited	Hong Kong	Full clean structure, a deactivated officer, and monitoring alerts (new officer, expiring document)
Victoria Harbour Trading Co Limited	Hong Kong	An AML-positive case: a beneficial owner with a PEP and sanctions match, so you can test match handling
Thames Valley Logistics Ltd	United Kingdom	An unresolved beneficial-owner state (PSC "not all UBOs identified") on an otherwise resolved structure
Yangtze River Manufacturing Co Ltd	China	Long processing latency (roughly 30 to 40 minutes), to test polling and timeouts

Synthetic individuals

Individual	Jurisdiction	What it exercises
Chan Tai Man	Hong Kong	A clean individual, no AML matches
Margaret Thornbury	United Kingdom	A PEP match on the AML screening step

Create individuals directly by full name. There is no search step for individuals.

Golden reference companies

These three are byte-faithful captures of real cases, including the real report:

Cropwell Bishop Creamery Limited (United Kingdom)
SC Engineering Private Limited (Singapore)
Ubizense Limited (Hong Kong)

They also appear in the full catalogue below, so you can search them by name or registration number.

Full registry catalogue

The sandbox also includes 347 real companies drawn from live registries across more than 140 jurisdictions. Each carries real registry documents. Filter by name, country, or registration number, or pick a jurisdiction, then create the company by its exact name.

How to create a case

For a company, search then create, then poll until the case is ready:

Search: POST /v2/Companies/search with {query, codeiso31662}
Create: POST /v2/Companies with {rawname: "exact name", codeiso31662}
Poll: GET /v2/Companies/{caseCommonId} until statusId is 3 (Ready)

For an individual, create directly, then poll:

Create: POST /v2/Individuals with {firstName, lastName}
Poll: GET /v2/Individuals/{caseCommonId} until statusId is 3 (Ready)

Authenticate with the OAuth2 client-credentials grant, scope PublicApi. See the Quickstart and the Guide.