> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yativo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Unified Transactions

> A single view of all transaction types with PDF/CSV export support

The Unified Transaction system aggregates all transaction types — deposits, withdrawals, swaps, card transactions, IBAN transfers, gateway payments, auto-forwarding, and agentic wallet transactions — into a single queryable ledger. You can also export transaction history as PDF or CSV files.

***

## Why Unified Transactions

Instead of querying separate endpoints for each transaction type, the unified system gives you:

* **One endpoint** to list all transactions regardless of type
* **Consistent schema** across deposits, withdrawals, swaps, card spends, IBAN transfers, and more
* **Export** to PDF (branded) or CSV for accounting and compliance
* **Fee tracking** with per-transaction fee breakdowns
* **Analytics** with aggregated volume, fee totals, and type distribution

***

## List Unified Transactions

```bash theme={null}
curl -X GET 'https://crypto-api.yativo.com/api/v1/unified-transactions/list?page=1&limit=20' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
```

```json Response theme={null}
{
  "success": true,
  "data": {
    "transactions": [
      {
        "transaction_id": "utx_01abc123",
        "type": "deposit",
        "status": "completed",
        "amount": "500.00",
        "asset": "USDC",
        "chain": "solana",
        "from_address": "7xKXtg2CW87d...",
        "to_address": "GY1EZGdpiJNyx...",
        "tx_hash": "5xYz...",
        "fee_amount": "0.00",
        "created_at": "2026-03-26T10:00:00Z"
      },
      {
        "transaction_id": "utx_02def456",
        "type": "card_transaction",
        "status": "completed",
        "amount": "25.99",
        "asset": "EUR",
        "merchant_name": "Amazon",
        "card_last_four": "4242",
        "created_at": "2026-03-26T11:00:00Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 150
    }
  }
}
```

***

## Transaction Types

| Type                  | Description                            |
| --------------------- | -------------------------------------- |
| `deposit`             | Incoming crypto deposit                |
| `withdrawal`          | Outbound crypto transfer               |
| `swap`                | Token swap (cross-chain or same-chain) |
| `fee`                 | Platform fee deduction                 |
| `auto_forwarding`     | Automatically forwarded deposit        |
| `card_transaction`    | Yativo Card spend at a merchant        |
| `iban_transfer`       | IBAN bank transfer (EUR)               |
| `gateway_payment`     | Crypto payment gateway receipt         |
| `agentic_transaction` | AI agent wallet transaction            |

***

## Get Transaction Details

```bash theme={null}
curl -X GET 'https://crypto-api.yativo.com/api/v1/unified-transactions/utx_01abc123' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
```

***

## Calculate Fees

Preview the fees for a transaction before executing:

```bash theme={null}
curl -X POST 'https://crypto-api.yativo.com/api/v1/unified-transactions/calculate-fees' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "withdrawal",
    "amount": "100.00",
    "chain": "ethereum"
  }'
```

***

## Analytics

Get aggregated transaction analytics with fee breakdowns:

```bash theme={null}
curl -X GET 'https://crypto-api.yativo.com/api/v1/unified-transactions/analytics-with-fees' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
```

***

## Export Transactions

Export your transaction history as a branded PDF report or a CSV spreadsheet.

### Request an Export

```bash theme={null}
curl -X POST 'https://crypto-api.yativo.com/api/v1/unified-transactions/export' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "format": "pdf",
    "date_from": "2026-03-01",
    "date_to": "2026-03-31",
    "types": ["deposit", "withdrawal", "swap"]
  }'
```

```json Response theme={null}
{
  "success": true,
  "data": {
    "export_id": "exp_01abc123",
    "format": "pdf",
    "status": "processing",
    "created_at": "2026-04-01T12:00:00Z"
  }
}
```

### List Exports

```bash theme={null}
curl -X GET 'https://crypto-api.yativo.com/api/v1/unified-transactions/export/list' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
```

### Download an Export

```bash theme={null}
curl -X GET 'https://crypto-api.yativo.com/api/v1/unified-transactions/export/exp_01abc123/download' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --output transactions.pdf
```

Export files are available for **24 hours** after generation.

***

## Next Steps

<CardGroup cols={2}>
  <Card title="API Reference" icon="code" href="/api-reference/unified-transactions/list">
    Full endpoint reference for unified transactions.
  </Card>

  <Card title="Webhooks" icon="bell" href="/yativo-crypto/webhooks">
    Get notified on transaction events.
  </Card>

  <Card title="Analytics" icon="chart-line" href="/yativo-crypto/analytics">
    Dashboard-level transaction analytics.
  </Card>
</CardGroup>