Gravv docs
Docs Agent Sign in Get API keys

Get your card account

Returns one account with its deposit details, balance and assets. Poll it after you create an account until status is active. Deposit details appear only then. An unknown ID returns a 400 with internal account not found.

GEThttps://api.gravv.xyz/v1/accounts/{account_id}

Path Parameters

Responses

Status Description
200 Account details
400 The request failed. These account routes return every error as HTTP 400, including not found. Read the error message for the cause.

200 response

An internal account. The API leaves out empty fields. It also returns accounts opened with /v2/accounts, without their v2-only fields.

Type of account.

Possible values: regular, savings, card, auto_sweep, collection, default, non_custodial

What the account can do. It depends on the account type.

Possible values: transfer, receive, remittance, card_payment, sweep_collection

pending while the bank sets the account up, then active. frozen means suspended or set-up failed, manual_review means held for review, and deleted is closed and final. reason explains a status other than active.

Possible values: active, pending, frozen, manual_review, deleted

Why the account is not active. Omitted for active accounts.

main for your own accounts, sub_account for your customers' accounts.

Possible values: main, sub_account

Balance as a decimal string in major units. For USD it is the USDC balance. For EUR it is that balance converted to EUR. For NGN it is the token balance. For other currencies it is the USDC amount, not converted. The API omits it when it cannot read the balance, so treat a missing value as unknown, not zero.

True for NGN accounts

Set for NGN accounts only

Possible values: settle, auto_onramp

The token wallet of an NGN account

Deposit account number. The US account number for USD, the IBAN for EUR, the account number for GBP, the CLABE for MXN and the BR code for BRL. Bank details appear only once the account is active.

The ABA routing number for USD, the BIC for EUR and the sort code for GBP.

Balance per token

400 response

Human-readable error message.

Authorization

  • ApiKeyAuth
Was this page helpful?
ESC