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

# Get Account Media (/api-reference/fansly/media/get-account-media)

Fetch one or more registered accountMedia by ID (e.g. an `id` returned when attaching media to a message). Each item includes the full `media` object with variants and CDN `locations`. For video, poll this until `media.status` is `1` (transcode complete) — the playable variants and `locations` populate once processing finishes. Pass a single ID or a comma-separated list; bulk requests still cost one API credit.

## OpenAPI

````yaml https://app.onlyfansapi.com/scribe-fansly-docs/openapi.yaml get /api/fansly/{fanslyAccount}/account-media/{ids}
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: 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: Lists
    description: Endpoints for Fansly subscriber/fan lists (e.g. "VIP", "Spenders").
  - name: Media
    description: Upload media for use in Fansly posts and messages
  - name: Profile Statistics
    description: Endpoints for Fansly Profile Statistics (viewer engagement insights).
  - name: Subscribers
    description: Endpoints for Fansly subscribers and subscription tiers.
  - 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
paths:
  /api/fansly/{fanslyAccount}/account-media/{ids}:
    parameters:
      - in: path
        name: fanslyAccount
        description: The Fansly Account ID
        example: fansly_acct_XXXXXXXXXXXXXXX
        required: true
        schema:
          type: string
      - in: path
        name: ids
        description: An accountMedia ID, or a comma-separated list of IDs.
        example: "925889499706191874"
        required: true
        schema:
          type: string
    get:
      summary: Get Account Media
      operationId: getAccountMedia
      description: Fetch one or more registered accountMedia by ID (e.g. an `id`
        returned when attaching media to a message). Each item includes the full
        `media` object with variants and CDN `locations`. For video, poll this
        until `media.status` is `1` (transcode complete) — the playable variants
        and `locations` populate once processing finishes. Pass a single ID or a
        comma-separated list; bulk requests still cost one API credit.
      parameters: []
      responses:
        "200":
          description: Success
          content:
            application/json:
              schema:
                type: object
                example:
                  success: true
                  response:
                    - id: "925889499706191874"
                      accountId: "800000000000000001"
                      mediaId: "925889471688232961"
                      previewId: null
                      permissionFlags: 8
                      price: 0
                      createdAt: 1782243618
                      deletedAt: null
                      deleted: false
                      permissions:
                        permissionFlags:
                          - id: "925889499710373888"
                            accountMediaId: "925889499706191874"
                            type: 0
                            flags: 8
                            price: 0
                            metadata: ""
                            validAfter: null
                            validBefore: null
                            verificationFlags: 8
                            verificationMetadata: "{}"
                        accountPermissionFlags:
                          flags: 255
                          metadata: "{}"
                      likeCount: 0
                      media:
                        id: "925889471688232961"
                        type: 2
                        status: 1
                        accountId: "800000000000000001"
                        mimetype: video/mp4
                        flags: 0
                        filename: clip.mp4
                        location: /800000000000000001/925889471688232961.mp4
                        width: 1280
                        height: 720
                        metadata: '{"originalHeight":720,"originalWidth":1280,"duration":3000,"resolutionMode":1,"frameRate":30}'
                        updatedAt: 1782244060
                        createdAt: 1782243612
                        variants:
                          - id: "925889471688232962"
                            type: 1
                            status: 1
                            mimetype: image/jpeg
                            flags: 0
                            filename: clip_frame.jpeg
                            location: /800000000000000001/925889471688232962.jpeg
                            width: 854
                            height: 480
                            metadata: '{"resolutionMode":1}'
                            updatedAt: 1782243645
                            locations:
                              - locationId: "1"
                                location: https://cdn3.fansly.com/800000000000000001/925889471688232962.jpeg?ngsw-bypass=true&Policy=EXAMPLE_POLICY&Key-Pair-Id=EXAMPLE_KEY&Signature=EXAMPLE_SIGNATURE
                          - id: "925889474821378050"
                            type: 302
                            status: 1
                            mimetype: application/vnd.apple.mpegurl
                            flags: 0
                            filename: 925889474821378050.m3u8
                            location: /800000000000000001/925889474821378050.m3u8
                            width: 1280
                            height: 720
                            metadata: '{"originalHeight":720,"originalWidth":1280,"duration":3000,"variants":[{"w":1280,"h":720},{"w":854,"h":480},{"w":640,"h":360}]}'
                            updatedAt: 1782244060
                            locations:
                              - locationId: "1"
                                location: https://cdn3.fansly.com/800000000000000001/925889474821378050.m3u8?ngsw-bypass=true&Policy=EXAMPLE_POLICY&Key-Pair-Id=EXAMPLE_KEY&Signature=EXAMPLE_SIGNATURE
                        variantHash: {}
                        locations:
                          - locationId: "1"
                            location: https://cdn3.fansly.com/800000000000000001/925889471688232961.mp4?ngsw-bypass=true&Policy=EXAMPLE_POLICY&Key-Pair-Id=EXAMPLE_KEY&Signature=EXAMPLE_SIGNATURE
                      whitelist:
                        - accountId: "800000000000000002"
                          permissionFlags: 0
                      purchased: true
                      whitelisted: true
                      accountPermissionFlags: 255
                      access: true
                properties:
                  success:
                    type: boolean
                    example: true
                  response:
                    type: array
                    example:
                      - id: "925889499706191874"
                        accountId: "800000000000000001"
                        mediaId: "925889471688232961"
                        previewId: null
                        permissionFlags: 8
                        price: 0
                        createdAt: 1782243618
                        deletedAt: null
                        deleted: false
                        permissions:
                          permissionFlags:
                            - id: "925889499710373888"
                              accountMediaId: "925889499706191874"
                              type: 0
                              flags: 8
                              price: 0
                              metadata: ""
                              validAfter: null
                              validBefore: null
                              verificationFlags: 8
                              verificationMetadata: "{}"
                          accountPermissionFlags:
                            flags: 255
                            metadata: "{}"
                        likeCount: 0
                        media:
                          id: "925889471688232961"
                          type: 2
                          status: 1
                          accountId: "800000000000000001"
                          mimetype: video/mp4
                          flags: 0
                          filename: clip.mp4
                          location: /800000000000000001/925889471688232961.mp4
                          width: 1280
                          height: 720
                          metadata: '{"originalHeight":720,"originalWidth":1280,"duration":3000,"resolutionMode":1,"frameRate":30}'
                          updatedAt: 1782244060
                          createdAt: 1782243612
                          variants:
                            - id: "925889471688232962"
                              type: 1
                              status: 1
                              mimetype: image/jpeg
                              flags: 0
                              filename: clip_frame.jpeg
                              location: /800000000000000001/925889471688232962.jpeg
                              width: 854
                              height: 480
                              metadata: '{"resolutionMode":1}'
                              updatedAt: 1782243645
                              locations:
                                - locationId: "1"
                                  location: https://cdn3.fansly.com/800000000000000001/925889471688232962.jpeg?ngsw-bypass=true&Policy=EXAMPLE_POLICY&Key-Pair-Id=EXAMPLE_KEY&Signature=EXAMPLE_SIGNATURE
                            - id: "925889474821378050"
                              type: 302
                              status: 1
                              mimetype: application/vnd.apple.mpegurl
                              flags: 0
                              filename: 925889474821378050.m3u8
                              location: /800000000000000001/925889474821378050.m3u8
                              width: 1280
                              height: 720
                              metadata: '{"originalHeight":720,"originalWidth":1280,"duration":3000,"variants":[{"w":1280,"h":720},{"w":854,"h":480},{"w":640,"h":360}]}'
                              updatedAt: 1782244060
                              locations:
                                - locationId: "1"
                                  location: https://cdn3.fansly.com/800000000000000001/925889474821378050.m3u8?ngsw-bypass=true&Policy=EXAMPLE_POLICY&Key-Pair-Id=EXAMPLE_KEY&Signature=EXAMPLE_SIGNATURE
                          variantHash: []
                          locations:
                            - locationId: "1"
                              location: https://cdn3.fansly.com/800000000000000001/925889471688232961.mp4?ngsw-bypass=true&Policy=EXAMPLE_POLICY&Key-Pair-Id=EXAMPLE_KEY&Signature=EXAMPLE_SIGNATURE
                        whitelist:
                          - accountId: "800000000000000002"
                            permissionFlags: 0
                        purchased: true
                        whitelisted: true
                        accountPermissionFlags: 255
                        access: true
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          example: "925889499706191874"
                        accountId:
                          type: string
                          example: "800000000000000001"
                        mediaId:
                          type: string
                          example: "925889471688232961"
                        previewId:
                          type: string
                          example: null
                          nullable: true
                        permissionFlags:
                          type: integer
                          example: 8
                        price:
                          type: integer
                          example: 0
                        createdAt:
                          type: integer
                          example: 1782243618
                        deletedAt:
                          type: string
                          example: null
                          nullable: true
                        deleted:
                          type: boolean
                          example: false
                        permissions:
                          type: object
                          properties:
                            permissionFlags:
                              type: array
                              example:
                                - id: "925889499710373888"
                                  accountMediaId: "925889499706191874"
                                  type: 0
                                  flags: 8
                                  price: 0
                                  metadata: ""
                                  validAfter: null
                                  validBefore: null
                                  verificationFlags: 8
                                  verificationMetadata: "{}"
                              items:
                                type: object
                                properties:
                                  id:
                                    type: string
                                    example: "925889499710373888"
                                  accountMediaId:
                                    type: string
                                    example: "925889499706191874"
                                  type:
                                    type: integer
                                    example: 0
                                  flags:
                                    type: integer
                                    example: 8
                                  price:
                                    type: integer
                                    example: 0
                                  metadata:
                                    type: string
                                    example: ""
                                  validAfter:
                                    type: string
                                    example: null
                                    nullable: true
                                  validBefore:
                                    type: string
                                    example: null
                                    nullable: true
                                  verificationFlags:
                                    type: integer
                                    example: 8
                                  verificationMetadata:
                                    type: string
                                    example: "{}"
                            accountPermissionFlags:
                              type: object
                              properties:
                                flags:
                                  type: integer
                                  example: 255
                                metadata:
                                  type: string
                                  example: "{}"
                        likeCount:
                          type: integer
                          example: 0
                        media:
                          type: object
                          properties:
                            id:
                              type: string
                              example: "925889471688232961"
                            type:
                              type: integer
                              example: 2
                            status:
                              type: integer
                              example: 1
                            accountId:
                              type: string
                              example: "800000000000000001"
                            mimetype:
                              type: string
                              example: video/mp4
                            flags:
                              type: integer
                              example: 0
                            filename:
                              type: string
                              example: clip.mp4
                            location:
                              type: string
                              example: /800000000000000001/925889471688232961.mp4
                            width:
                              type: integer
                              example: 1280
                            height:
                              type: integer
                              example: 720
                            metadata:
                              type: string
                              example: '{"originalHeight":720,"originalWidth":1280,"duration":3000,"resolutionMode":1,"frameRate":30}'
                            updatedAt:
                              type: integer
                              example: 1782244060
                            createdAt:
                              type: integer
                              example: 1782243612
                            variants:
                              type: array
                              example:
                                - id: "925889471688232962"
                                  type: 1
                                  status: 1
                                  mimetype: image/jpeg
                                  flags: 0
                                  filename: clip_frame.jpeg
                                  location: /800000000000000001/925889471688232962.jpeg
                                  width: 854
                                  height: 480
                                  metadata: '{"resolutionMode":1}'
                                  updatedAt: 1782243645
                                  locations:
                                    - locationId: "1"
                                      location: https://cdn3.fansly.com/800000000000000001/925889471688232962.jpeg?ngsw-bypass=true&Policy=EXAMPLE_POLICY&Key-Pair-Id=EXAMPLE_KEY&Signature=EXAMPLE_SIGNATURE
                                - id: "925889474821378050"
                                  type: 302
                                  status: 1
                                  mimetype: application/vnd.apple.mpegurl
                                  flags: 0
                                  filename: 925889474821378050.m3u8
                                  location: /800000000000000001/925889474821378050.m3u8
                                  width: 1280
                                  height: 720
                                  metadata: '{"originalHeight":720,"originalWidth":1280,"duration":3000,"variants":[{"w":1280,"h":720},{"w":854,"h":480},{"w":640,"h":360}]}'
                                  updatedAt: 1782244060
                                  locations:
                                    - locationId: "1"
                                      location: https://cdn3.fansly.com/800000000000000001/925889474821378050.m3u8?ngsw-bypass=true&Policy=EXAMPLE_POLICY&Key-Pair-Id=EXAMPLE_KEY&Signature=EXAMPLE_SIGNATURE
                              items:
                                type: object
                                properties:
                                  id:
                                    type: string
                                    example: "925889471688232962"
                                  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: clip_frame.jpeg
                                  location:
                                    type: string
                                    example: /800000000000000001/925889471688232962.jpeg
                                  width:
                                    type: integer
                                    example: 854
                                  height:
                                    type: integer
                                    example: 480
                                  metadata:
                                    type: string
                                    example: '{"resolutionMode":1}'
                                  updatedAt:
                                    type: integer
                                    example: 1782243645
                                  locations:
                                    type: array
                                    example:
                                      - locationId: "1"
                                        location: https://cdn3.fansly.com/800000000000000001/925889471688232962.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/925889471688232962.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/925889471688232961.mp4?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/925889471688232961.mp4?ngsw-bypass=true&Policy=EXAMPLE_POLICY&Key-Pair-Id=EXAMPLE_KEY&Signature=EXAMPLE_SIGNATURE
                        whitelist:
                          type: array
                          example:
                            - accountId: "800000000000000002"
                              permissionFlags: 0
                          items:
                            type: object
                            properties:
                              accountId:
                                type: string
                                example: "800000000000000002"
                              permissionFlags:
                                type: integer
                                example: 0
                        purchased:
                          type: boolean
                          example: true
                        whitelisted:
                          type: boolean
                          example: true
                        accountPermissionFlags:
                          type: integer
                          example: 255
                        access:
                          type: boolean
                          example: true
      tags:
        - Media
components:
  securitySchemes:
    default:
      type: http
      scheme: bearer
      description: Get your API Key from OnlyFansAPI Console -
        https://app.onlyfansapi.com/api-keys
````