Get Upload Status

Check the status of a temporary file upload.

GET /v1/uploads/{id}

Get Upload Status

cURL

curl --request GET \
  --url https://api.muvi.video/v1/uploads/{id} \
  --header 'Authorization: Bearer <token>'

200

{
  "id": "<string>",
  "filename": "<string>",
  "contentType": "<string>",
  "fileUrl": "<string>",
  "status": "<string>",
  "createdAt": "<string>",
  "expiresAt": "<string>"
}

Authentication

This endpoint requires an API key.

Authorization: Bearer YOUR_API_KEY

Path Parameters

id · string · required

The upload ID returned from the presign endpoint.

Response

id · string

Upload identifier.

filename · string

Original filename.

contentType · string

MIME type of the uploaded file.

fileUrl · string

CDN URL of the file.

status · string

Upload status: pending (file available) or expired (file deleted).

createdAt · string

ISO 8601 timestamp of when the upload was created.

expiresAt · string

ISO 8601 timestamp of when the file will be deleted.

Error Codes

Code	Description
NOT_FOUND	Upload not found or does not belong to your account.

Examples

cURL

curl https://api.muvi.video/v1/uploads/3f44e3c6-acd9-4cc3-a91b-e63ec517b383 \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "success": true,
  "data": {
    "id": "3f44e3c6-acd9-4cc3-a91b-e63ec517b383",
    "filename": "my-image.png",
    "contentType": "image/png",
    "fileUrl": "https://assetsv1.cdn.muvi.video/temp/user_abc123/uuid_my-image.png",
    "status": "pending",
    "createdAt": "2026-02-25T10:42:21.949Z",
    "expiresAt": "2026-02-25T11:42:21.949Z"
  },
  "requestId": "req_abc123"
}