# Upload status

URL: https://www.atmee.ai/docs/v2/api/reference/avatars/getUpload

`GET /v1/uploads/{uploadId}`

`pending` until the file arrives, then `uploaded` (usable once), `consumed`
once a create or replace used it, or `expired` an hour after it was
created. Only the account that created it sees it. Requires
`avatars:read` or `avatars:write`.

## Parameters

| Name | In | Required | Description |
| --- | --- | --- | --- |
| `uploadId` | path | yes |  |

## Responses

| Status | Description | Schema |
| --- | --- | --- |
| `200` | The upload. | `Upload` |
| `401` | Missing or invalid API key -- or a user token that is invalid, anonymous, or of a user who may act for no account (invalid_login) | none |
| `403` | insufficient_scope \| account_not_allowed (a user token whose X-Account-Id names an account the user may not act for) | `ApiErrorResponse` |
| `404` | upload_not_found | `ApiErrorResponse` |
| `409` | account_ambiguous -- a user token of a user who may act for several accounts, without an `X-Account-Id` header naming one. | `ApiErrorResponse` |
| `503` | upload_unavailable -- this instance has no upload store. | `ApiErrorResponse` |

## `200` response fields

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `uploadId` | string | yes |  |
| `kind` | `UploadKind` | yes |  |
| `status` | string (`pending`, `uploaded`, `consumed`, `expired`) | yes |  |
| `size` | integer | no | Bytes received, once uploaded. |
| `contentType` | string | no | The declared type, then the type the file was sent with. |
| `fileName` | string | no |  |
| `expiresAt` | string | yes |  |