POST/api/v1/onboarding/applications

Accounts & balances

Submit onboarding application

Apply once to get sandbox access straight away, and production access after a KYB review.

Sandbox APIhttps://sandbox-api.nuvante.io

This 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

Submit onboarding application parameters
FieldTypeRequiredDescription
organisationNamestring · bodyYesYour organisation's legal name.
role"participant" | "issuer" · bodyYesUse `participant` for clearing members and `issuer` for stablecoin issuers.
primaryContact{ name: string; email: string } · bodyYesThe main contact for the application.
custodyModel"self-custody" | "mpc" | "caas" · bodyYesThe custody model you plan to use. The hyphenated form is standard, and `self_custody` is accepted too.
chainsstring[] · bodyYesThe chains you plan to use, for example `["stellar"]`.
commitPoint"ON_OBSERVATION" | "ON_INSTRUCTION" · bodyNoRequired for issuers. Sets when the issuer commits.
preBurnTransferRequiredboolean · bodyNoRequired for issuers when `commitPoint` is `ON_INSTRUCTION`.
dryRunboolean · bodyNoWhen 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.
Create a sandbox API key

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"
  }
}