POST
/api/v1/onboarding/applicationsAccounts & balances
Submit onboarding application
Apply once to get sandbox access straight away, and production access after a KYB review.
Sandbox API
https://sandbox-api.nuvante.ioThis is how you get started with Nuvanté, with no need to contact sales first. Sandbox access is granted as soon as you apply. Production access is reviewed separately, using the same application.
Parameters
| Field | Type | Required | Description |
|---|---|---|---|
| organisationName | string · body | Yes | Your organisation's legal name. |
| role | "participant" | "issuer" · body | Yes | Use `participant` for clearing members and `issuer` for stablecoin issuers. |
| primaryContact | { name: string; email: string } · body | Yes | The main contact for the application. |
| custodyModel | "self-custody" | "mpc" | "caas" · body | Yes | The custody model you plan to use. The hyphenated form is standard, and `self_custody` is accepted too. |
| chains | string[] · body | Yes | The chains you plan to use, for example `["stellar"]`. |
| commitPoint | "ON_OBSERVATION" | "ON_INSTRUCTION" · body | No | Required for issuers. Sets when the issuer commits. |
| preBurnTransferRequired | boolean · body | No | Required for issuers when `commitPoint` is `ON_INSTRUCTION`. |
| dryRun | boolean · body | No | When true, runs the same validation and mode derivation as a real submission, without saving anything or provisioning sandbox access. |
Responses
201Application accepted, with sandbox access granted straight away.
Request
curl --request POST \
--url 'https://sandbox-api.nuvante.io/api/v1/onboarding/applications' \
--header 'Authorization: Bearer nvt_sandbox_your_key' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"organisationName": "Acme Clearing Ltd",
"role": "participant",
"primaryContact": {
"name": "Jo Smith",
"email": "jo@acme.example"
},
"intendedUseCase": "GBP redemption for institutional clients",
"expectedMonthlyVolumeGbp": "5000000.00",
"custodyModel": "mpc",
"chains": [
"stellar"
]
}'Response
{
"data": {
"applicationId": "8f14e45f-ceea-4e7a-9f5d-2c1b8a3d6e01",
"status": "under_review",
"derivedMode": null,
"custodyCompatible": null,
"sandbox": {
"accessGranted": true,
"apiKeyId": "4b2c9e7a-1d3f-4a6b-8c5e-7f9a0b1c2d3e",
"apiKeySecret": "nvt_sandbox_…",
"participantId": "323e4567-e89b-42d3-a456-426614174002"
},
"production": {
"accessGranted": false,
"reviewEta": "2 business days"
}
},
"meta": {
"commandId": "6a8c0e2f-4b6d-4f8a-9c1e-3d5f7a9b0c4e"
}
}