---
title: "List an experience's priced actions"
method: GET
path: "/experiences/{experienceUuid}/actions"
---

# List an experience's priced actions

`GET /experiences/{experienceUuid}/actions`

Returns the priced actions the creator has configured on one of your experiences, so your surface can render its own buttons with the real price — "Spin — $7" — instead of guessing.

    Owner app only: the experience must belong to the app whose credentials make the call, otherwise 403. Actions the creator has withdrawn are omitted.

    `amount` is in minor units (cents) and is resolved from Fanvue on every request, so a re-priced action is correct on the next read with no republish. An empty `actions` array means the creator has priced nothing; a failure to read the catalogue is a 502, never an empty list.

## Path parameters

- `experienceUuid` string, uuid, required

## Headers

- `X-Fanvue-API-Version` string, required

## Response `200`

The experience's active priced actions

- object
  - `actions` object[], required — The experience's active priced actions, in the order the creator arranged them.
    - `externalActionId` string, required — The app's own stable key for the action, as it declared it.
    - `title` string, required — Creator-facing label, shown in the native payment dialog.
    - `status` 'active', required — Always `active`. An action the creator has withdrawn is omitted from this read entirely, never returned as disabled.
    - `amount` integer, required — Price in minor currency units (cents), resolved from Fanvue at read time. Re-pricing is visible on the next read.
    - `currency` string, required — ISO 4217 code of the amount. USD only today.

## Other responses

- `400` — Bad Request - API version not supported OR validation failed OR invalid UUID
- `401` — Unauthorized Response
- `403` — Unauthorized Response
- `404` — Experience not found
- `410` — API version no longer supported (sunset)
- `429` — Too many requests - rate limit exceeded
- `502` — Failed to read the action catalogue from the upstream
- `503` — Developer API upstream is not configured

## Changes

- **2026-09-10** `4d08f36ad6c8` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/fanvue/apis/fanvue-api/changes/experiences/:experienceUuid/actions/get.md)

---

[API](https://skmtc.dev/fanvue/apis/fanvue-api.md) · [All operations](https://skmtc.dev/fanvue/apis/fanvue-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fanvue/apis/fanvue-api/revisions/431868e8a264?raw)