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

# List Transactions

> List all double-entry ledger transactions across all wallets.

## Request Headers

<ParamField header="x-api-key" type="string" required>
  Your live or test API key.
</ParamField>

## Query Parameters

<ParamField query="wallet_id" type="string">
  Filter transactions for a specific wallet.
</ParamField>

<ParamField query="type" type="string">
  Filter by `CREDIT` or `DEBIT`.
</ParamField>

<ParamField query="flag" type="string">
  Filter by AI-generated flags (e.g. `UNDERPAYMENT_DETECTED`).
</ParamField>

<ParamField query="page" type="integer" default="1">
  The page number to retrieve.
</ParamField>

<ParamField query="limit" type="integer" default="20">
  Number of results per page (max 100).
</ParamField>

## Response

<Note>
  All amounts and balances in this endpoint are represented in **kobo** (e.g., `500000` = ₦5,000.00). Ensure you do not send or expect Naira values.
</Note>

<Note>
  **Understanding `status` vs Suspense**: When a transaction status is `PENDING`, it means the transaction is actively processing at the bank network level (like a standard pending transfer). This is **not** the same as the Suspense Queue. Transactions stuck in the Suspense Queue (due to AI confidence or closed wallets) are not returned in this ledger endpoint until they are resolved.
</Note>

<ResponseExample>
  ```json theme={null}
  {
    "success": true,
    "data": {
      "items": [
        {
          "id": "t9c3e8e2-b1c4-48e0-a75d-35e982d6b2c2",
          "wallet_id": "e4b3e8e2-b1c4-48e0-a75d-35e982d6b2c2",
          "developer_id": "d7b3e8e2-b1c4-48e0-a75d-35e982d6b2c2",
          "type": "CREDIT",
          "amount": 2500000,
          "balance_before": 0,
          "balance_after": 2500000,
          "currency": "NGN",
          "status": "SETTLED",
          "nomba_reference": "TXN_ABC123",
          "sender_name": "Tobi Olukoya",
          "sender_account": "0123456789",
          "raw_narration": "Payment for school fees",
          "avenue_intelligence": {
            "raw_narration": "Payment for school fees",
            "extracted_intent": "school fees payment",
            "confidence_score": 0.95,
            "flags": [],
            "suggested_label": "School Fees"
          },
          "created_at": "2026-07-01T12:00:00Z"
        }
      ],
      "total": 1250,
      "page": 1,
      "limit": 20
    }
  }
  ```
</ResponseExample>