> ## 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 Upload Status (/api-reference/fansly/media/get-upload-status)

Check the status of an async Fansly media upload. Poll until status is `completed` or `failed`. This endpoint is free and does not cost any credits.

**Possible statuses:**

* `pending` — Upload is queued
* `processing` — Upload in progress
* `completed` — Upload finished, `media_id` and `media` are included
* `failed` — Upload failed, `error` is included

## OpenAPI

````yaml https://app.onlyfansapi.com/scribe-fansly-docs/openapi.yaml get /api/fansly/{fanslyAccount}/media/uploads/{upload}/status
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}/media/uploads/{upload}/status:
    parameters:
      - in: path
        name: fanslyAccount
        description: The Fansly Account ID
        example: fansly_acct_XXXXXXXXXXXXXXX
        required: true
        schema:
          type: string
      - in: path
        name: upload
        description: The prefixed ID of the upload.
        example: fansly_media_01JR1234
        required: true
        schema:
          type: string
    get:
      summary: Get Upload Status
      operationId: getUploadStatus
      description: >-
        Check the status of an async Fansly media upload. Poll until status is
        `completed` or `failed`. This endpoint is free and does not cost any
        credits.


        **Possible statuses:**

        - `pending` — Upload is queued

        - `processing` — Upload in progress

        - `completed` — Upload finished, `media_id` and `media` are included

        - `failed` — Upload failed, `error` is included
      parameters: []
      responses:
        "200":
          description: ""
          content:
            application/json:
              schema:
                oneOf:
                  - description: Upload still processing
                    type: object
                    example:
                      status: processing
                      prefixed_id: fansly_media_01JR1234
                    properties:
                      status:
                        type: string
                        example: processing
                      prefixed_id:
                        type: string
                        example: fansly_media_01JR1234
                  - description: Upload failed
                    type: object
                    example:
                      status: failed
                      prefixed_id: fansly_media_01JR1234
                      error: Failed to download file from the provided URL.
                    properties:
                      status:
                        type: string
                        example: failed
                      prefixed_id:
                        type: string
                        example: fansly_media_01JR1234
                      error:
                        type: string
                        example: Failed to download file from the provided URL.
                  - description: Completed upload
                    type: object
                    example:
                      status: completed
                      prefixed_id: fansly_media_01JR1234ABCD5678EFGH
                      media_id: "800000000000000010"
                      media:
                        id: "800000000000000010"
                        type: 1
                        status: 1
                        accountId: "800000000000000001"
                        mimetype: image/jpeg
                        filename: photo.jpg
                        width: 1080
                        height: 1080
                      credits_used: 1
                    properties:
                      status:
                        type: string
                        example: completed
                      prefixed_id:
                        type: string
                        example: fansly_media_01JR1234ABCD5678EFGH
                      media_id:
                        type: string
                        example: "800000000000000010"
                      media:
                        type: object
                        properties:
                          id:
                            type: string
                            example: "800000000000000010"
                          type:
                            type: integer
                            example: 1
                          status:
                            type: integer
                            example: 1
                          accountId:
                            type: string
                            example: "800000000000000001"
                          mimetype:
                            type: string
                            example: image/jpeg
                          filename:
                            type: string
                            example: photo.jpg
                          width:
                            type: integer
                            example: 1080
                          height:
                            type: integer
                            example: 1080
                      credits_used:
                        type: integer
                        example: 1
      tags:
        - Media
components:
  securitySchemes:
    default:
      type: http
      scheme: bearer
      description: Get your API Key from OnlyFansAPI Console -
        https://app.onlyfansapi.com/api-keys
````