Skip to main content
GET
/
v1
/
uploads
/
{id}
Get Upload Status
curl --request GET \
  --url https://api.muvi.video/v1/uploads/{id} \
  --header 'Authorization: Bearer <token>'
{
  "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

CodeDescription
NOT_FOUNDUpload not found or does not belong to your account.

​
Examples

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"
}