List action purchases for one of your experiences
Returns the action purchases fans have made in one of your experiences, newest first, so you can reconcile against the webhooks you received.
**Fulfil on the webhook, never on the bridge result.** Grant the action when you receive `app.experience.action.payment.succeeded`, keyed on `purchase_reference` so a redelivery grants nothing twice. The `purchaseResult` message your iframe receives from Fanvue is UX only — it tells your surface to stop showing a spinner, and it is never proof that money moved. This read is the reconciliation path: poll it when you think you missed a webhook, or to confirm one you are unsure about.
Owner app only: the experience must belong to the app whose credentials make the call, otherwise 403. Purchases belonging to another app are never returned, and a foreign experience uuid is refused before anything about it is read — this is not a way to enumerate experiences, creators or fans.
Every attempt is listed, not only the settled ones, so a `pending` that never landed and a `refunded` purchase are both visible. `amount` is in minor units (cents), frozen at the purchase attempt. Paging is keyset: pass the `nextCursor` from a prior response, and a purchase created while you page never shifts a row onto or off a later page.
get/experiences/{experienceUuid}/action-purchases
Path parameters
experienceUuidstring uuid required
Example:00000000-0000-4000-8000-000000000010
Query parameters
limitinteger
Number of results to return (default 50, max 100).
Number of results to return (default 50, max 100).
cursorstring
Opaque cursor for the next page, from a prior response.
Opaque cursor for the next page, from a prior response.
Headers
X-Fanvue-API-Versionstring required
Example:2025-06-26
API version to use for the request
Response
A page of the experience's action purchases
Example response
{
"data": [
{
"purchaseReference": "expact_5c9a1f0e-9f3f-4c2a-8f31-1d0f6a2b7c44",
"experienceUuid": "00000000-0000-4000-8000-000000000010",
"externalActionId": "spin",
"clientReferenceId": "round-42",
"buyerUuid": "00000000-0000-4000-8000-000000000003",
"amount": 700,
"currency": "USD",
"invoiceNumber": "FVE-20260904-1234",
"createdAt": "2026-09-04T10:00:00.000Z",
"paidAt": "2026-09-04T10:00:02.000Z"
}
]
}