> For the complete documentation index, see [llms.txt](https://pivot-payment.gitbook.io/pivot-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pivot-payment.gitbook.io/pivot-docs/api-references/api-lists/account-and-balance/transfer/list-of-transfer.md).

# List of Transfer

Get a Collection of transfer details

## Method and URL

<mark style="color:green;">`GET`</mark> \[<mark style="color:orange;">BASE\_URL</mark>]/v1/transfers?referenceId={referenceId}

{% hint style="info" %} <mark style="color:orange;">`referenceId`</mark> is optional.&#x20;

With <mark style="color:orange;">`referenceId`</mark> Provided, the response will return an array of data containing a single transfer with an exact match reference ID
{% endhint %}

## Query Param

| Key       | Value                                                                                                      |
| --------- | ---------------------------------------------------------------------------------------------------------- |
| startDate | Start date with format YYYY-MM-DDTHH:MM:SSZ, default is the last 7 days                                    |
| endDate   | End date with format YYYY-MM-DDTHH:MM:SSZ, default is the last 7 days                                      |
| page      | Page to be shown                                                                                           |
| perPage   | <p>Total records to be shown per page</p><p></p><p>Maximum 100 records per page, default is 20 records</p> |

## Response

**Response Body**

{% code fullWidth="false" %}

```json
{
    "code": "00",
    "message": "Success",
    "data": [
        {
            "uuid": "8uh7-n332-9vst-l2c1",
            "referenceId": "PAY/trf-0109332",
            "recipientId": "u734-981324saf-53tu",
            "amount": 10000,
            "remarks": "transfer for coffeeshop",
            "transferType": "DIRECT",
            "status": "SUCCESS",
            "transaction_timestamp": "2024-05-13T08:21:44.967496538Z",
            "created": "2024-05-13T08:21:44.967496538Z",
            "updated": "2024-05-13T08:21:44.967496538Z"
        },
        // more transfer items
    ],
    "pagination": {
        "page": 1,
        "perPage": 10,
        "totalPage": 10,
        "totalData": 100
    }
}
```

{% endcode %}

**Detail Parameter Response**

<table><thead><tr><th>Parameter</th><th width="127.869140625">Data Type</th><th width="141.44921875">Requirement</th><th>Description</th></tr></thead><tbody><tr><td>code</td><td>String</td><td>M</td><td>Response Code from Pivot</td></tr><tr><td>message</td><td>String</td><td>M</td><td>Human readable message that represent response from Pivot</td></tr><tr><td>data</td><td>Object</td><td>M</td><td>Response Data from Pivot contains list of <a data-mention href="/pivot-docs/api-references/api-lists/account-and-balance/transfer/transfer-object.md">Transfer Object</a></td></tr><tr><td>pagination</td><td>Object</td><td>M</td><td><a data-mention href="/pivot-docs/api-references/api-information/pagination.md">Pagination</a></td></tr></tbody></table>