API reference
Use these pages for endpoint-specific request and response details. All requests use the base URL https://api.gravv.xyz/v1/ and authenticate with the Api-Key header.
Before you start
Create API keys and authenticate with the Api-Key header.
Make write requests safe to retry with the Idempotency-Key header.
Understand error shapes and status codes across the API.
Stay within request limits and handle 429 responses.
Read amounts, dates and ids, and keep uploads within their size limits.
Page through lists, with each route's default and largest page.
Get the OpenAPI 3.1 files behind this reference.
Resources
Create and manage customer records.
Verify customers and retrieve verification status.
Check and activate the card feature for a customer.
Open bank accounts at a chosen bank and answer what it asks for.
Manage payees outside Gravv.
Move funds and retrieve transfer rates.
Read transfer tiers, caps and what is left to send.
Issue and manage virtual and physical cards.
Start collections and manage payment intents.
Create and retrieve blockchain wallets.
Retrieve rates and manage FX orders.
Save the accounts and wallets that receive FX proceeds.
Retrieve, inspect, and export transactions.
Inspect events, delivery history, and retries.
Verify a cardholder with a liveness check before card activation.