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.

Send your secret API key in the Api-Key header.

How it works

Transfers, collections and card activity produce transaction records. An FX order does not, so track it with the FX order endpoints. The Transactions API is read-only. Use it for activity feeds, reconciliation, dashboards and reporting.

Endpoints

Endpoint	Description
`GET /v1/transactions`	List transactions, newest first, with filters and pagination. The API ignores `start_date` and `end_date`, so page from the newest and stop at your date
`GET /v1/transactions/{transaction_id}`	Retrieve a single transaction
`GET /v1/transactions/volume`	Get the total volume of matching transactions for all time. The API ignores date filters. Filter by currency, or the API adds amounts in different currencies together
`GET /v1/transactions/export`	Export matching transactions as CSV or JSON. It returns at most the 10 newest matching rows today, so use the list endpoint with paging for more

For step-by-step examples, see Transactions recipes.

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?