Vault
List Vault Lists
Returns the vault's categories — system lists (Posts, Stories, Messages, Streams, Uploads) plus any custom folders the creator has created. Drives the parent dropdown for vault picker UIs. Requires permission api_vault_list_lists.
https://public-api.fansmetric.comGET/v1/{account_id}/vault/lists
Bearer
Authorization
defaultAuthorizationBearer <token>Send your FansMetric API key as a Bearer token in the Authorization header.
In: header
Path Parameters
account_id*integerOnlyFans numeric account ID.
Query Parameters
limitintegerPage size. Default 24. Min 1, max 100.
offsetintegerRows to skip. Default 0.
querystringFind custom lists by name.
curl --request GET "https://public-api.fansmetric.com/v1/acct_XXXXX/vault/lists?limit=20&offset=0&query=creator" \
--header "Authorization: Bearer YOUR_API_KEY"Response
200{
"data":{
"list":[
0:{
"id":1
"type":"stories"
"name":"Stories"
"canUpdate":false
"canDelete":false
"videosCount":0
"photosCount":0
"gifsCount":0
"audiosCount":0
"medias":[]
}
1:{
"id":2
"type":"media_stickers"
"name":"Uploads"
"canUpdate":false
"canDelete":false
"videosCount":0
"photosCount":0
"gifsCount":0
"audiosCount":0
"medias":[]
}
2:{
"id":3
"type":"posts"
"name":"Posts"
"canUpdate":false
"canDelete":false
"videosCount":0
"photosCount":5
"gifsCount":0
"audiosCount":0
"medias":[
0:{
"type":"photo"
"url":"..."
}
]
}
3:{
"id":4
"type":"messages"
"name":"Messages"
"canUpdate":false
"canDelete":false
"videosCount":1
"photosCount":4
"gifsCount":0
"audiosCount":2
"medias":[]
}
4:{
"id":9
"type":"custom"
"name":"Favourites"
"canUpdate":true
"canDelete":true
"videosCount":3
"photosCount":6
"gifsCount":0
"audiosCount":0
"medias":[]
}
]
"all":{
"videosCount":4
"photosCount":15
"gifsCount":0
"audiosCount":2
"medias":[]
}
"hasMore":false
"canCreateVaultLists":true
"order":"asc"
"sort":"default"
}
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}