Docs
Search the docs
Find a page in the docs

API reference

List payments

List payments, newest first, with cursor pagination.

GET /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 https://api.camelpayment.com/v1/payments?limit=10&status=approved \
  -H "Authorization: Bearer $CAMEL_API_KEY"

Response

200
{
  "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

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