---
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.
    - `attachment_url` string — Short-lived signed URL that downloads the file as an attachment under its name. Present only for ready files.
    - `bytes_transferred` integer — Bytes moved so far for an in-flight phone transfer. Absent until the phone reports progress.
    - `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.
    - `duration_seconds` integer — Video duration in seconds.
    - `filename` string, required — Original filename; used as the display name when the file lands on a phone.
    - `height` integer — Intrinsic pixel height of the source.
    - `id` string, required — File identifier. Unique across uploads and downloads.
    - `mime_type` string, required — Declared MIME type, pinned by the presigned upload.
    - `on_phone_count` integer, required — Distinct phones currently holding or receiving a copy. Deleting the file recalls these.
    - `preview_state` 'processing' | 'ready' | 'unavailable', required — Whether the preview exists, is still being generated, or will never be available for this format.
    - `reel_url` string — Short-lived signed URL for the animated hover preview. Videos only; absent until generated.
    - `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.
    - `thumbnail_url` string — Short-lived signed URL for the generated preview image. Absent while generation is pending, and permanently absent for formats without a preview.
    - `width` integer — Intrinsic pixel width of the source.
  - `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

---

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