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

nextCursorstring nullable required

Cursor for the next page, or null if none.

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

Changes

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