v1

latestOpenAPI 3.1.02026-08-0629140119.9 KB

PIX Refunds

List Refunds

Retrieves a paginated list of PIX refunds for the authenticated account. Supports filtering by external_reference_id, original_transaction_id, and cursor-based pagination for efficient data retrieval.

get/v1/refunds

Query parameters

external_reference_idstring nullable

External reference identifier to filter refunds

original_transaction_idinteger nullable

Original transaction identifier to filter refunds (exact match)

limitinteger nullable

Maximum number of refunds to return (1–100, default: 20)

cursorstring nullable

Cursor for pagination (format: timestamp_micros:id)

Response

Refunds retrieved successfully

next_cursorstring nullable

Cursor for the next page of results. If null, there are no more results.

Example response

{
  "refunds": [
    {
      "cancelled_at": "2026-05-28T14:30:00Z",
      "created_at": "2026-05-28T14:30:00Z",
      "updated_at": "2026-05-28T14:30:00Z"
    }
  ]
}