Fanvue API Documentation

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

{
  "data": [
    {
      "uuid": "123e4567-e89b-12d3-a456-426614174000",
      "text": "Hey! Thanks for subscribing! Check out my latest exclusive content 🔥",
      "price": 999,
      "mediaUuids": [
        "7c9e6679-7425-40de-944b-e07fc1f90ae7"
      ],
      "folderName": "Welcome Messages"
    },
    {
      "uuid": "123e4567-e89b-12d3-a456-426614174001",
      "text": "Happy Friday! Here's something special just for you 💝",
      "price": null,
      "mediaUuids": [],
      "folderName": "Promotions"
    },
    {
      "uuid": "123e4567-e89b-12d3-a456-426614174002",
      "text": "Check out this exclusive content! Limited time offer 🎁",
      "price": 1499,
      "mediaUuids": [
        "8d9e6679-7425-40de-944b-e07fc1f90ae8",
        "9e9e6679-7425-40de-944b-e07fc1f90ae9"
      ],
      "folderName": "Promotions"
    }
  ],
  "pagination": {
    "page": 1,
    "size": 20,
    "hasMore": false
  }
}

Returns a paginated list of template messages. Optionally filter by folder name using case-insensitive partial matching.

Scope required: read:chat

Returns a paginated list of template messages. Optionally filter by folder name using case-insensitive partial matching. <Info>Scope required: `read:chat`</Info>

Authentication

AuthorizationBearer

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

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)

folderNamestringOptional

Filter by folder name (case-insensitive partial match)

Response

List of template messages

datalist of objects

Array of template messages

paginationobject

Pagination information

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

410

Gone Error

429

Too Many Requests Error