---
title: "Get upload session state"
method: GET
path: "/upload-sessions/{token}"
tags: ["Upload Sessions"]
---

# Get upload session state

`GET /upload-sessions/{token}`

Returns the session's status, expiry, and the assets uploaded through it so far. A 'done' session stays viewable here (only 'expired' 410s). The token is the sole credential — no API key required.

## Path parameters

- `token` string, required — Upload session bearer token

## Response `200`

Session state (active or done)

- object
  - `data` object, required
    - `status` string, required — active | done | expired
    - `expiresAt` integer, required — Session expiry (Unix ms)
    - `expectedFiles` object[], required — Files the creator told the page to expect (advisory, not enforced)
      - `filename` string, required
      - `size` number
    - `maxFiles` integer, required — Max files this session may upload
    - `assets` object[], required
      - `id` string, required — Asset ID
      - `filename` string, nullable, required — Display filename
      - `status` string, required — pending | uploading | ready | failed | expired
      - `url` string — Stable content URL — present only once the asset is ready

## Other responses

- `404` — Unknown token
- `410` — Session expired

## Changes

> 7 revisions in range; 2 could not be searched.

- **2026-08-29** `4d10ec4266ee` — 1 info
  - api operation id `getUploadSession` was added
- **2026-07-26** `ad4351c79853` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/rendobar/apis/rendobar-api/changes/upload-sessions/:token/get.md)

---

[API](https://skmtc.dev/rendobar/apis/rendobar-api.md) · [All operations](https://skmtc.dev/rendobar/apis/rendobar-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rendobar/rendobar-api/revisions/4d10ec4266ee/schema)