Skip to main content
In the sandbox, Know Your Business (KYB) applications auto-approve on submission so you can build quickly. To test other outcomes—compliance review, requests for information (RFIs), or denial—use a reserved business name prefix as a magic number.
These values work only in the sandbox (https://api-sandbox.circle.com). In production, they are normal business names. The application then follows the real review process.

​
How it works

Set the legal business name to a value that starts with one of the following magic-number prefixes. Then submit the application. When the application moves from DRAFT to SUBMITTED, the sandbox routes it to that outcome. It does not auto-approve.
  • Matching is case-insensitive and only the prefix is reserved. The rest of the business name is free text (for example CIRCLE_SANDBOX_DENY Acme Trading Ltd).
  • Any business name without a recognized prefix follows the default behavior: the application is approved.

​
Magic numbers

See Application types and states for the full lifecycle and Webhook notifications for the payloads.
CIRCLE_SANDBOX_REVIEW moves the application to IN_REVIEW. An RFI can only be issued after that. To test the full RFI flow, ask your Circle contact to issue an RFI on the application. You then get an onboarding_application_rfi_requested webhook. The application moves to PENDING_CUSTOMER_INFORMATION. Handle the RFI and resubmit.

​
Example

Submit an application whose business name requests a denial outcome:
With the business name set to CIRCLE_SANDBOX_DENY Acme Trading Ltd, the application transitions to DENIED and your registered endpoint receives an onboarding_application_denied webhook.