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

# Transactions

> Query on-ramp transactions

<Warning>
  **Preview Documentation** — This integration is in final testing. API shapes are stable; endpoints will be live shortly. Contact your RebelFi rep if you have questions before go-live.
</Warning>

## List Transactions

Returns transactions with filtering and pagination.

```
GET /v1/ramp/transactions
```

### Query Parameters

<ParamField query="customer_id" type="integer">
  Filter by recipient ID
</ParamField>

<ParamField query="status" type="string">
  Filter by status: `pending`, `processing`, `in_progress`, `awaiting_confirmation`, `broadcasted`, `completed`, `failed`, `rejected`, `timed_out`, `canceled`, `reversed`
</ParamField>

<ParamField query="date_from" type="string">
  Filter from date (ISO 8601)
</ParamField>

<ParamField query="date_to" type="string">
  Filter to date (ISO 8601)
</ParamField>

<ParamField query="page" type="integer" default="1">
  Page number
</ParamField>

<ParamField query="per_page" type="integer" default="20">
  Results per page (max 100)
</ParamField>

```bash theme={null}
curl "https://api.rebelfi.io/v1/ramp/transactions?customer_id=1&status=completed&page=1" \
  -H "x-api-key: your_api_key"
```

### Response

```json theme={null}
{
  "data": [
    {
      "id": 1,
      "customer_id": 1,
      "customer_name": "OnEdge",
      "usd_amount": "50000",
      "total_fee": "125",
      "usdc_delivered": "49875",
      "status": "completed",
      "created_at": "2026-03-20T14:30:00Z",
      "completed_at": "2026-03-20T14:35:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total": 156
  }
}
```

<ResponseField name="id" type="number">
  Transaction identifier
</ResponseField>

<ResponseField name="customer_id" type="number">
  Recipient ID this transaction belongs to
</ResponseField>

<ResponseField name="customer_name" type="string">
  Recipient name
</ResponseField>

<ResponseField name="usd_amount" type="string">
  USD amount deposited
</ResponseField>

<ResponseField name="total_fee" type="string">
  Total fee deducted (in USD)
</ResponseField>

<ResponseField name="usdc_delivered" type="string">
  Stablecoin amount (USDC/USDT) delivered to your wallet
</ResponseField>

<ResponseField name="status" type="string">
  Current transaction status
</ResponseField>

<ResponseField name="created_at" type="string">
  ISO 8601 timestamp when the transaction was created
</ResponseField>

<ResponseField name="completed_at" type="string">
  ISO 8601 timestamp when funds were delivered (only present for completed transactions)
</ResponseField>

***

## Get Transaction

Returns a single transaction with full status history.

```
GET /v1/ramp/transactions/{id}
```

<ParamField path="id" type="integer" required>
  Transaction ID
</ParamField>

```bash theme={null}
curl "https://api.rebelfi.io/v1/ramp/transactions/1" \
  -H "x-api-key: your_api_key"
```

### Response

```json theme={null}
{
  "id": 1,
  "customer_id": 1,
  "customer_name": "OnEdge",
  "usd_amount": "50000",
  "total_fee": "125",
  "usdc_delivered": "49875",
  "status": "completed",
  "status_history": [
    { "status": "pending", "timestamp": "2026-03-20T14:30:00Z" },
    { "status": "processing", "timestamp": "2026-03-20T14:31:00Z" },
    { "status": "broadcasted", "timestamp": "2026-03-20T14:34:00Z" },
    { "status": "completed", "timestamp": "2026-03-20T14:35:00Z" }
  ],
  "created_at": "2026-03-20T14:30:00Z",
  "completed_at": "2026-03-20T14:35:00Z"
}
```

### Transaction Statuses

| Status                  | Description                                 |
| ----------------------- | ------------------------------------------- |
| `pending`               | Deposit detected, conversion not started    |
| `processing`            | Conversion in progress                      |
| `in_progress`           | Conversion actively executing               |
| `awaiting_confirmation` | Waiting for blockchain confirmation         |
| `broadcasted`           | Transaction broadcasted to chain            |
| `completed`             | Funds delivered                             |
| `failed`                | Conversion failed                           |
| `rejected`              | Transaction rejected                        |
| `timed_out`             | Transaction timed out                       |
| `canceled`              | Transaction canceled                        |
| `reversed`              | Deposit reversed — funds returned to sender |