> ## Documentation Index > Fetch the complete documentation index at: https://docs.onlyfansapi.com/llms.txt > Use this file to discover all available pages before exploring further. # List Vault Media (/api-reference/fansly/vault/list-vault-media) Get the media in a vault album, newest first. The response carries `albumMedia` (the album membership records) alongside `media` (the media itself, with variants and CDN `locations`). Pass `before` = the `id` of the last `albumMedia` entry of the previous page to fetch the next page. A page shorter than Fansly's page size means you reached the end. ## OpenAPI ````yaml https://app.onlyfansapi.com/scribe-fansly-docs/openapi.yaml get /api/fansly/{fanslyAccount}/vault/media openapi: 3.0.3 info: title: Fansly API Documentation description: "" version: 1.0.0 servers: - url: https://app.onlyfansapi.com security: - default: [] tags: - name: Account description: Endpoints for your linked Fansly accounts - name: Chat Messages description: Endpoints for Fansly chats (messaging groups) - name: Chats description: Endpoints for Fansly chats (messaging groups) - name: Connect Fansly Account description: "" - name: Earnings description: Endpoints for Fansly Earnings — wallets, balances, transactions, payouts, and statements. - name: Followers description: Endpoints for Fansly followers. - name: Following description: Endpoints for the accounts a Fansly Account is following. - name: Lists description: Endpoints for Fansly subscriber/fan lists (e.g. "VIP", "Spenders"). - name: Mass Messaging description: Endpoints for Fansly mass messages (broadcasts) — send one message to many recipients at once, and manage scheduled broadcasts. - name: Media description: Upload media for use in Fansly posts and messages - name: Posts description: Endpoints for Fansly wall posts. - name: Profile Statistics description: Endpoints for Fansly Profile Statistics (viewer engagement insights). - name: Subscribers description: Endpoints for Fansly subscribers and subscription tiers. - name: Subscription Discounts description: Endpoints for Fansly subscription discounts (shown as "Gift Links" in the Fansly Dashboard). - name: Top Supporters description: Endpoints for the Fansly "Top Supporters" view — see who spends the most and what they spend on. - name: Tracking Links description: Endpoints for Fansly tracking links — per-source attribution links (e.g. "Twitter bio", "FYP", "Search"). - name: Users description: APIs for fetching Fansly users - name: Vault description: Endpoints for the Fansly Vault — the account's media library and the albums it is organised into. - name: Walls description: Endpoints for Fansly walls — the tabbed feeds on a creator profile that posts are published to. paths: /api/fansly/{fanslyAccount}/vault/media: parameters: - in: path name: fanslyAccount description: The Fansly Account ID example: fansly_acct_XXXXXXXXXXXXXXX required: true schema: type: string get: summary: List Vault Media operationId: listVaultMedia description: >- Get the media in a vault album, newest first. The response carries `albumMedia` (the album membership records) alongside `media` (the media itself, with variants and CDN `locations`). Pass `before` = the `id` of the last `albumMedia` entry of the previous page to fetch the next page. A page shorter than Fansly's page size means you reached the end. parameters: - in: query name: album_id description: The vault album to list media from, from the **List Vault Albums** endpoint. example: "922919290099736576" required: true schema: type: string description: The vault album to list media from, from the **List Vault Albums** endpoint. example: "922919290099736576" - in: query name: media_type description: "Filter by native Fansly media type: 1 = photos only, 2 = videos only, 0 = neither photos nor videos. Omit for all media types." example: 2 required: false schema: type: string description: "Filter by native Fansly media type: 1 = photos only, 2 = videos only, 0 = neither photos nor videos. Omit for all media types." example: 2 - in: query name: search description: Filter by filename. example: beach required: false schema: type: string description: Filter by filename. example: beach - in: query name: before description: "Pagination cursor: the `albumMedia` ID of the last item from the previous page. Omit (or pass 0) for the first page." example: "922919290229764096" required: false schema: type: string description: "Pagination cursor: the `albumMedia` ID of the last item from the previous page. Omit (or pass 0) for the first page." example: "922919290229764096" - in: query name: after description: Lower-bound cursor, the `albumMedia` ID to list media newer than. Defaults to 0 (unbounded). example: "0" required: false schema: type: string description: Lower-bound cursor, the `albumMedia` ID to list media newer than. Defaults to 0 (unbounded). example: "0" responses: "200": description: Success content: application/json: schema: type: object example: data: albumMedia: - id: "400000000000000001" mediaId: "500000000000000001" mediaType: 1 albumId: "300000000000000001" accountId: "800000000000000001" createdAt: 1786490793000 customFilename: beach-01.jpeg - id: "400000000000000002" mediaId: "500000000000000010" mediaType: 2 albumId: "300000000000000001" accountId: "800000000000000001" createdAt: 1784297785000 customFilename: clip-01.mp4 media: - id: "500000000000000001" type: 1 status: 1 accountId: "800000000000000001" mimetype: image/jpeg flags: 6 filename: beach-01.jpeg location: /800000000000000001/500000000000000001.jpeg width: 588 height: 480 metadata: '{"dominant":{"r":248,"g":248,"b":248},"resolutionMode":1}' updatedAt: 1786490605 createdAt: 1786490605 variants: - id: "500000000000000002" type: 1 status: 1 mimetype: image/jpeg flags: 0 filename: beach-01_360.jpeg location: /800000000000000001/500000000000000002.jpeg width: 442 height: 360 metadata: '{"resolutionMode":1}' updatedAt: 1786490606 locations: - locationId: "1" location: https://cdn3.fansly.com/800000000000000001/500000000000000002.jpeg?ngsw-bypass=true&Policy=EXAMPLE_POLICY&Key-Pair-Id=EXAMPLE_KEY&Signature=EXAMPLE_SIGNATURE - id: "500000000000000003" type: 1 status: 1 mimetype: image/jpeg flags: 0 filename: beach-01_240.jpeg location: /800000000000000001/500000000000000003.jpeg width: 294 height: 240 metadata: '{"resolutionMode":1}' updatedAt: 1786490606 locations: - locationId: "1" location: https://cdn3.fansly.com/800000000000000001/500000000000000003.jpeg?ngsw-bypass=true&Policy=EXAMPLE_POLICY&Key-Pair-Id=EXAMPLE_KEY&Signature=EXAMPLE_SIGNATURE - id: "500000000000000004" type: 3 status: 1 mimetype: image/jpeg flags: 0 filename: beach-01_240_blur.jpeg location: /800000000000000001/500000000000000004.jpeg width: 294 height: 240 metadata: '{"resolutionMode":1}' updatedAt: 1786490606 locations: - locationId: "1" location: https://cdn3.fansly.com/800000000000000001/500000000000000004.jpeg?ngsw-bypass=true&Policy=EXAMPLE_POLICY&Key-Pair-Id=EXAMPLE_KEY&Signature=EXAMPLE_SIGNATURE variantHash: {} locations: - locationId: "1" location: https://cdn3.fansly.com/800000000000000001/500000000000000001.jpeg?ngsw-bypass=true&Policy=EXAMPLE_POLICY&Key-Pair-Id=EXAMPLE_KEY&Signature=EXAMPLE_SIGNATURE - id: "500000000000000010" type: 2 status: 1 accountId: "800000000000000001" mimetype: video/mp4 flags: 0 filename: clip-01.mp4 location: /800000000000000001/500000000000000010.mp4 width: 480 height: 270 metadata: '{"originalHeight":270,"originalWidth":480,"duration":30.526667,"resolutionMode":1,"frameRate":30}' updatedAt: 1784297504 createdAt: 1784297501 variants: - id: "500000000000000011" type: 1 status: 1 mimetype: image/jpeg flags: 0 filename: clip-01_frame.jpeg location: /800000000000000001/500000000000000011.jpeg width: 480 height: 270 metadata: '{"resolutionMode":1}' updatedAt: 1784297504 locations: - locationId: "1" location: https://cdn3.fansly.com/800000000000000001/500000000000000011.jpeg?ngsw-bypass=true&Policy=EXAMPLE_POLICY&Key-Pair-Id=EXAMPLE_KEY&Signature=EXAMPLE_SIGNATURE - id: "500000000000000012" type: 3 status: 1 mimetype: image/jpeg flags: 0 filename: clip-01_frame.jpeg location: /800000000000000001/500000000000000012.jpeg width: 480 height: 270 metadata: '{"resolutionMode":1}' updatedAt: 1784297504 locations: - locationId: "1" location: https://cdn3.fansly.com/800000000000000001/500000000000000012.jpeg?ngsw-bypass=true&Policy=EXAMPLE_POLICY&Key-Pair-Id=EXAMPLE_KEY&Signature=EXAMPLE_SIGNATURE - id: "500000000000000013" type: 4 status: 1 mimetype: image/jpeg flags: 0 filename: clip-01_thumbnails.jpeg location: /800000000000000001/500000000000000013.jpeg width: 256 height: 144 metadata: '{"resolutionMode":1}' updatedAt: 1784297504 locations: - locationId: "1" location: https://cdn3.fansly.com/800000000000000001/500000000000000013.jpeg?ngsw-bypass=true&Policy=EXAMPLE_POLICY&Key-Pair-Id=EXAMPLE_KEY&Signature=EXAMPLE_SIGNATURE - id: "500000000000000014" type: 302 status: 1 mimetype: application/vnd.apple.mpegurl flags: 0 filename: 500000000000000014.m3u8 location: /800000000000000001/500000000000000014.m3u8 width: 480 height: 270 metadata: '{"originalHeight":270,"originalWidth":480,"duration":30.526667}' updatedAt: 1784297504 locations: - locationId: "1" location: https://cdn3.fansly.com/800000000000000001/500000000000000014.m3u8?ngsw-bypass=true&Policy=EXAMPLE_POLICY&Key-Pair-Id=EXAMPLE_KEY&Signature=EXAMPLE_SIGNATURE - id: "500000000000000015" type: 303 status: 1 mimetype: application/dash+xml flags: 0 filename: 500000000000000015.mpd location: /800000000000000001/500000000000000015.mpd width: 480 height: 270 metadata: '{"originalHeight":270,"originalWidth":480,"duration":30.526667}' updatedAt: 1784297504 locations: - locationId: "1" location: https://cdn3.fansly.com/800000000000000001/500000000000000015.mpd?ngsw-bypass=true&Policy=EXAMPLE_POLICY&Key-Pair-Id=EXAMPLE_KEY&Signature=EXAMPLE_SIGNATURE variantHash: {} locations: - locationId: "1" location: https://cdn3.fansly.com/800000000000000001/500000000000000010.mp4?ngsw-bypass=true&Policy=EXAMPLE_POLICY&Key-Pair-Id=EXAMPLE_KEY&Signature=EXAMPLE_SIGNATURE _meta: _credits: used: 1 balance: 10055790 note: Always _cache: is_cached: false note: Cache disabled for this endpoint _rate_limits: limit_minute: 5000 limit_day: null remaining_minute: 4999 remaining_day: null notice: We have decided to remove our daily rate limits. Please remove any references to these in your integrations. properties: data: type: object properties: albumMedia: type: array example: - id: "400000000000000001" mediaId: "500000000000000001" mediaType: 1 albumId: "300000000000000001" accountId: "800000000000000001" createdAt: 1786490793000 customFilename: beach-01.jpeg - id: "400000000000000002" mediaId: "500000000000000010" mediaType: 2 albumId: "300000000000000001" accountId: "800000000000000001" createdAt: 1784297785000 customFilename: clip-01.mp4 items: type: object properties: id: type: string example: "400000000000000001" mediaId: type: string example: "500000000000000001" mediaType: type: integer example: 1 albumId: type: string example: "300000000000000001" accountId: type: string example: "800000000000000001" createdAt: type: integer example: 1786490793000 customFilename: type: string example: beach-01.jpeg media: type: array example: - id: "500000000000000001" type: 1 status: 1 accountId: "800000000000000001" mimetype: image/jpeg flags: 6 filename: beach-01.jpeg location: /800000000000000001/500000000000000001.jpeg width: 588 height: 480 metadata: '{"dominant":{"r":248,"g":248,"b":248},"resolutionMode":1}' updatedAt: 1786490605 createdAt: 1786490605 variants: - id: "500000000000000002" type: 1 status: 1 mimetype: image/jpeg flags: 0 filename: beach-01_360.jpeg location: /800000000000000001/500000000000000002.jpeg width: 442 height: 360 metadata: '{"resolutionMode":1}' updatedAt: 1786490606 locations: - locationId: "1" location: https://cdn3.fansly.com/800000000000000001/500000000000000002.jpeg?ngsw-bypass=true&Policy=EXAMPLE_POLICY&Key-Pair-Id=EXAMPLE_KEY&Signature=EXAMPLE_SIGNATURE - id: "500000000000000003" type: 1 status: 1 mimetype: image/jpeg flags: 0 filename: beach-01_240.jpeg location: /800000000000000001/500000000000000003.jpeg width: 294 height: 240 metadata: '{"resolutionMode":1}' updatedAt: 1786490606 locations: - locationId: "1" location: https://cdn3.fansly.com/800000000000000001/500000000000000003.jpeg?ngsw-bypass=true&Policy=EXAMPLE_POLICY&Key-Pair-Id=EXAMPLE_KEY&Signature=EXAMPLE_SIGNATURE - id: "500000000000000004" type: 3 status: 1 mimetype: image/jpeg flags: 0 filename: beach-01_240_blur.jpeg location: /800000000000000001/500000000000000004.jpeg width: 294 height: 240 metadata: '{"resolutionMode":1}' updatedAt: 1786490606 locations: - locationId: "1" location: https://cdn3.fansly.com/800000000000000001/500000000000000004.jpeg?ngsw-bypass=true&Policy=EXAMPLE_POLICY&Key-Pair-Id=EXAMPLE_KEY&Signature=EXAMPLE_SIGNATURE variantHash: [] locations: - locationId: "1" location: https://cdn3.fansly.com/800000000000000001/500000000000000001.jpeg?ngsw-bypass=true&Policy=EXAMPLE_POLICY&Key-Pair-Id=EXAMPLE_KEY&Signature=EXAMPLE_SIGNATURE - id: "500000000000000010" type: 2 status: 1 accountId: "800000000000000001" mimetype: video/mp4 flags: 0 filename: clip-01.mp4 location: /800000000000000001/500000000000000010.mp4 width: 480 height: 270 metadata: '{"originalHeight":270,"originalWidth":480,"duration":30.526667,"resolutionMode":1,"frameRate":30}' updatedAt: 1784297504 createdAt: 1784297501 variants: - id: "500000000000000011" type: 1 status: 1 mimetype: image/jpeg flags: 0 filename: clip-01_frame.jpeg location: /800000000000000001/500000000000000011.jpeg width: 480 height: 270 metadata: '{"resolutionMode":1}' updatedAt: 1784297504 locations: - locationId: "1" location: https://cdn3.fansly.com/800000000000000001/500000000000000011.jpeg?ngsw-bypass=true&Policy=EXAMPLE_POLICY&Key-Pair-Id=EXAMPLE_KEY&Signature=EXAMPLE_SIGNATURE - id: "500000000000000012" type: 3 status: 1 mimetype: image/jpeg flags: 0 filename: clip-01_frame.jpeg location: /800000000000000001/500000000000000012.jpeg width: 480 height: 270 metadata: '{"resolutionMode":1}' updatedAt: 1784297504 locations: - locationId: "1" location: https://cdn3.fansly.com/800000000000000001/500000000000000012.jpeg?ngsw-bypass=true&Policy=EXAMPLE_POLICY&Key-Pair-Id=EXAMPLE_KEY&Signature=EXAMPLE_SIGNATURE - id: "500000000000000013" type: 4 status: 1 mimetype: image/jpeg flags: 0 filename: clip-01_thumbnails.jpeg location: /800000000000000001/500000000000000013.jpeg width: 256 height: 144 metadata: '{"resolutionMode":1}' updatedAt: 1784297504 locations: - locationId: "1" location: https://cdn3.fansly.com/800000000000000001/500000000000000013.jpeg?ngsw-bypass=true&Policy=EXAMPLE_POLICY&Key-Pair-Id=EXAMPLE_KEY&Signature=EXAMPLE_SIGNATURE - id: "500000000000000014" type: 302 status: 1 mimetype: application/vnd.apple.mpegurl flags: 0 filename: 500000000000000014.m3u8 location: /800000000000000001/500000000000000014.m3u8 width: 480 height: 270 metadata: '{"originalHeight":270,"originalWidth":480,"duration":30.526667}' updatedAt: 1784297504 locations: - locationId: "1" location: https://cdn3.fansly.com/800000000000000001/500000000000000014.m3u8?ngsw-bypass=true&Policy=EXAMPLE_POLICY&Key-Pair-Id=EXAMPLE_KEY&Signature=EXAMPLE_SIGNATURE - id: "500000000000000015" type: 303 status: 1 mimetype: application/dash+xml flags: 0 filename: 500000000000000015.mpd location: /800000000000000001/500000000000000015.mpd width: 480 height: 270 metadata: '{"originalHeight":270,"originalWidth":480,"duration":30.526667}' updatedAt: 1784297504 locations: - locationId: "1" location: https://cdn3.fansly.com/800000000000000001/500000000000000015.mpd?ngsw-bypass=true&Policy=EXAMPLE_POLICY&Key-Pair-Id=EXAMPLE_KEY&Signature=EXAMPLE_SIGNATURE variantHash: [] locations: - locationId: "1" location: https://cdn3.fansly.com/800000000000000001/500000000000000010.mp4?ngsw-bypass=true&Policy=EXAMPLE_POLICY&Key-Pair-Id=EXAMPLE_KEY&Signature=EXAMPLE_SIGNATURE items: type: object properties: id: type: string example: "500000000000000001" type: type: integer example: 1 status: type: integer example: 1 accountId: type: string example: "800000000000000001" mimetype: type: string example: image/jpeg flags: type: integer example: 6 filename: type: string example: beach-01.jpeg location: type: string example: /800000000000000001/500000000000000001.jpeg width: type: integer example: 588 height: type: integer example: 480 metadata: type: string example: '{"dominant":{"r":248,"g":248,"b":248},"resolutionMode":1}' updatedAt: type: integer example: 1786490605 createdAt: type: integer example: 1786490605 variants: type: array example: - id: "500000000000000002" type: 1 status: 1 mimetype: image/jpeg flags: 0 filename: beach-01_360.jpeg location: /800000000000000001/500000000000000002.jpeg width: 442 height: 360 metadata: '{"resolutionMode":1}' updatedAt: 1786490606 locations: - locationId: "1" location: https://cdn3.fansly.com/800000000000000001/500000000000000002.jpeg?ngsw-bypass=true&Policy=EXAMPLE_POLICY&Key-Pair-Id=EXAMPLE_KEY&Signature=EXAMPLE_SIGNATURE - id: "500000000000000003" type: 1 status: 1 mimetype: image/jpeg flags: 0 filename: beach-01_240.jpeg location: /800000000000000001/500000000000000003.jpeg width: 294 height: 240 metadata: '{"resolutionMode":1}' updatedAt: 1786490606 locations: - locationId: "1" location: https://cdn3.fansly.com/800000000000000001/500000000000000003.jpeg?ngsw-bypass=true&Policy=EXAMPLE_POLICY&Key-Pair-Id=EXAMPLE_KEY&Signature=EXAMPLE_SIGNATURE - id: "500000000000000004" type: 3 status: 1 mimetype: image/jpeg flags: 0 filename: beach-01_240_blur.jpeg location: /800000000000000001/500000000000000004.jpeg width: 294 height: 240 metadata: '{"resolutionMode":1}' updatedAt: 1786490606 locations: - locationId: "1" location: https://cdn3.fansly.com/800000000000000001/500000000000000004.jpeg?ngsw-bypass=true&Policy=EXAMPLE_POLICY&Key-Pair-Id=EXAMPLE_KEY&Signature=EXAMPLE_SIGNATURE items: type: object properties: id: type: string example: "500000000000000002" type: type: integer example: 1 status: type: integer example: 1 mimetype: type: string example: image/jpeg flags: type: integer example: 0 filename: type: string example: beach-01_360.jpeg location: type: string example: /800000000000000001/500000000000000002.jpeg width: type: integer example: 442 height: type: integer example: 360 metadata: type: string example: '{"resolutionMode":1}' updatedAt: type: integer example: 1786490606 locations: type: array example: - locationId: "1" location: https://cdn3.fansly.com/800000000000000001/500000000000000002.jpeg?ngsw-bypass=true&Policy=EXAMPLE_POLICY&Key-Pair-Id=EXAMPLE_KEY&Signature=EXAMPLE_SIGNATURE items: type: object properties: locationId: type: string example: "1" location: type: string example: https://cdn3.fansly.com/800000000000000001/500000000000000002.jpeg?ngsw-bypass=true&Policy=EXAMPLE_POLICY&Key-Pair-Id=EXAMPLE_KEY&Signature=EXAMPLE_SIGNATURE variantHash: type: object properties: {} locations: type: array example: - locationId: "1" location: https://cdn3.fansly.com/800000000000000001/500000000000000001.jpeg?ngsw-bypass=true&Policy=EXAMPLE_POLICY&Key-Pair-Id=EXAMPLE_KEY&Signature=EXAMPLE_SIGNATURE items: type: object properties: locationId: type: string example: "1" location: type: string example: https://cdn3.fansly.com/800000000000000001/500000000000000001.jpeg?ngsw-bypass=true&Policy=EXAMPLE_POLICY&Key-Pair-Id=EXAMPLE_KEY&Signature=EXAMPLE_SIGNATURE _meta: type: object properties: _credits: type: object properties: used: type: integer example: 1 balance: type: integer example: 10055790 note: type: string example: Always _cache: type: object properties: is_cached: type: boolean example: false note: type: string example: Cache disabled for this endpoint _rate_limits: type: object properties: limit_minute: type: integer example: 5000 limit_day: type: string example: null nullable: true remaining_minute: type: integer example: 4999 remaining_day: type: string example: null nullable: true notice: type: string example: We have decided to remove our daily rate limits. Please remove any references to these in your integrations. tags: - Vault components: securitySchemes: default: type: http scheme: bearer description: Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys ````