---
title: "List the org's uploads"
method: GET
path: "/uploads"
tags: ["uploads"]
---

# List the org's uploads

`GET /uploads`

Returns one page of the files the org uploaded, newest first, with the org's standing usage against its storage quota. Uploads persist until deleted and can be delivered to any phone the org holds.

## Query parameters

- `limit` integer — max items per page
- `offset` integer — pagination offset
- `q` string — filter by filename, case-insensitive substring match
- `sort` 'created_at' | 'filename' | 'size_bytes' — field to sort by
- `order` 'asc' | 'desc' — sort direction

## Response `200`

OK

- FileListResponse — One page of the org's file library.
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `files` FileSummary[], nullable, required — Library entries, newest first.
    - `created_at` string, date-time, required — When the upload was registered.
    - `download_url` string — Short-lived signed URL to read the file's bytes. Present only for ready files; re-list to refresh an expired one.
    - `filename` string, required — Original filename; used as the display name when the file lands on a phone.
    - `id` string, required — File identifier. Unique across uploads and downloads.
    - `mime_type` string, required — Declared MIME type, pinned by the presigned upload.
    - `size_bytes` integer, required — Declared size in bytes, pinned by the presigned upload.
    - `status` 'uploading' | 'ready', required — uploading until the object is verified in storage, then ready. Complete an upload to move it to ready.
  - `total` integer, required — Total files matching the query.
  - `usage` FileUsage, required — The org's standing library usage against its quota.
    - `byte_limit` integer, required — Storage quota in bytes.
    - `file_count` integer, required — Files currently in the library.
    - `file_limit` integer, required — Maximum files the library will hold.
    - `total_bytes` integer, required — Total bytes currently stored.

## Other responses

- `default` — Error

## Changes

- **2026-07-26** `a0204e0956bc` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/axilioai/apis/axilio-api/changes/uploads/get.md)

---

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