# Get a list of payments

Retrieve a list of payments matching a specified reference to view related payment information, without [using a payment ID or session ID](https://www.checkout.com/docs/payments/manage-payments/get-payment-details.md).

> **Note**
>
> This endpoint has a limit of 1000 records. To query larger result sets, you must [Search and filter payments](https://www.checkout.com/docs/payments/manage-payments/search-and-filter-payments.md).

Use the following details to set up your request.

## Endpoints

> **Information**
>
> Your base URL's `{prefix}` value is unique to your account and environment. To learn how to retrieve your base URLs for the sandbox and production environments, see [API endpoints](https://www.checkout.com/docs/developer-resources/api/api-endpoints.md).

**Production**

`GET` `https://{prefix}.api.checkout.com/payments`

**Sandbox**

`GET` `https://{prefix}.api.sandbox.checkout.com/payments`

---

## Query parameters

You can use the following query parameters to filter and refine your search query:

| Parameter | Description |
| --- | --- |
| `reference` | The payment reference to search for. This query parameter is required. |
| `limit` | The number of results to retrieve. The maximum value is `100`. If no value is specified, `10` is used by default. |
| `skip` | The number of results to skip in the returned list of payments.<br><br>Use this for result pagination. For example, if you perform a query and specify `limit=100`, a maximum of 100 results will be returned in the initial request. If there are more than 100 matches for the query, you can include `skip=100` in a subsequent request to retrieve the next page of results. |

---

## Authentication

Requests to the endpoint must be authenticated by providing your [access key (OAuth 2.0)](https://www.checkout.com/docs/resources/api-authentication/oauth-2-0-client-credentials.md) or [API key](https://www.checkout.com/docs/resources/api-authentication/api-keys.md) in the request's Authorization header.

```bash
--header 'Authorization: Bearer <token>'
```

---

## Request example

```bash
curl --location --request GET 'https://{prefix}.api.sandbox.checkout.com/payments?limit=10&skip=0&reference=ORD-5023-4E89' \
--header 'Authorization: Bearer sk_sbox_wjvrysklsqjmrhn3yoexnshsl72'
```

---

## Response example

The results are sorted by processing date in descending order.

```json
{
  "limit": 10,
  "skip": 0,
  "total_count": 1,
  "data": [
    {
      "id": "pay_einf5abzzgbejdpuartvqgl36i",
      "requested_on": "2022-04-14T17:03:10.103019Z",
      "source": {
        "type": "card",
        "expiry_month": 11,
        "expiry_year": 2024,
        "scheme": "Visa",
        "last4": "7526",
        "fingerprint": "F2FFA3967396478A7EB64FE6E0A2384F230C23A2F7E520D27EDBB46F24E5B922",
        "bin": "482028",
        "card_type": "CREDIT",
        "card_category": "CONSUMER",
        "issuer": "Test Bank",
        "issuer_country": "US",
        "product_id": "N1",
        "product_type": "Visa Rewards"
      },
      "amount": 1000,
      "currency": "EUR",
      "payment_type": "Recurring",
      "reference": "ORD-5023-4E89",
      "description": "Set of 3 masks",
      "status": "Declined",
      "approved": false,
      "3ds": {
        "downgraded": false,
        "enrolled": "N"
      },
      "risk": {
        "flagged": false,
        "score": 0
      },
      "metadata": {
        "udf1": "TEST123",
        "coupon_code": "NY2024",
        "partner_id": "123989"
      },
      "_links": {
        "self": {
          "href": "https://{prefix}.api.sandbox.checkout.com/payments/pay_einf5abzzgbejdpuartvqgl36i"
        },
        "actions": {
          "href": "https://{prefix}.api.sandbox.checkout.com/payments/pay_einf5abzzgbejdpuartvqgl36i/actions"
        }
      }
    }
  ]
}
```