API Reference
Transactions overview
Use the Transactions API to list and retrieve transactions, inspect transaction volume, and export transaction data.
List transactions or browse the operations in this category.
Configure API-key authentication for your integration.
How it works
Every movement of money in Gravv — transfers, collections, card activity, FX — produces a transaction record. The Transactions API is read-only: use it to power activity feeds, reconciliation, dashboards, and reporting.
Endpoints
| Endpoint | Description |
|---|---|
GET /v1/transactions |
List transactions with filters and pagination |
GET /v1/transactions/{transaction_id} |
Retrieve a single transaction |
GET /v1/transactions/volume |
Total summed volume of matching transactions — useful for dashboard metrics |
GET /v1/transactions/export |
Export matching transactions as CSV or JSON (up to 50,000 records) |
For real-time updates, prefer webhook events over polling the list endpoint.
Authentication
All requests use https://api.gravv.xyz/v1/ and authenticate with the Api-Key header. See Authentication for details.
Was this page helpful?