Sign in

List a creator's checkout-link refund requests

List the specified creator's refund requests, most recent first, with cursor-based pagination. Filter by status to poll open requests, or by invoiceNumber to see the history for one payment. The payments endpoints carry the same outcome per payment as refundStatus.

<Info> The `checkout_link.refund.requested` and `checkout_link.refund.created` [webhook events](https://api.fanvue.com/docs/checkout/refunds) announce new requests and completed refunds. Rejected, failed, withdrawn and chargebacked outcomes do not emit an event yet, so keep polling this endpoint by `status` to observe those. </Info>
get/creators/{creatorUserUuid}/checkout-links/refund-requests

Path parameters

creatorUserUuidstring uuid required

Query parameters

limitinteger

Number of results to return (default 20, max 100).

Number of results to return (default 20, max 100).

cursorstring

Cursor for pagination, as returned in a previous page's nextCursor.

Cursor for pagination, as returned in a previous page's nextCursor.

status'pending' | 'approved' | 'failed' | 'refunded' | 'rejected' | 'withdrawn' | 'chargebacked'

Filter to requests in this status.

Filter to requests in this status.

invoiceNumberstring

Filter to requests against this exact payment invoice number.

Filter to requests against this exact payment invoice number.

Headers

X-Fanvue-API-Versionstring required
Example:2025-06-26

API version to use for the request

Response

List of refund requests

nextCursorstring nullable required

Cursor for the next page, or null if none.

Changes

Changed in 1 of the 5 revisions of this API.1