> ## 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 this authorization's linked accounts

> Returns the accounts the access token's authorization covers, with their status and granted scopes, ordered by id. Send an account `id` as the `x-linked-account-id` header on Access requests.



## OpenAPI

````yaml /openapi/v3.json get /v3/linked-accounts
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/linked-accounts:
    get:
      tags:
        - Linked accounts
      summary: List this authorization's linked accounts
      description: >-
        Returns the accounts the access token's authorization covers, with their
        status and granted scopes, ordered by id. Send an account `id` as the
        `x-linked-account-id` header on Access requests.
      operationId: linkedAccounts.list
      parameters:
        - schema:
            type: integer
            minimum: 1
            maximum: 100
            description: Page size, 1 to 100. Defaults to 50.
          required: false
          name: limit
          in: query
        - schema:
            type: string
            description: '`next_cursor` from the previous page.'
          required: false
          name: cursor
          in: query
      responses:
        '200':
          description: One page of linked accounts.
          headers:
            Cache-Control:
              schema:
                type: string
                example: no-store
              required: true
            Pragma:
              schema:
                type: string
                example: no-cache
              required: true
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LinkedAccountsPage'
        '400':
          description: '`invalid_request`: bad `limit` or `cursor`.'
          headers:
            Cache-Control:
              schema:
                type: string
                example: no-store
              required: true
            Pragma:
              schema:
                type: string
                example: no-cache
              required: true
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LinkedAccountsError400'
        '401':
          description: >-
            `external_oauth_bearer_required`, `invalid_token`, or
            `grant_revoked_or_expired`.
          headers:
            Cache-Control:
              schema:
                type: string
                example: no-store
              required: true
            Pragma:
              schema:
                type: string
                example: no-cache
              required: true
            WWW-Authenticate:
              schema:
                type: string
                example: Bearer
              required: true
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LinkedAccountsError401'
        '403':
          description: >-
            The authorization or client can no longer be used
            (`integration_not_approved`, `security_suspended`, `client_deleted`,
            `subscription_required`).
          headers:
            Cache-Control:
              schema:
                type: string
                example: no-store
              required: true
            Pragma:
              schema:
                type: string
                example: no-cache
              required: true
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LinkedAccountsError403'
        '429':
          description: '`rate_limited` or `quota_exhausted`.'
          headers:
            Cache-Control:
              schema:
                type: string
                example: no-store
              required: true
            Pragma:
              schema:
                type: string
                example: no-cache
              required: true
            Retry-After:
              schema:
                type: string
                example: '3600'
              required: true
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LinkedAccountsError429'
        '503':
          description: '`authorization_temporarily_unavailable`; retry.'
          headers:
            Cache-Control:
              schema:
                type: string
                example: no-store
              required: true
            Pragma:
              schema:
                type: string
                example: no-cache
              required: true
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LinkedAccountsError503'
      security:
        - ExternalOAuth: []
