Skip to main content
GET
/
api
/
{account}
/
media
/
vault
List Vault Media
curl --request GET \
  --url https://app.onlyfansapi.com/api/{account}/media/vault \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "list": [
      {
        "id": 123,
        "type": "audio",
        "convertedToVideo": false,
        "canView": true,
        "hasError": false,
        "createdAt": "2025-01-01T00:00:00+00:00",
        "isReady": true,
        "counters": {
          "likesCount": 0,
          "tipsSumm": 0
        },
        "files": {
          "full": {
            "url": "https://cdn2.onlyfans.com/files/...",
            "width": 0,
            "height": 0,
            "size": 0,
            "sources": []
          },
          "thumb": null,
          "preview": null,
          "squarePreview": null
        },
        "duration": 3,
        "hasPosts": false,
        "listStates": [
          {
            "id": 123,
            "type": "posts",
            "name": "Posts",
            "hasMedia": false,
            "canAddMedia": false
          },
          {
            "id": 123,
            "type": "stories",
            "name": "Stories",
            "hasMedia": false,
            "canAddMedia": false
          },
          {
            "id": 123,
            "type": "messages",
            "name": "Messages",
            "hasMedia": true,
            "canAddMedia": false
          },
          {
            "id": 123,
            "type": "streams",
            "name": "Streams",
            "hasMedia": false,
            "canAddMedia": false
          },
          {
            "id": 123,
            "type": "custom",
            "name": "custom category",
            "hasMedia": false,
            "canAddMedia": true
          },
          {
            "id": 123,
            "type": "media_stickers",
            "name": "Uploads",
            "hasMedia": false,
            "canAddMedia": false
          }
        ],
        "releaseForms": [],
        "hasCustomPreview": false,
        "videoSources": {
          "240": null,
          "720": null
        }
      },
      {
        "id": 123,
        "type": "audio",
        "convertedToVideo": false,
        "canView": true,
        "hasError": false,
        "createdAt": "2025-01-01T00:00:00+00:00",
        "isReady": true,
        "counters": {
          "likesCount": 0,
          "tipsSumm": 0
        },
        "files": {
          "full": {
            "url": "https://cdn2.onlyfans.com/files/...",
            "width": 0,
            "height": 0,
            "size": 0,
            "sources": []
          },
          "thumb": null,
          "preview": null,
          "squarePreview": null
        },
        "duration": 3,
        "hasPosts": false,
        "listStates": [
          {
            "id": 123,
            "type": "posts",
            "name": "Posts",
            "hasMedia": false,
            "canAddMedia": false
          },
          {
            "id": 123,
            "type": "stories",
            "name": "Stories",
            "hasMedia": false,
            "canAddMedia": false
          },
          {
            "id": 123,
            "type": "messages",
            "name": "Messages",
            "hasMedia": true,
            "canAddMedia": false
          },
          {
            "id": 123,
            "type": "streams",
            "name": "Streams",
            "hasMedia": false,
            "canAddMedia": false
          },
          {
            "id": 123,
            "type": "custom",
            "name": "custom category",
            "hasMedia": false,
            "canAddMedia": true
          },
          {
            "id": 123,
            "type": "media_stickers",
            "name": "Uploads",
            "hasMedia": false,
            "canAddMedia": false
          }
        ],
        "releaseForms": [],
        "hasCustomPreview": false,
        "videoSources": {
          "240": null,
          "720": null
        }
      },
      {
        "id": 123,
        "type": "photo",
        "convertedToVideo": false,
        "canView": true,
        "hasError": false,
        "createdAt": "2025-01-01T00:00:00+00:00",
        "isReady": true,
        "counters": {
          "likesCount": 0,
          "tipsSumm": 0
        },
        "files": {
          "full": {
            "url": "https://cdn2.onlyfans.com/files/...",
            "width": 2048,
            "height": 1360,
            "size": 0,
            "sources": []
          },
          "thumb": {
            "url": "https://cdn2.onlyfans.com/files/...",
            "width": 300,
            "height": 300,
            "size": 0
          },
          "preview": {
            "url": "https://cdn2.onlyfans.com/files/...",
            "width": 960,
            "height": 638,
            "size": 0
          },
          "squarePreview": {
            "url": "https://cdn2.onlyfans.com/files/...",
            "width": 960,
            "height": 960,
            "size": 0
          }
        },
        "duration": 0,
        "hasPosts": false,
        "listStates": [
          {
            "id": 123,
            "type": "posts",
            "name": "Posts",
            "hasMedia": true,
            "canAddMedia": false
          },
          {
            "id": 123,
            "type": "stories",
            "name": "Stories",
            "hasMedia": false,
            "canAddMedia": false
          },
          {
            "id": 123,
            "type": "messages",
            "name": "Messages",
            "hasMedia": false,
            "canAddMedia": false
          },
          {
            "id": 123,
            "type": "streams",
            "name": "Streams",
            "hasMedia": false,
            "canAddMedia": false
          },
          {
            "id": 123,
            "type": "custom",
            "name": "custom category",
            "hasMedia": false,
            "canAddMedia": true
          },
          {
            "id": 123,
            "type": "media_stickers",
            "name": "Uploads",
            "hasMedia": false,
            "canAddMedia": false
          }
        ],
        "releaseForms": [],
        "hasCustomPreview": false,
        "videoSources": {
          "240": null,
          "720": null
        }
      },
      {
        "id": 123,
        "type": "photo",
        "convertedToVideo": false,
        "canView": true,
        "hasError": false,
        "createdAt": "2025-01-01T00:00:00+00:00",
        "isReady": true,
        "counters": {
          "likesCount": 0,
          "tipsSumm": 0
        },
        "files": {
          "full": {
            "url": "https://cdn2.onlyfans.com/files/...",
            "width": 2048,
            "height": 1360,
            "size": 0,
            "sources": []
          },
          "thumb": {
            "url": "https://cdn2.onlyfans.com/files/...",
            "width": 300,
            "height": 300,
            "size": 0
          },
          "preview": {
            "url": "https://cdn2.onlyfans.com/files/...",
            "width": 960,
            "height": 638,
            "size": 0
          },
          "squarePreview": {
            "url": "https://cdn2.onlyfans.com/files/...",
            "width": 960,
            "height": 960,
            "size": 0
          }
        },
        "duration": 0,
        "hasPosts": false,
        "listStates": [
          {
            "id": 123,
            "type": "posts",
            "name": "Posts",
            "hasMedia": true,
            "canAddMedia": false
          },
          {
            "id": 123,
            "type": "stories",
            "name": "Stories",
            "hasMedia": false,
            "canAddMedia": false
          },
          {
            "id": 123,
            "type": "messages",
            "name": "Messages",
            "hasMedia": false,
            "canAddMedia": false
          },
          {
            "id": 123,
            "type": "streams",
            "name": "Streams",
            "hasMedia": false,
            "canAddMedia": false
          },
          {
            "id": 123,
            "type": "custom",
            "name": "custom category",
            "hasMedia": false,
            "canAddMedia": true
          },
          {
            "id": 123,
            "type": "media_stickers",
            "name": "Uploads",
            "hasMedia": false,
            "canAddMedia": false
          }
        ],
        "releaseForms": [],
        "hasCustomPreview": false,
        "videoSources": {
          "240": null,
          "720": null
        }
      },
      {
        "id": 123,
        "type": "photo",
        "convertedToVideo": false,
        "canView": true,
        "hasError": false,
        "createdAt": "2025-01-01T00:00:00+00:00",
        "isReady": true,
        "counters": {
          "likesCount": 0,
          "tipsSumm": 0
        },
        "files": {
          "full": {
            "url": "https://cdn2.onlyfans.com/files/...",
            "width": 1629,
            "height": 1629,
            "size": 0,
            "sources": []
          },
          "thumb": {
            "url": "https://cdn2.onlyfans.com/files/...",
            "width": 300,
            "height": 300,
            "size": 0
          },
          "preview": {
            "url": "https://cdn2.onlyfans.com/files/...",
            "width": 960,
            "height": 960,
            "size": 0
          },
          "squarePreview": {
            "url": "https://cdn2.onlyfans.com/files/...",
            "width": 960,
            "height": 960,
            "size": 0
          }
        },
        "duration": 0,
        "hasPosts": false,
        "listStates": [
          {
            "id": 123,
            "type": "posts",
            "name": "Posts",
            "hasMedia": false,
            "canAddMedia": false
          },
          {
            "id": 123,
            "type": "stories",
            "name": "Stories",
            "hasMedia": false,
            "canAddMedia": false
          },
          {
            "id": 123,
            "type": "messages",
            "name": "Messages",
            "hasMedia": true,
            "canAddMedia": false
          },
          {
            "id": 123,
            "type": "streams",
            "name": "Streams",
            "hasMedia": false,
            "canAddMedia": false
          },
          {
            "id": 123,
            "type": "custom",
            "name": "custom category",
            "hasMedia": false,
            "canAddMedia": true
          },
          {
            "id": 123,
            "type": "media_stickers",
            "name": "Uploads",
            "hasMedia": false,
            "canAddMedia": false
          }
        ],
        "releaseForms": [],
        "hasCustomPreview": false,
        "videoSources": {
          "240": null,
          "720": null
        }
      },
      {
        "id": 123,
        "type": "photo",
        "convertedToVideo": false,
        "canView": true,
        "hasError": false,
        "createdAt": "2025-01-01T00:00:00+00:00",
        "isReady": true,
        "counters": {
          "likesCount": 0,
          "tipsSumm": 0
        },
        "files": {
          "full": {
            "url": "https://cdn2.onlyfans.com/files/...",
            "width": 1629,
            "height": 1629,
            "size": 0,
            "sources": []
          },
          "thumb": {
            "url": "https://cdn2.onlyfans.com/files/...",
            "width": 300,
            "height": 300,
            "size": 0
          },
          "preview": {
            "url": "https://cdn2.onlyfans.com/files/...",
            "width": 960,
            "height": 960,
            "size": 0
          },
          "squarePreview": {
            "url": "https://cdn2.onlyfans.com/files/...",
            "width": 960,
            "height": 960,
            "size": 0
          }
        },
        "duration": 0,
        "hasPosts": false,
        "listStates": [
          {
            "id": 123,
            "type": "posts",
            "name": "Posts",
            "hasMedia": true,
            "canAddMedia": false
          },
          {
            "id": 123,
            "type": "stories",
            "name": "Stories",
            "hasMedia": false,
            "canAddMedia": false
          },
          {
            "id": 123,
            "type": "messages",
            "name": "Messages",
            "hasMedia": false,
            "canAddMedia": false
          },
          {
            "id": 123,
            "type": "streams",
            "name": "Streams",
            "hasMedia": false,
            "canAddMedia": false
          },
          {
            "id": 123,
            "type": "custom",
            "name": "custom category",
            "hasMedia": false,
            "canAddMedia": true
          },
          {
            "id": 123,
            "type": "media_stickers",
            "name": "Uploads",
            "hasMedia": false,
            "canAddMedia": false
          }
        ],
        "releaseForms": [],
        "hasCustomPreview": false,
        "videoSources": {
          "240": null,
          "720": null
        }
      },
      {
        "id": 123,
        "type": "photo",
        "convertedToVideo": false,
        "canView": true,
        "hasError": false,
        "createdAt": "2025-01-01T00:00:00+00:00",
        "isReady": true,
        "counters": {
          "likesCount": 0,
          "tipsSumm": 0
        },
        "files": {
          "full": {
            "url": "https://cdn2.onlyfans.com/files/...",
            "width": 1629,
            "height": 1629,
            "size": 0,
            "sources": []
          },
          "thumb": {
            "url": "https://cdn2.onlyfans.com/files/...",
            "width": 300,
            "height": 300,
            "size": 0
          },
          "preview": {
            "url": "https://cdn2.onlyfans.com/files/...",
            "width": 960,
            "height": 960,
            "size": 0
          },
          "squarePreview": {
            "url": "https://cdn2.onlyfans.com/files/...",
            "width": 960,
            "height": 960,
            "size": 0
          }
        },
        "duration": 0,
        "hasPosts": false,
        "listStates": [
          {
            "id": 123,
            "type": "posts",
            "name": "Posts",
            "hasMedia": true,
            "canAddMedia": false
          },
          {
            "id": 123,
            "type": "stories",
            "name": "Stories",
            "hasMedia": false,
            "canAddMedia": false
          },
          {
            "id": 123,
            "type": "messages",
            "name": "Messages",
            "hasMedia": false,
            "canAddMedia": false
          },
          {
            "id": 123,
            "type": "streams",
            "name": "Streams",
            "hasMedia": false,
            "canAddMedia": false
          },
          {
            "id": 123,
            "type": "custom",
            "name": "custom category",
            "hasMedia": false,
            "canAddMedia": true
          },
          {
            "id": 123,
            "type": "media_stickers",
            "name": "Uploads",
            "hasMedia": false,
            "canAddMedia": false
          }
        ],
        "releaseForms": [],
        "hasCustomPreview": false,
        "videoSources": {
          "240": null,
          "720": null
        }
      },
      {
        "id": 123,
        "type": "photo",
        "convertedToVideo": false,
        "canView": true,
        "hasError": false,
        "createdAt": "2025-01-01T00:00:00+00:00",
        "isReady": true,
        "counters": {
          "likesCount": 0,
          "tipsSumm": 0
        },
        "files": {
          "full": {
            "url": "https://cdn2.onlyfans.com/files/...",
            "width": 1629,
            "height": 1629,
            "size": 0,
            "sources": []
          },
          "thumb": {
            "url": "https://cdn2.onlyfans.com/files/...",
            "width": 300,
            "height": 300,
            "size": 0
          },
          "preview": {
            "url": "https://cdn2.onlyfans.com/files/...",
            "width": 960,
            "height": 960,
            "size": 0
          },
          "squarePreview": {
            "url": "https://cdn2.onlyfans.com/files/...",
            "width": 960,
            "height": 960,
            "size": 0
          }
        },
        "duration": 0,
        "hasPosts": false,
        "listStates": [
          {
            "id": 123,
            "type": "posts",
            "name": "Posts",
            "hasMedia": false,
            "canAddMedia": false
          },
          {
            "id": 123,
            "type": "stories",
            "name": "Stories",
            "hasMedia": false,
            "canAddMedia": false
          },
          {
            "id": 123,
            "type": "messages",
            "name": "Messages",
            "hasMedia": true,
            "canAddMedia": false
          },
          {
            "id": 123,
            "type": "streams",
            "name": "Streams",
            "hasMedia": false,
            "canAddMedia": false
          },
          {
            "id": 123,
            "type": "custom",
            "name": "custom category",
            "hasMedia": false,
            "canAddMedia": true
          },
          {
            "id": 123,
            "type": "media_stickers",
            "name": "Uploads",
            "hasMedia": false,
            "canAddMedia": false
          }
        ],
        "releaseForms": [],
        "hasCustomPreview": false,
        "videoSources": {
          "240": null,
          "720": null
        }
      },
      {
        "id": 123,
        "type": "photo",
        "convertedToVideo": false,
        "canView": true,
        "hasError": false,
        "createdAt": "2025-01-01T00:00:00+00:00",
        "isReady": true,
        "counters": {
          "likesCount": 0,
          "tipsSumm": 0
        },
        "files": {
          "full": {
            "url": "https://cdn2.onlyfans.com/files/...",
            "width": 500,
            "height": 500,
            "size": 0,
            "sources": []
          },
          "thumb": {
            "url": "https://cdn2.onlyfans.com/files/...",
            "width": 300,
            "height": 300,
            "size": 0
          },
          "preview": {
            "url": "https://cdn2.onlyfans.com/files/...",
            "width": 500,
            "height": 500,
            "size": 0
          },
          "squarePreview": {
            "url": "https://cdn2.onlyfans.com/files/...",
            "width": 960,
            "height": 960,
            "size": 0
          }
        },
        "duration": 0,
        "hasPosts": false,
        "listStates": [
          {
            "id": 123,
            "type": "posts",
            "name": "Posts",
            "hasMedia": false,
            "canAddMedia": false
          },
          {
            "id": 123,
            "type": "stories",
            "name": "Stories",
            "hasMedia": false,
            "canAddMedia": false
          },
          {
            "id": 123,
            "type": "messages",
            "name": "Messages",
            "hasMedia": true,
            "canAddMedia": false
          },
          {
            "id": 123,
            "type": "streams",
            "name": "Streams",
            "hasMedia": false,
            "canAddMedia": false
          },
          {
            "id": 123,
            "type": "custom",
            "name": "custom category",
            "hasMedia": false,
            "canAddMedia": true
          },
          {
            "id": 123,
            "type": "media_stickers",
            "name": "Uploads",
            "hasMedia": false,
            "canAddMedia": false
          }
        ],
        "releaseForms": [],
        "hasCustomPreview": false,
        "videoSources": {
          "240": null,
          "720": null
        }
      },
      {
        "id": 123,
        "type": "photo",
        "convertedToVideo": false,
        "canView": true,
        "hasError": false,
        "createdAt": "2025-01-01T00:00:00+00:00",
        "isReady": true,
        "counters": {
          "likesCount": 0,
          "tipsSumm": 0
        },
        "files": {
          "full": {
            "url": "https://cdn2.onlyfans.com/files/...",
            "width": 1280,
            "height": 720,
            "size": 0,
            "sources": []
          },
          "thumb": {
            "url": "https://cdn2.onlyfans.com/files/...",
            "width": 300,
            "height": 300,
            "size": 0
          },
          "preview": {
            "url": "https://cdn2.onlyfans.com/files/...",
            "width": 960,
            "height": 540,
            "size": 0
          },
          "squarePreview": {
            "url": "https://cdn2.onlyfans.com/files/...",
            "width": 960,
            "height": 960,
            "size": 0
          }
        },
        "duration": 0,
        "hasPosts": false,
        "listStates": [
          {
            "id": 123,
            "type": "posts",
            "name": "Posts",
            "hasMedia": true,
            "canAddMedia": false
          },
          {
            "id": 123,
            "type": "stories",
            "name": "Stories",
            "hasMedia": false,
            "canAddMedia": false
          },
          {
            "id": 123,
            "type": "messages",
            "name": "Messages",
            "hasMedia": false,
            "canAddMedia": false
          },
          {
            "id": 123,
            "type": "streams",
            "name": "Streams",
            "hasMedia": false,
            "canAddMedia": false
          },
          {
            "id": 123,
            "type": "custom",
            "name": "custom category",
            "hasMedia": false,
            "canAddMedia": true
          },
          {
            "id": 123,
            "type": "media_stickers",
            "name": "Uploads",
            "hasMedia": false,
            "canAddMedia": false
          }
        ],
        "releaseForms": [],
        "hasCustomPreview": false,
        "videoSources": {
          "240": null,
          "720": null
        }
      }
    ],
    "hasMore": false
  },
  "_meta": {
    "_credits": {
      "used": 1,
      "balance": 999999960,
      "note": "Always"
    },
    "_cache": {
      "is_cached": false,
      "note": "Cache disabled for this endpoint"
    },
    "_rate_limits": {
      "limit_minute": 1000,
      "limit_day": 50000,
      "remaining_minute": 999,
      "remaining_day": 49989
    }
  }
}

Authorizations

​
Authorization
string
header
required

You can retrieve your token by visiting the OnlyFansAPI Console and clicking API Keys -> Create API Key.

Path Parameters

​
account
string
required

The Account ID

Query Parameters

​
query
string

Optionally, search for a text query.

Example:

"Hi"

​
field
enum<string>

Sort the results by a field. Default recent

Available options:
recent,
most-liked,
highest-tips
Example:

"recent"

​
type
enum<string>

Filter the results by a media type. Keep empty to show all media.

Available options:
photo,
gif,
video,
audio
Example:

"photo"

​
list
integer

Only show media items from a specific list (category). Refer to our Media Vault Lists endpoints.

Example:

"123456789"

​
sort
enum<string>

Sort the results. Default desc

Available options:
desc,
asc
Example:

"desc"

​
limit
integer

Number of media to return per page. Default: 24

Example:

24

​
offset
integer

The offset used for pagination. Default 0

Example:

0

Response

200 - application/json
​
data
object
​
_meta
object