Get vault lists (folders)
List the vault folders for an account.
List the vault folders for an account.
view=main is required — omitting it makes OnlyFans respond 400 Bad view param (passed through verbatim). The response is wrapped in the standard passthrough envelope ({ success, status_code, data }); the OnlyFans body is under data, where data.list is the folder array and data.all carries global counts across the whole vault.
OnlyFans only. Requests made with a user-id belonging to a Fansly account are rejected — use the platform-neutral CRM data routes (/notifications, /balances, /chats, /purchases, /subscribers/cached, ...) which are Fansly-aware.
Guide: The two surfaces
Authorization
apiKey Your CRM panel API key
In: header
Query Parameters
Required by OnlyFans. Use main — it returns the folder list plus the all bucket of global counts. Omitting it returns 400 Bad view param.
"main"Value in
- "main"
100Header Parameters
Creator account ID of the account to act as (e.g. 509955039). Required — omitting it returns 400 user-id header is required. Use GET /accounts to list your connected accounts. On /api2/v2/* the account must be an OnlyFans account; Fansly accounts are rejected there.
Proxy URL — HTTP or SOCKS5 (e.g. http://user:pass@host:port or socks5://user:pass@host:port). Optional on post-connection routes, where it overrides the proxy saved at login time. Required on the connection routes (POST /accounts/login, POST /accounts/login/cookies, POST /accounts/login/verify-otp) for OnlyFans accounts; optional for Fansly.
Response Body
application/json
curl -X GET "https://example.com/api2/v2/vault/lists?view=main" \ -H "user-id: 509955039"{ "success": true, "status_code": 0, "data": { "all": { "photosCount": 0, "videosCount": 0, "gifsCount": 0, "audiosCount": 0 }, "list": [ { "id": 0, "name": "string", "photosCount": 0, "videosCount": 0, "gifsCount": 0, "audiosCount": 0, "hasMedia": true, "canUpdate": true, "canDelete": true, "medias": [ { "type": "string", "url": "string" } ] } ], "hasMore": true, "order": "string", "sort": "string", "canCreateVaultLists": true }}Get user labels GET
OnlyFans only. Requests made with a user-id belonging to a Fansly account are rejected — use the platform-neutral CRM data routes (/notifications, /balances,…
Get vault media GET
List vault media items. This is how you obtain the integer media IDs referenced by post creation, story creation, and messages.