# 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="../redemptions-api/authentication/post-authentication-gettoken">/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](https://6dot50.gitbook.io/6dot50-apis/user-payment-pages/payment-status).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://6dot50.gitbook.io/6dot50-apis/list-payments/get-payments.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.