---
title: "Transactions overview"
description: "Retrieve, inspect, and export transaction records."
---

# Transactions overview

Use the Transactions API to list and retrieve transactions, inspect transaction volume, and export transaction data.

<CardGroup cols={2}>
  <Card title="Browse transaction endpoints" icon="code" href="/api-reference/transactions/get-v1-transactions">
    List transactions or browse the operations in this category.
  </Card>
  <Card title="Authentication" icon="key" href="/getting-started/authentication">
    Configure API-key authentication for your integration.
  </Card>
</CardGroup>

## 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`](/api-reference/transactions/get-v1-transactions) | List transactions with filters and pagination |
| [`GET /v1/transactions/{transaction_id}`](/api-reference/transactions/get-v1-transactions-transaction-id) | Retrieve a single transaction |
| [`GET /v1/transactions/volume`](/api-reference/transactions/get-v1-transactions-volume) | Total summed volume of matching transactions — useful for dashboard metrics |
| [`GET /v1/transactions/export`](/api-reference/transactions/get-v1-transactions-export) | Export matching transactions as CSV or JSON (up to 50,000 records) |

<Note>
For real-time updates, prefer [webhook events](/platform/webhooks/webhooks-overview) over polling the list endpoint.
</Note>

## Authentication

All requests use `https://api.gravv.xyz/v1/` and authenticate with the `Api-Key` header. See [Authentication](/getting-started/authentication) for details.