Skip to main content
GET
/
v2
/
access
/
vault
/
lists
/
:listId
/
media
List media in vault list
curl --request GET \
  --url https://api-next.ofauth.com/v2/access/vault/lists/:listId/media \
  --header 'apiKey: <api-key>'
{
  "list": [
    {
      "id": 123,
      "type": "photo",
      "convertedToVideo": true,
      "canView": true,
      "hasError": true,
      "createdAt": "<string>",
      "isReady": true,
      "files": {
        "full": {
          "url": "<string>",
          "width": 123,
          "height": 123,
          "size": 123,
          "sources": [
            "<unknown>"
          ]
        },
        "thumb": {
          "url": "<string>",
          "width": 123,
          "height": 123,
          "size": 123
        },
        "preview": {
          "url": "<string>",
          "width": 123,
          "height": 123,
          "size": 123,
          "options": [
            "<unknown>"
          ]
        },
        "squarePreview": {
          "url": "<string>",
          "width": 123,
          "height": 123,
          "size": 123
        }
      },
      "counters": {
        "likesCount": 123,
        "tipsSumm": 123
      },
      "duration": 123,
      "releaseForms": [
        {
          "id": 123,
          "name": "<string>",
          "partnerSource": "<string>",
          "type": "<string>",
          "user": {
            "view": "<string>",
            "id": 123,
            "name": "<string>",
            "username": "<string>",
            "isVerified": true,
            "avatar": "<string>",
            "avatarThumbs": {
              "c50": "<string>",
              "c144": "<string>"
            },
            "ivStatus": "<string>",
            "isFromGuest": true
          }
        }
      ],
      "hasCustomPreview": true,
      "videoSources": {
        "240": "<string>",
        "720": "<string>"
      }
    }
  ],
  "hasMore": true
}

Authorizations

apiKey
string
header
required

Headers

x-connection-id
string

Connection ID for managed sessions

x-of-user-id
string

OnlyFans user id for direct sessions (optional override)

OnlyFans cookie header for direct sessions (must include auth_id and fp values)

x-of-bc
string

OnlyFans x-bc header for direct sessions (optional override)

x-of-user-agent
string

User agent to use when proxying requests (required when not using x-connection-id)

Path Parameters

listId
number | null

Query Parameters

limit
number
default:24
Required range: 1 <= x <= 40
offset
number
default:0
sortBy
enum<string>
default:recent
Available options:
recent,
most-liked,
highest-tips
sortDirection
enum<string>
default:desc
Available options:
asc,
desc
listId
query
string
mediaType
enum<string>
Available options:
photo,
video,
audio,
gif

Response

Successful response

list
object[]
required
hasMore
boolean
required