Skip to main content
The List Payments endpoint returns a cursor-paginated collection of payments associated with your account. You can narrow the result set using any combination of the available query filters — such as status, currency, or a creation date range — and control page size with the limit parameter. Results are returned in reverse chronological order by default, with the most recently created payments first.

​
Query Parameters

​
limit
integer
Number of payment records to return per page. Accepts values between 1 and 100. Defaults to 20.
​
cursor
string
Opaque pagination cursor returned in a previous response’s pagination.cursor field. Pass this value to retrieve the next page of results.
​
status
string
Filter payments by their current lifecycle status. Accepted values: pending, processing, settled, delivered, failed, cancelled.
​
currency
string
Filter payments by source stablecoin. Accepted values: USDC, USDT, EURC, PYUSD.
​
corridor
string
Filter payments by corridor identifier (e.g., US-EU, US-MX).
​
created_after
string
Return only payments created after this ISO 8601 datetime (e.g., 2024-01-01T00:00:00Z). The timestamp is inclusive.
​
created_before
string
Return only payments created before this ISO 8601 datetime. The timestamp is exclusive.
​
order
string
Sort order for results based on created_at. Accepted values: asc, desc. Defaults to desc.

​
Response

​
data
array
An array of payment objects matching your query. Each object has the same structure as a single payment returned by GET /payments/{id}. Returns an empty array if no payments match the filters.
​
pagination
object
Metadata for navigating through result pages.

​
Examples

curl "https://api.remitflex.com/v1/payments?status=delivered&limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": [
    {
      "id": "pmt_01HX4N3RABCDEF",
      "status": "delivered",
      "amount": 500,
      "currency": "USDC",
      "destination_currency": "EUR",
      "converted_amount": 461.25,
      "exchange_rate": 0.9225,
      "fee": 2.50,
      "corridor": "US-EU",
      "recipient": {
        "name": "Maria Garcia",
        "account_number": "ES9121000418401234567891",
        "bank_country": "ES"
      },
      "reference": "Invoice #INV-2024-001",
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-15T14:28:11Z",
      "estimated_delivery": "2024-01-15T14:30:00Z"
    }
  ],
  "pagination": {
    "cursor": "cur_01HX5P9TGHIJKL",
    "has_more": true,
    "total": 284
  }
}

​
Paginating Through Results

To retrieve subsequent pages, pass the cursor value from the previous response as a query parameter. Continue until pagination.has_more is false. 
curl "https://api.remitflex.com/v1/payments?status=delivered&limit=50&cursor=cur_01HX5P9TGHIJKL" \
  -H "Authorization: Bearer YOUR_API_KEY"