Accounts v2 overview

Use the Accounts v2 API to open a bank account for a customer at the bank you choose, read accounts with their balances and status reasons, and send the data or documents the bank asks for.

How it works

1. Call GET /v1/accounts/capabilities to choose a bank_code, currency and account_type. The route is under /v1, but it is the first step of a v2 account.
2. Call GET /v2/accounts/requirements to see the fields and documents that bank needs.
3. Call POST /v2/accounts. The customer must have completed KYC. The response has only the account_id and status: pending.
4. Follow the applications.accounts.* webhooks, or read GET /v2/accounts/{id} until status is active. That read returns the application_id, which the create response does not. When requires_user_action is true, read status_reason and answer it with PATCH /v2/accounts/applications/{application_id}. For an account you open with v2, Gravv sends applications.accounts.completed, never account.activated.

For step-by-step examples, see Accounts (v2) recipes.

Endpoints

Authentication

All requests use https://api.gravv.xyz and authenticate with the Api-Key header. See Authentication for details.