---
title: "Check upload status"
method: GET
path: "/v1/upload/{uploadId}/status"
---

# Check upload status

`GET /v1/upload/{uploadId}/status`

## Request

- Base URL: `https://api.payaion.com`
- URL: `https://api.payaion.com/v1/upload/{uploadId}/status`
- Auth: API key in header `X-Aion-Key`

Poll this endpoint after uploading. The `ready` boolean is `true`
only when status is `READY` and the file is downloadable.

## Path parameters

- `uploadId` string, required

## Response `200`

Upload status

- UploadStatus
  - `uploadId` string, required
  - `status` 'PENDING_UPLOAD' | 'UPLOADING' | 'READY' | 'FAILED' | 'DELETING' | 'DELETED', required
  - `ready` boolean, required
  - `updatedAt` string, date-time

## Other responses

- `401`: Invalid or missing credentials
- `404`: Resource not found
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/payaion/apis/payaion-api.md) · [All operations](https://skmtc.dev/payaion/apis/payaion-api/llms.txt) · [OpenAPI document](https://skmtc.dev/payaion/apis/payaion-api/revisions/29927240cfc2?raw)
