Skip to main content
A customer is created with two API calls: one to begin the customer’s application, and one to submit it. Before you start, make sure your organization is approved for Named Virtual Accounts and your API key has the Onboarding permission. See the Named Virtual Accounts overview. The examples use the sandbox base URL. For production, see Base URLs.

Step 1: Begin the customer’s application

POST /v2/onboarding/customers Creates the customer and returns their customerId. Set applicationType to VA_INDIVIDUAL for an individual or VA_INSTITUTION for an institution, and affiliateId to the identifier we gave you when your organization was set up. Use externalId for your own reference to the customer. It must be unique for each customer. See Begin owner onboarding application for the full reference. Pass the customer’s details in entries, one key and value per field:
Request
Response
Save the customerId. You’ll use it in every later call for this customer. If you’re not sure which details the application still needs, call Get owner onboarding application by ID. It returns the application’s status, any missing information, and the entries already provided.

Step 2: Submit the customer

POST /v2/onboarding/customers/{customerId}/submit Submits the customer’s application. Because Named Virtual Accounts run on a reliance model, the customer is approved on submission and their status moves to COMPLETE. There’s no screening step at Anchorage Digital. See Submit owner onboarding application for the full reference.
Request
A 200 response means the customer is approved. If the application is missing required information, the call returns 400 and the application stays IN_PROGRESS. Getting it by ID lists each missing key with status MISSING.
To create and approve a customer in one call, set "submit": true in the request above. The application is submitted only if it has no validation errors.
Submission can’t be undone, so check the customer’s details before you submit. Once the customer is approved, create virtual accounts for them.