---
title: "Get Upload Status"
method: GET
path: "/api/{account}/media/uploads/{upload}/status"
tags: ["Media"]
---

# Get Upload Status

`GET /api/{account}/media/uploads/{upload}/status`

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

**Possible statuses:**
- `pending` — Upload is queued
- `processing` — Download/upload in progress
- `completed` — Upload finished, `media` and `credits_used` are included
- `failed` — Upload failed, `error` is included

## Response `200`

- union
  - object — Upload still processing
    - `status` string
    - `prefixed_id` string
  - object — Upload failed
    - `status` string
    - `prefixed_id` string
    - `error` string
  - object — Completed POST /media/vault upload
    - `status` string
    - `prefixed_id` string
    - `media` object
      - `id` integer
      - `type` string
      - `convertedToVideo` boolean
      - `canView` boolean
      - `hasError` boolean
      - `createdAt` string
      - `isReady` boolean
      - `files` object
        - `full` object
          - `url` string, nullable
          - `width` integer
          - `height` integer
          - `size` integer
          - `sources` unknown[]
            - unknown
        - `thumb` string, nullable
        - `preview` string, nullable
        - `squarePreview` string, nullable
      - `duration` integer
      - `releaseForms` unknown[]
        - unknown
      - `hasCustomPreview` boolean
    - `credits_used` integer
  - object — Completed POST /media/upload upload
    - `status` string
    - `prefixed_id` string
    - `media` object
      - `prefixed_id` string
      - `file_name` string
      - `processId` string
      - `host` string
      - `sourceUrl` string
      - `extra` string
      - `additional` object
        - `user` string
      - `thumbs` object[]
        - `id` integer
        - `url` string
    - `credits_used` integer

---

[API](https://skmtc.net/onlyfansapi/apis/onlyfans-api.md) · [All operations](https://skmtc.net/onlyfansapi/apis/onlyfans-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/onlyfansapi/onlyfans-api/revisions/4a99d36f28a3/schema)