> For the complete documentation index, see [llms.txt](https://6dot50.gitbook.io/6dot50-apis/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://6dot50.gitbook.io/6dot50-apis/list-payments/get-payments.md).

# GET /payments

Returns an array of Payments. This operation is useful if you wish to search for a Payment by merchant reference, between dates, or by status code.

### Request

Ensure the bearer token is included in the Header of the GET operation:

<table><thead><tr><th width="201.33333333333331">Header</th><th width="128">Mandatory</th><th>Description</th></tr></thead><tbody><tr><td><code>Authorization</code></td><td>Yes</td><td>Bearer token from <a href="/6dot50-apis/redemptions-api/authentication/post-authentication-gettoken.md">/authentication/getToken</a></td></tr></tbody></table>

<table><thead><tr><th width="200">Parameter</th><th width="177">Type</th><th width="118">Mandatory</th><th>Description</th></tr></thead><tbody><tr><td><code>reference</code></td><td>string</td><td>No</td><td>Filter by your Merchant reference</td></tr><tr><td><code>statusCode</code></td><td>Int</td><td>No</td><td>Filter by payment status code (see Payment Status Codes for valid values)</td></tr><tr><td><code>errorCode</code></td><td>int</td><td>No</td><td>Filter by payment error result code (see Payment Error Codes for valid values)</td></tr><tr><td><code>createdAtFrom</code></td><td>string($date-time)</td><td>No</td><td>Show payments by their created date from a specific date and time</td></tr><tr><td><code>createdAtTo</code></td><td>string($date-time)</td><td>No</td><td>Show payments by their created date to a specific date and time</td></tr><tr><td><code>completedAtFrom</code></td><td>string($date-time)</td><td>No</td><td>Show payments by their completed date from a specific date and time</td></tr><tr><td><code>completedAtTo</code></td><td>string($date-time)</td><td>No</td><td>Show payments by their completed date to a specific date and time</td></tr><tr><td><code>skip</code></td><td>int</td><td>No</td><td>Items to skip when searching</td></tr><tr><td><code>take</code></td><td>int</td><td>No</td><td>Items to take when searching</td></tr></tbody></table>

### Response

If successful, the operation will return with an array of standard Payment models (ordered by `createdAt` descending):

```
[
  {
    "id": "string($guid)",
    "reference": "string",
    "amount": "string",
    "accountId": "string($guid)",
    "currencyCode": "string",
    "statusCode": int,
    "statusMessage": "string",
    "errorCode": int,
    "errorMessage": "string",
    "createdAt": "string($date-time)",
    "completedAt": " string($date-time)",
    "countryCode": "string",
    "returnUrl": "string"
  }
]
```

Field values and types for each Payment are the same as described in [Payment Status](/6dot50-apis/user-payment-pages/payment-status.md).