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

# List transactions

> List transactions for reconciliation and support.

Retrieve transaction history for receipts, customer support, and reconciliation. Results are paginated and contain only customer-facing transaction details.

## Parameters

<ParamField query="page" type="number">
  Page number. Defaults to `1`.
</ParamField>

<ParamField query="limit" type="number">
  Number of transactions per page. Defaults to `20`, maximum `100`.
</ParamField>

<ParamField query="search" type="string">
  Search by reference, product, provider, customer, status, remark, or amount.
</ParamField>

<ParamField query="reference" type="string">
  Return a specific transaction reference.
</ParamField>

<ParamField query="startDate" type="string">
  Include transactions created on or after this date. Use `YYYY-MM-DD`.
</ParamField>

<ParamField query="endDate" type="string">
  Include transactions created on or before this date. Use `YYYY-MM-DD`.
</ParamField>

## Request

```http theme={null}
GET /api/v2/account/transactions?page=1&limit=20
Authorization: Bearer YOUR_API_KEY
```

## Successful response

```json theme={null}
{
  "status": true,
  "message": "Transactions fetched successfully.",
  "data": {
    "transactions": [
      {
        "reference": "merchant-ref-20260812001",
        "service": "data",
        "product_name": "mtn-share-weekly-1gb",
        "provider": "MTN",
        "customer_id": "08030000000",
        "paid_amount": 400,
        "transaction_status": "successful",
        "created_at": "2026-08-12T10:30:00.000Z"
      }
    ],
    "pagination": {
      "total": 1,
      "page": 1,
      "limit": 20,
      "totalPages": 1
    }
  }
}
```

## Failed response

```json theme={null}
{
  "status": false,
  "message": "Error message"
}
```