> ## Documentation Index
> Fetch the complete documentation index at: https://developer.pixelbyte.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Upload Status

> Check the status of a temporary file upload.

## Authentication

This endpoint requires an API key.

```
Authorization: Bearer YOUR_API_KEY
```

## Path Parameters

<ParamField path="id" type="string" required>
  The upload ID returned from the presign endpoint.
</ParamField>

## Response

<ResponseField name="id" type="string">
  Upload identifier.
</ResponseField>

<ResponseField name="filename" type="string">
  Original filename.
</ResponseField>

<ResponseField name="contentType" type="string">
  MIME type of the uploaded file.
</ResponseField>

<ResponseField name="fileUrl" type="string">
  CDN URL of the file.
</ResponseField>

<ResponseField name="status" type="string">
  Upload status: `pending` (file available) or `expired` (file deleted).
</ResponseField>

<ResponseField name="createdAt" type="string">
  ISO 8601 timestamp of when the upload was created.
</ResponseField>

<ResponseField name="expiresAt" type="string">
  ISO 8601 timestamp of when the file will be deleted.
</ResponseField>

## Error Codes

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

## Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.muvi.video/v1/uploads/3f44e3c6-acd9-4cc3-a91b-e63ec517b383 \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://api.muvi.video/v1/uploads/3f44e3c6-acd9-4cc3-a91b-e63ec517b383",
      headers={"Authorization": "Bearer YOUR_API_KEY"}
  )

  data = response.json()["data"]
  print(f"Status: {data['status']}")
  print(f"File URL: {data['fileUrl']}")
  print(f"Expires at: {data['expiresAt']}")
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    "https://api.muvi.video/v1/uploads/3f44e3c6-acd9-4cc3-a91b-e63ec517b383",
    {
      headers: { "Authorization": "Bearer YOUR_API_KEY" }
    }
  );

  const { data } = await response.json();
  console.log(`Status: ${data.status}`);
  console.log(`File URL: ${data.fileUrl}`);
  ```
</CodeGroup>

### Example Response

```json theme={null}
{
  "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"
}
```