> For the complete documentation index, see [llms.txt](https://moneywave.gitbook.io/doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://moneywave.gitbook.io/doc/transaction-reporting/search-list.md).

# Search / List

Transaction listing and search using specified parameters are available using the API below. Data is returned with meta providing total number of records found, current page and the set limit per page.

<mark style="color:blue;">`GET`</mark> `https://staging.moneywaveapp.com/v1/report/transactions`

#### Query Parameters

| Name     | Type   | Description                                                                                     |
| -------- | ------ | ----------------------------------------------------------------------------------------------- |
| page     | string | Specify a report page                                                                           |
| limit    | string | Specify transactions limit per page                                                             |
| date     | string | Transaction date filter specified a single date 2019-03-19 or date range 2018-12-19--2019-01-10 |
| status   | string | Transaction status filter                                                                       |
| amount   | string | Transaction amount filter                                                                       |
| ref      | string | Your transaction reference                                                                      |
| flwref   | string | Flutterwave transaction reference                                                               |
| currency | string | Transaction currency filter                                                                     |
| type     | string | Transacion type specified as Credit or Debit                                                    |
| wallet   | string | Balance ID filter, for transactions related to the specified balance only.                      |

#### Headers

| Name          | Type   | Description         |
| ------------- | ------ | ------------------- |
| Authorization | string | Authorization Token |

{% tabs %}
{% tab title="200 " %}

```
{
    "status": "success",
    "data": [
        {
            "id": 1,
            "amount": 500,
            "fee": null,
            "status": "completed",
            "system_type": "wallet-fund",
            "source": "card",
            "source_id": 810,
            "dest": "wallet",
            "dest_id": 1,
            "ref": null,
            "flutterResponseMessage": null,
            "flutterResponseCode": null,
            "flutterReference": null,
            "linkingReference": null,
            "disburseOrderId": null,
            "createdAt": "2016-11-23T14:34:50.000Z",
            "currencyId": 1,
            "walletCharged": null,
            "refund": null,
            "reversed": null
        },
        {
        ...
        },
        {
            "id": 432131,
            "amount": 10,
            "fee": 25,
            "status": "failed",
            "system_type": "wallet-disburse",
            "source": "wallet",
            "source_id": 331,
            "dest": "beneficiary",
            "dest_id": null,
            "ref": null,
            "flutterResponseMessage": "Not enough wallet balance",
            "flutterResponseCode": "CF",
            "flutterReference": null,
            "linkingReference": null,
            "disburseOrderId": 38684,
            "createdAt": "2017-08-10T06:54:42.000Z",
            "currencyId": 3,
            "walletCharged": null,
            "refund": null,
            "reversed": null
        }
    ],
    "meta": {
        "count": 500,
        "page": 1,
        "limit": 100
    }
}
```

{% endtab %}
{% endtabs %}

{% hint style="success" %}
**Successful Beneficiary Payouts** have their signature as -\
*status : completed, system\_type : wallet-disburse, dest : beneficiary, walletCharged: true, reversed : false, and refund : false.*
{% endhint %}

{% hint style="info" %}
**Balance Debit Parameter Definitions**

*`walletCharged`*  -  this flag indicates a debit has been successfully passed to the balance specified when requesting a disbursement.

*`reversed`* - indicates a previously successful transaction that has been returned. Note two transactions would  exist, the disburse transaction with its reversed flag set as true,  and a funding transaction to return the funds.

*`refund`* - indicates a failed transaction for which debit had occurred but processing failed. when this value is true, it means funds have been returned. There would be only one transaction, the failed disbursement request with the refund flag set as  true.
{% endhint %}