Skip to main content
GET
/
api
/
{account}
/
media
/
vault
/
lists
List Vault Lists
curl --request GET \
  --url https://app.onlyfansapi.com/api/{account}/media/vault/lists \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "list": [
      {
        "id": 123,
        "type": "stories",
        "name": "Stories",
        "hasMedia": false,
        "canUpdate": false,
        "canDelete": false,
        "videosCount": 0,
        "photosCount": 0,
        "gifsCount": 0,
        "audiosCount": 0,
        "medias": []
      },
      {
        "id": 123,
        "type": "streams",
        "name": "Streams",
        "hasMedia": false,
        "canUpdate": false,
        "canDelete": false,
        "videosCount": 0,
        "photosCount": 0,
        "gifsCount": 0,
        "audiosCount": 0,
        "medias": []
      },
      {
        "id": 123,
        "type": "media_stickers",
        "name": "Uploads",
        "hasMedia": false,
        "canUpdate": false,
        "canDelete": false,
        "videosCount": 0,
        "photosCount": 0,
        "gifsCount": 0,
        "audiosCount": 0,
        "medias": []
      },
      {
        "id": 123,
        "type": "posts",
        "name": "Posts",
        "hasMedia": true,
        "canUpdate": false,
        "canDelete": false,
        "videosCount": 0,
        "photosCount": 5,
        "gifsCount": 0,
        "audiosCount": 0,
        "medias": [
          {
            "type": "photo",
            "url": "https://cdn2.onlyfans.com/files/..."
          }
        ]
      },
      {
        "id": 123,
        "type": "custom",
        "name": "custom category",
        "hasMedia": false,
        "canUpdate": true,
        "canDelete": true,
        "videosCount": 0,
        "photosCount": 0,
        "gifsCount": 0,
        "audiosCount": 0,
        "medias": []
      },
      {
        "id": 123,
        "type": "messages",
        "name": "Messages",
        "hasMedia": true,
        "canUpdate": false,
        "canDelete": false,
        "videosCount": 1,
        "photosCount": 4,
        "gifsCount": 0,
        "audiosCount": 2,
        "medias": [
          {
            "type": "photo",
            "url": "https://cdn2.onlyfans.com/files/..."
          }
        ]
      }
    ],
    "all": {
      "videosCount": 1,
      "photosCount": 9,
      "gifsCount": 0,
      "audiosCount": 2,
      "medias": [
        {
          "type": "photo",
          "url": "https://cdn2.onlyfans.com/files/..."
        }
      ]
    },
    "hasMore": false,
    "canCreateVaultLists": true,
    "order": "asc",
    "sort": "default"
  },
  "_meta": {
    "_credits": {
      "used": 1,
      "balance": 999999945,
      "note": "Always"
    },
    "_cache": {
      "is_cached": false,
      "note": "Cache disabled for this endpoint"
    },
    "_rate_limits": {
      "limit_minute": 1000,
      "limit_day": 50000,
      "remaining_minute": 998,
      "remaining_day": 49968
    }
  }
}

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, find a list by its name.

Example:

"My list name"

​
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