v8

latestOpenAPI 3.0.3raw.githubusercontent.com2026-05-2526602.8 MB
Media

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
get/api/{account}/media/uploads/{upload}/status

Response

OR
OR
OR

Example response

{
  "status": "processing",
  "prefixed_id": "ofapi_media_01JR1234"
}