KIkiwify
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

Request

  • Base URL
    https://conta-public-api.kiwify.com
  • URL
    https://conta-public-api.kiwify.com/v1/refunds
  • Auth
    API key in header x-access-id and API key in header X-PoP-Challenge and API key in header X-PoP-Format and API key in header X-PoP-Signature

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"
    }
  ]
}

Changes

No recorded changes to this operation across all 3 revisions of this API.