---
title: "List a phone's file deliveries"
method: GET
path: "/phones/{phone_id}/deliveries"
tags: ["phones"]
---

# List a phone's file deliveries

`GET /phones/{phone_id}/deliveries`

Returns the phone's file delivery records, newest first: which library files were sent to it and where each stands (dispatching / 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.
    - `$schema` string, uri — A URL to the JSON Schema for this object.
    - `bytes_transferred` integer — Bytes the phone has downloaded so far. Absent until the phone reports progress.
    - `created_at` string, date-time, required — When the push was dispatched.
    - `error` string — Failure detail for failed deliveries.
    - `file_id` string — Library file that was pushed. Absent once that file has been deleted; the filename and size below are snapshots taken at push time and survive it.
    - `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` 'dispatching' | 'dispatched' | 'delivered' | 'failed', required — dispatching while the push is being published, dispatched while the phone downloads, then delivered or failed once it reports back.
  - `total` integer, required — Total delivery records for the phone.

## 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/versions/108ab4b41051/schema)