API reference
List payments
List payments, newest first, with cursor pagination.
GET
/v1/paymentsQuery parameters
limitinteger- Between 1 and 100. Defaults to 25.
cursorstring- The next_cursor from the previous page.
statusstring- Only payments with this normalized status.
providerstring- Only payments on this provider.
connection_idstring- Only payments on this connection.
external_referencestring- Exact match on your reference.
Request
Response
{
"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. |