Skip to main content
GET
/
vault
/
folders
/
{folderName}
/
media
List media in folder
curl --request GET \
  --url https://api.example.com/vault/folders/{folderName}/media \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Fanvue-API-Version: <x-fanvue-api-version>'
{
  "data": [
    {
      "uuid": "550e8400-e29b-41d4-a716-446655440000",
      "name": "photo1.jpg",
      "createdAt": "2025-01-15T10:30:00.000Z",
      "mediaType": "image"
    },
    {
      "uuid": "550e8400-e29b-41d4-a716-446655440001",
      "name": "video1.mp4",
      "createdAt": "2025-01-16T14:20:00.000Z",
      "mediaType": "video"
    }
  ],
  "pagination": {
    "page": 1,
    "size": 20,
    "hasMore": true
  }
}
Required scope
  • read:media — Access media files, images, videos, and other content assets.

Authorizations

​
Authorization
string
header
required

OAuth 2.0 access token, presented as a JWT bearer token in the Authorization header. Obtain a token via the authorization-code flow; the scopes granted to the token determine which operations it may call.

Headers

​
X-Fanvue-API-Version
string
default:2025-06-26
required

API version to use for the request

Example:

"2025-06-26"

Path Parameters

​
folderName
string
required

Folder name (URL-encoded in path)

Required string length: 1 - 255

Query Parameters

​
page
number
default:1

Page number to retrieve (starts from 1)

Required range: x >= 1
​
size
number
default:15

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

Required range: 1 <= x <= 50

Response

List of media in folder

​
data
object[]
required

Array of media items

​
pagination
object
required

Pagination information