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.

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