OnlyFans API
OnlyFans

Get 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

Instead of polling, you can subscribe to the media_uploads.completed and media_uploads.failed webhook events. They carry the same fields as this endpoint and are only sent for async (async=true) uploads — synchronous uploads return their result directly.

GET
/api/{account}/media/uploads/{upload}/status
AuthorizationBearer <token>

Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys

In: header

Path Parameters

account*string

The Account ID

upload*string

The prefixed ID of the upload.

Response Body

application/json

curl -X GET "https://app.onlyfansapi.com/api/acct_XXXXXXXXXXXXXXX/media/uploads/ofapi_media_01JR1234/status"
{
  "status": "processing",
  "prefixed_id": "ofapi_media_01JR1234"
}