# List payments

> List payments, newest first, with cursor pagination.

`GET https://api.camelpayment.com/v1/payments`

## Query parameters

- `limit` (integer): Between 1 and 100. Defaults to 25.
- `cursor` (string): The next_cursor from the previous page.
- `status` (string): Only payments with this normalized status.
- `provider` (string): Only payments on this provider.
- `connection_id` (string): Only payments on this connection.
- `external_reference` (string): Exact match on your reference.

## Request

**cURL**

```bash
curl https://api.camelpayment.com/v1/payments?limit=10&status=approved \
  -H "Authorization: Bearer $CAMEL_API_KEY"
```

**Node.js**

```javascript
const response = await fetch('https://api.camelpayment.com/v1/payments?limit=10&status=approved', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.CAMEL_API_KEY}`
  }
});
const data = await response.json();
```

**Python**

```python
import os
import requests

response = requests.get(
    "https://api.camelpayment.com/v1/payments?limit=10&status=approved",
    headers={
        "Authorization": f"Bearer {os.environ['CAMEL_API_KEY']}",
    },
)
data = response.json()
```

## Response

**200**

```json
{
  "data": [
    {
      "id": "pay_01JBX7Q2M4N8K5R6T9V3W1Y0ZA",
      "object": "payment",
      "provider": "mercadopago",
      "connection_id": "con_01JBX7P8H2D4F6G8J0K2M4N6QR",
      "provider_payment_id": "1342345678",
      "amount": 1500000,
      "currency": "ARS",
      "conversion": null,
      "usd_amount": 971,
      "status": "approved",
      "provider_status": "approved",
      "description": "Order #1524",
      "external_reference": "ORDER-1524",
      "payment_method": {
        "type": "card",
        "brand": "visa",
        "last4": "4242"
      },
      "failure": null,
      "metadata": {
        "order_id": "1524"
      },
      "next_action": null,
      "created_at": "2026-11-12T15:04:05Z",
      "updated_at": "2026-11-12T15:04:07Z"
    }
  ],
  "next_cursor": "WyIyMDI2LTExLTEyVDE1OjA0OjA1WiIsInBheV8wMUpCWDdRMk00TjhLNVI2VDlWM1cxWTBaQSJd"
}
```

## Errors

| Status | When |
| --- | --- |
| `400` | The cursor is not valid. |
| `401` | The API key is missing, malformed, or revoked. |
| `429` | Too many requests. Wait for Retry-After seconds. |
