# Get an upload

`GET https://api.cream-ai.de/api/v1/uploads/{id}`

The metadata of an upload of your company (never the file). Uploads of other companies and unknown ids return `404 not_found`; expired uploads `410 upload_expired`.

Scopes: `uploads:write`

## Parameters

- `id` (path, required): Id of the upload (id from POST /uploads).

## Returns

- 200: The upload.

## Errors

- 401: Missing, malformed, revoked or expired API key (unauthorized).
- 403: Not allowed (forbidden_scope, ip_not_allowed, company_inactive, api_not_enabled).
- 404: Not found (not_found).
- 410: The upload has expired (upload_expired). Upload the file again.
- 429: Too many requests (rate_limited).
- 500: Internal error (internal). Quote the request id when you contact support.
- 503: Temporarily unavailable (service_unavailable). Retry later (after Retry-After seconds, if sent).

## Example request

```sh
curl "https://api.cream-ai.de/api/v1/uploads/upl_3f9a1c7e5b2d4a6c8e0f1a3b5c7d9e1f" \
  -H "Authorization: Bearer $MINT_API_KEY"
```

## Example response (200)

```json
{
  "object": "upload",
  "id": "upl_3f9a1c7e5b2d4a6c8e0f1a3b5c7d9e1f",
  "filename": "screenshot-scene-4.png",
  "content_type": "image/png",
  "bytes": 284113,
  "sha256": "3a7bd3e2360a3d29eea436fcfb7e44c735d117c42d1c1835420b6b9942dd4f1b",
  "created_at": "2026-11-10T08:30:12Z",
  "expires_at": "2026-11-17T08:30:12Z"
}
```