---
title: "List files pushed to a phone"
method: GET
path: "/phones/{phone_id}/files"
tags: ["phones"]
---

# List files pushed to a phone

`GET /phones/{phone_id}/files`

Returns the phone's file delivery records, newest first: which library files were pushed to it and where each push stands (dispatched / delivered / failed). Org-scoped: another org's phone reads as not found.

## Path parameters

- `phone_id` string, required — phone to list deliveries for

## Query parameters

- `limit` integer — max items per page
- `offset` integer — pagination offset

## Response `200`

OK

- FileDeliveryListResponse — One page of a phone's file delivery records.
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `deliveries` FileDeliverySummary[], nullable, required — Delivery records, newest first.
    - `created_at` string, date-time, required — When the push was dispatched.
    - `error` string — Failure detail for failed deliveries.
    - `file_id` string, required — Library file that was pushed.
    - `filename` string, required — Delivered file's display name.
    - `id` string, required — Delivery identifier.
    - `mime_type` string, required — Delivered file's MIME type.
    - `phone_id` string, required — Phone the file was pushed to.
    - `size_bytes` integer, required — Delivered file's size in bytes.
    - `status` 'dispatched' | 'delivered' | 'failed', required — dispatched while the phone downloads; delivered or failed once it reports back.
  - `total` integer, required — Total delivery records for the phone.

## Other responses

- `default` — Error

## Changes

- **2026-07-23** `5a989777701c` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/axilioai/apis/axilio-api/changes/phones/:phone_id/files/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/fe2a6226c46c/schema)