> ## Documentation Index > Fetch the complete documentation index at: https://docs.ofauth.com/llms.txt > Use this file to discover all available pages before exploring further. # List cached media in a vault list > Returns cached list membership with list timestamps and cached media variants when present. ## OpenAPI ````yaml https://api.ofauth.com/openapi.json get /v2/vault-plus/lists/:listId/media openapi: 3.1.0 info: title: OFAuth API version: 1.0.0 description: >- OFAuth API including Account, Connections, Link, Access, Dynamic Rules, Vault+, and Realtime webhook contracts contact: email: support@ofauth.com url: https://ofauth.com/ servers: - url: https://api.ofauth.com security: - ApiKey: [] tags: - name: Account description: Account management endpoints. - name: Connections description: Connection management endpoints. - name: Link description: Link authentication and session endpoints. - name: Access description: All Access related endpoints. - name: Analytics description: 'Access: charts, tops, and performance metrics.' - name: Earnings description: 'Access: earnings charts, transactions, and chargebacks.' - name: Messages description: 'Access: messaging, chats, queue, and mass messaging.' - name: Posts description: 'Access: create, edit, list, and manage posts.' - name: Promotions description: 'Access: promotions, trials, and bundles.' - name: Users description: 'Access: user profiles, subscriptions, and actions.' - name: Vault description: 'Access: vault folders, media, and management.' - name: Upload description: 'Access: media upload and processing.' - name: Self description: 'Access: authenticated account details and settings.' - name: Stories description: 'Access: stories listing and management.' - name: Subscriptions description: 'Access: subscription offers, discounts, and management.' - name: Realtime description: >- Realtime webhook delivery contracts, including relayed OnlyFans websocket events. - name: Dynamic Rules description: Dynamic signing rules operations. - name: Vault+ description: Vault+ caching and management. externalDocs: description: OFAuth Developer Documentation url: https://docs.ofauth.com paths: /v2/vault-plus/lists/:listId/media: get: tags: - Vault+ Lists summary: List cached media in a vault list description: >- Returns cached list membership with list timestamps and cached media variants when present. parameters: - schema: type: string description: OnlyFans vault list ID. example: '28489180' required: true name: listId in: path - schema: type: string minLength: 1 description: Connection ID whose Vault+ list cache should be read or modified. example: conn_v5bsqkzsjfk8cgr7hqbbw09t required: true name: x-connection-id in: header responses: '200': description: >- Cached media membership for the list, including list timestamps and cached variants when available. This response is read from Vault+ list cache records and does not fetch live OnlyFans state. content: application/json: schema: type: object properties: items: type: array items: type: object properties: mediaId: type: string description: >- Raw OnlyFans media ID used by public Vault+ media routes. example: '4492994399' ofMediaId: type: string description: >- Raw OnlyFans media ID when known. Usually matches mediaId. example: '4492994399' status: type: string description: >- Current cache status for this media item, derived from its first available cached variant. Returns not_cached when the list item has no cached media record yet. example: stored type: type: string description: >- Media type from the cached media item or inferred from the list content type. example: image duration: type: number nullable: true description: >- Duration in seconds for video/audio media, or null for images. example: null firstAddedAt: type: string description: >- ISO timestamp when this media ID was first recorded on this cached list. example: '2026-06-06T20:00:00.000Z' lastAddedAt: type: string description: >- ISO timestamp when /add last observed this media ID on the list. example: '2026-06-06T20:00:00.000Z' lastSeenAt: type: string description: >- ISO timestamp when /add or /sync last observed this media ID on the list. example: '2026-06-06T21:00:00.000Z' lastSyncedAt: type: string description: >- ISO timestamp when /sync last included this media ID in the authoritative baseline. example: '2026-06-06T21:00:00.000Z' media: type: object additionalProperties: type: object properties: status: type: string description: >- Current cache lifecycle state for this media variant. example: stored quality: type: string description: >- Variant label or quality. Common values include full, thumb, 720, and 1080. example: full sizeBytes: type: number description: >- Stored byte size for this variant. May be 0 before storage completes. example: 1024000 contentType: type: string description: MIME type stored for this variant. example: image/jpeg accessCount: type: number description: >- Number of times this variant has been observed through media.ofauth.com. example: 12 createdAt: type: number description: >- Unix timestamp in milliseconds when Vault+ first observed this variant. example: 1715800000000 expiresAt: type: number description: >- Unix timestamp in milliseconds when the upstream/proxy URL expires. example: 1715886400000 storedAt: type: number nullable: true description: >- Unix timestamp in milliseconds when persistent storage completed, or null while not stored. example: 1715800100000 lastAccessedAt: type: number description: >- Unix timestamp in milliseconds when this variant was most recently observed. example: 1715800500000 url: type: string description: media.ofauth.com URL that serves this variant. example: >- https://media.ofauth.com/v2/example-signed-media-url required: - status description: >- Cached variant keyed by public variant label. Internal variant IDs are not exposed. description: >- Cached variants keyed by public variant label when this media is present in Vault+. required: - mediaId - status - type - firstAddedAt - lastSeenAt description: >- Cached list membership item with per-list timestamps and optional cached media variants. description: Cached media membership for the list. required: - items description: Cached Vault+ list media response. example: items: - mediaId: '4492994399' ofMediaId: '4492994399' status: stored type: image duration: null firstAddedAt: '2026-06-06T20:00:00.000Z' lastAddedAt: '2026-06-06T20:00:00.000Z' lastSeenAt: '2026-06-06T21:00:00.000Z' lastSyncedAt: '2026-06-06T21:00:00.000Z' media: full: status: stored quality: full sizeBytes: 1024000 contentType: image/jpeg accessCount: 12 createdAt: 1715800000000 expiresAt: 1715886400000 storedAt: 1715800100000 lastAccessedAt: 1715800500000 url: https://media.ofauth.com/v2/example-signed-media-url '400': description: The x-connection-id header is missing or invalid. content: application/json: schema: type: object properties: error: type: string description: Human-readable error message. example: Unauthorized required: - error description: Error response. example: error: x-connection-id header is required '401': description: The API key is missing, invalid, or lacks the ACCOUNT scope. content: application/json: schema: type: object properties: error: type: string description: Human-readable error message. example: Unauthorized required: - error description: Error response. example: error: Unauthorized security: - ApiKey: [] components: securitySchemes: ApiKey: type: apiKey name: apiKey in: header description: >- Your OFAuth [API key](/quickstart#2-copy-your-api-key) for authenticating requests. ````