> ## 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.

# Query Vault+ media

> Vault+ is an optional feature that makes the OnlyFans Vault easier to use in your app. Search saved media for the linked account to load files and thumbnails faster, without managing expiring OnlyFans URLs. Results are grouped by OnlyFans media ID, with available versions listed by label.

**Required scope:** `vault:read`



## OpenAPI

````yaml /openapi/v3.json get /v3/vault-plus/media
openapi: 3.1.0
info:
  title: OFAuth API
  version: 1.0.0
  description: >-
    OFAuth V3 API for linking accounts, making OnlyFans API requests, and
    receiving events.
  contact:
    email: support@ofauth.com
    url: https://ofauth.com/
servers:
  - url: https://api.ofauth.com
security:
  - ExternalOAuth: []
tags:
  - name: Link
    description: Link accounts, get and refresh tokens, and end access.
  - name: Linked accounts
    description: The linked accounts of one authorization, and their settings.
  - name: Access
    description: Make OnlyFans API requests for a linked account.
  - name: Analytics
    description: 'Access: charts, rankings, and performance data.'
  - 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: linked account profile and settings.'
  - name: Stories
    description: 'Access: stories listing and management.'
  - name: Subscriptions
    description: 'Access: subscription offers, discounts, and management.'
  - name: Realtime
    description: Webhook event formats, including OnlyFans activity events.
externalDocs:
  description: OFAuth Developer Documentation
  url: https://docs.ofauth.com
paths:
  /v3/vault-plus/media:
    get:
      tags:
        - Vault+
      summary: Query Vault+ media
      description: >-
        Vault+ is an optional feature that makes the OnlyFans Vault easier to
        use in your app. Search saved media for the linked account to load files
        and thumbnails faster, without managing expiring OnlyFans URLs. Results
        are grouped by OnlyFans media ID, with available versions listed by
        label.


        **Required scope:** `vault:read`
      operationId: vaultPlus.media.list
      parameters:
        - schema:
            type: string
            enum:
              - edge_only
              - pending
              - storing
              - stored
              - removed
          required: false
          name: status
          in: query
        - schema:
            type: string
            enum:
              - image
              - video
              - audio
          required: false
          name: type
          in: query
        - schema:
            type: string
          required: false
          name: contentType
          in: query
        - schema:
            type: number
            nullable: true
          required: false
          name: durationMin
          in: query
        - schema:
            type: number
            nullable: true
          required: false
          name: durationMax
          in: query
        - schema:
            type: string
          required: false
          name: createdAtFrom
          in: query
        - schema:
            type: string
          required: false
          name: createdAtTo
          in: query
        - schema:
            type: string
          required: false
          name: cachedAtFrom
          in: query
        - schema:
            type: string
          required: false
          name: cachedAtTo
          in: query
        - schema:
            type: integer
            minimum: 1
            maximum: 100
          required: false
          name: limit
          in: query
        - schema:
            type: string
          required: false
          name: cursor
          in: query
        - schema:
            type: string
            enum:
              - createdAt_desc
              - createdAt_asc
              - cachedAt_desc
              - cachedAt_asc
              - duration_desc
              - duration_asc
          required: false
          name: sort
          in: query
        - schema:
            type: string
            minLength: 1
            description: The linked account to use for this request.
            example: conn_123
          required: true
          name: x-linked-account-id
          in: header
      responses:
        '200':
          description: Saved media
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VaultPlusMediaList'
        '401':
          description: Missing, expired, or invalid OAuth access token
        '403':
          description: >-
            Vault+ is off for this integration environment, or your app lacks
            access to the linked account or the required scope.
        '404':
          description: Not found
        '502':
          description: OnlyFans vault list could not be fetched
        '503':
          description: Vault+ storage is temporarily unavailable
      security:
        - ExternalOAuth: []
          LinkedAccountId: []
components:
  schemas:
    VaultPlusMediaList:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/VaultPlusMediaItem'
        nextCursor:
          type: string
      required:
        - items
    VaultPlusMediaItem:
      type: object
      properties:
        id:
          type: string
        type:
          type: string
          enum:
            - image
            - video
            - audio
        duration:
          type: number
          nullable: true
        media:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/VaultPlusMediaVariant'
      required:
        - id
        - type
        - duration
        - media
    VaultPlusMediaVariant:
      type: object
      properties:
        status:
          type: string
          enum:
            - edge_only
            - pending
            - storing
            - stored
            - removed
        quality:
          type: string
        sizeBytes:
          type: number
        contentType:
          type: string
        source:
          type: string
          enum:
            - vault
            - messages
            - posts
            - stories
        accessCount:
          type: number
        createdAt:
          type: number
        expiresAt:
          type: number
        storedAt:
          type: number
          nullable: true
        lastAccessedAt:
          type: number
        url:
          type: string
      required:
        - status
        - quality
        - sizeBytes
        - contentType
        - source
        - accessCount
        - createdAt
        - expiresAt
        - storedAt
        - lastAccessedAt
        - url
  securitySchemes:
    ExternalOAuth:
      type: http
      scheme: bearer
      bearerFormat: opaque
      description: Link access token for one Sandbox, Test, or Live authorization.
    LinkedAccountId:
      type: apiKey
      name: x-linked-account-id
      in: header
      description: >-
        Selects one of the authorization's linked accounts via the
        x-linked-account-id header.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.