Get tips for a post | Fanvue API Documentation

curl https://api.fanvue.com/posts/uuid/tips \
     -H "X-Fanvue-API-Version: 2025-06-26" \
     -H "Authorization: Bearer <token>"

{
  "data": [
    {
      "user": {
        "uuid": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "handle": "sarah-jones",
        "displayName": "Sarah Jones",
        "nickname": "SarahK",
        "isTopSpender": true,
        "avatarUrl": "https://media.fanvue.com/avatars/example-avatar.jpg",
        "registeredAt": "2024-01-10T12:00:00.000Z"
      },
      "createdAt": "2024-01-15T10:30:00.000Z",
      "gross": 500,
      "net": 425
    },
    {
      "user": {
        "uuid": "string",
        "handle": "string",
        "displayName": "string",
        "nickname": "string",
        "isTopSpender": true,
        "avatarUrl": "string",
        "registeredAt": "2024-01-15T09:30:00Z"
      },
      "createdAt": "2024-01-14T18:45:00.000Z",
      "gross": 200,
      "net": 170
    }
  ],
  "pagination": {
    "page": 1,
    "size": 2,
    "hasMore": false
  }
}

Returns a paginated list of tips received on a specific post. Only the post owner can view tips.

Scope required: read:post

Returns a paginated list of tips received on a specific post. Only the post owner can view tips. <Info>Scope required: `read:post`</Info>

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

uuidstringRequiredformat: "uuid"

UUID of the post to retrieve tips for

Headers

X-Fanvue-API-VersionstringRequiredDefaults to 2025-06-26

API version to use for the request

Query parameters

pagedoubleOptional>=1Defaults to 1

Page number to retrieve (starts from 1)

sizedoubleOptional1-50Defaults to 15

Number of items to return per page (1-50, default: 15)

Response

List of tips received on this post

datalist of objects

Array of tips received on this post

paginationobject

Pagination information