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

# Transactions

> Fetch real-time transaction feeds for a session.

## List transactions

**GET** `/v1/transactions`

Returns all transactions for a session, ordered by most recent first.

<ParamField query="session_id" type="string" required>
  The session to fetch transactions for.
</ParamField>

<ParamField query="limit" type="number" default="50">
  Max number of results to return.
</ParamField>

<ParamField query="offset" type="number" default="0">
  Number of results to skip (for pagination).
</ParamField>

<RequestExample>
  ```bash theme={null}
  curl "https://api.kler.africa/v1/transactions?session_id=3f1e2d..." \
    -H "x-api-key: YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": [
      {
        "id": "txn_...",
        "session_id": "3f1e2d...",
        "amount": "5000.00",
        "currency": "NGN",
        "channel": "bank_transfer",
        "status": "successful",
        "sender_name": "John Doe",
        "sender_account": "0123456789",
        "sender_bank": "058",
        "narration": "Ticket payment",
        "providus_ref": "PVS20250801XXXXXXX",
        "paid_at": "2025-08-01T18:32:00.000Z",
        "created_at": "2025-08-01T18:32:01.000Z"
      }
    ]
  }
  ```
</ResponseExample>

***

## Get transaction

**GET** `/v1/transactions/:id`

<RequestExample>
  ```bash theme={null}
  curl https://api.kler.africa/v1/transactions/txn_... \
    -H "x-api-key: YOUR_API_KEY"
  ```
</RequestExample>