components:
  schemas:
    LinkedAccountsPage:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/LinkedAccount'
        has_more:
          type: boolean
          description: Whether another page follows.
        next_cursor:
          type: string
          nullable: true
          description: >-
            Pass as `cursor` to `GET /v3/linked-accounts` for the next page;
            `null` on the last page.
      required:
        - data
        - has_more
        - next_cursor
    LinkedAccountsError400:
      allOf:
        - $ref: '#/components/schemas/RuntimeError'
        - properties:
            error:
              description: 'Stable error code: `invalid_request`.'
              enum:
                - invalid_request
              type: string
          type: object
    LinkedAccountsError401:
      allOf:
        - $ref: '#/components/schemas/RuntimeError'
        - type: object
          properties:
            error:
              type: string
              enum:
                - authorization_required
                - external_oauth_bearer_required
                - grant_revoked_or_expired
                - invalid_token
              description: >-
                Stable error code: `authorization_required`
                (`restart_authorization`), `external_oauth_bearer_required`
                (`obtain_external_oauth_token`), `grant_revoked_or_expired`
                (`restart_authorization`), `invalid_token`
                (`obtain_external_oauth_token`).
    LinkedAccountsError403:
      allOf:
        - $ref: '#/components/schemas/RuntimeError'
        - type: object
          properties:
            error:
              type: string
              enum:
                - additional_consent_required
                - client_deleted
                - integration_not_approved
                - integration_suspended
                - linked_account_not_granted
                - missing_scope
                - security_suspended
                - subscription_required
              description: >-
                Stable error code: `additional_consent_required`
                (`request_additional_consent`), `client_deleted`
                (`contact_integration_owner`), `integration_not_approved`
                (`complete_integration_approval`), `integration_suspended`
                (`contact_integration_owner`), `linked_account_not_granted`
                (`grant_linked_account`), `missing_scope`
                (`request_additional_consent`), `security_suspended`
                (`contact_integration_owner`), `subscription_required`
                (`update_developer_plan`).
    LinkedAccountsError429:
      allOf:
        - $ref: '#/components/schemas/RuntimeError'
        - type: object
          properties:
            error:
              type: string
              enum:
                - quota_exhausted
                - rate_limited
              description: >-
                Stable error code: `quota_exhausted` (`retry_after_reset`),
                `rate_limited` (`retry`).
    LinkedAccountsError503:
      allOf:
        - $ref: '#/components/schemas/RuntimeError'
        - type: object
          properties:
            error:
              type: string
              enum:
                - authorization_temporarily_unavailable
              description: >-
                Stable error code: `authorization_temporarily_unavailable`
                (`retry`).
    LinkedAccount:
      type: object
      properties:
        id:
          type: string
          example: conn_example123
        provider:
          type: string
          example: onlyfans
        provider_account_id:
          type: string
          example: '123456789'
        username:
          type: string
          nullable: true
          example: creator
        display_name:
          type: string
          nullable: true
          example: Creator Name
        status:
          type: string
          enum:
            - connected
            - needs_reconnect
            - disconnected
        scopes:
          type: array
          items:
            type: string
          example:
            - profile:read
        granted_at:
          type: string
          format: date-time
          example: '2026-04-23T14:30:15.143Z'
      required:
        - id
        - provider
        - provider_account_id
        - username
        - display_name
        - status
        - scopes
        - granted_at
    RuntimeError:
      type: object
      properties:
        error:
          type: string
          description: >-
            Stable error code. Each error response lists the codes its status
            can carry. `missing_scope` means the access token lacks the scope;
            `additional_consent_required` means the token has it but the linked
            account's current consent no longer covers it. Both recover with
            `request_additional_consent`.
          example: invalid_token
        recovery:
          type: object
          properties:
            action:
              type: string
              enum:
                - obtain_external_oauth_token
                - retry
                - retry_after_reset
                - restart_authorization
                - request_additional_consent
                - grant_linked_account
                - select_linked_account
                - reconnect_linked_account
                - list_linked_accounts
                - complete_integration_approval
                - contact_integration_owner
                - update_developer_plan
                - enable_vault_plus
                - enable_linked_account_vault_plus
                - correct_request
                - check_request
                - check_resource
                - do_not_repeat
                - restart_upload
              description: What to do before retrying.
          required:
            - action
          description: >-
            Absent on `invalid_request` and other errors with no recovery
            action.
        requestId:
          type: string
          example: 4f5c3f0e-8d7c-4ff5-9b7f-7d0d9e7c2a61
        message:
          type: string
          description: Human-readable detail, when available.
        details:
          type: string
          description: Upstream failure detail (Vault+ `502`).
        not_allowed_qualities:
          type: object
          properties:
            image_qualities:
              type: array
              items:
                type: string
                enum:
                  - thumb
                  - preview
                  - full
            video_qualities:
              type: array
              items:
                type: string
                enum:
                  - preview
                  - 720p
                  - 1080p
                  - source
          required:
            - image_qualities
            - video_qualities
          description: >-
            `vault_plus_quality_not_in_plan`: the requested qualities your
            Developer plan does not include.
        allowed_qualities:
          type: object
          properties:
            image_qualities:
              type: array
              items:
                type: string
                enum:
                  - thumb
                  - preview
                  - full
            video_qualities:
              type: array
              items:
                type: string
                enum:
                  - preview
                  - 720p
                  - 1080p
                  - source
          required:
            - image_qualities
            - video_qualities
          description: >-
            `vault_plus_quality_not_in_plan`: the qualities your Developer plan
            includes.
      required:
        - error
        - requestId
  securitySchemes:
    ExternalOAuth:
      type: http
      scheme: bearer
      bearerFormat: opaque
      description: Link access token for one Sandbox, Test, or Live authorization.

````

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