Sign in

v12

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-014994227.2 KB
phones

Get one file delivery

Returns a single delivery by id and its current status. Poll this to wait on a specific push: the list endpoint pages the newest records and can drop a delivery that ages past the page on a busy phone.

get/phones/{phone_id}/deliveries/{delivery_id}

Path parameters

phone_idstring required

phone the delivery belongs to

phone the delivery belongs to

delivery_idstring uuid required

delivery to fetch

delivery to fetch

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

created_atstring date-time required

When the push was dispatched.

errorstring

Failure detail for failed deliveries.

file_idstring required

Library file that was pushed.

filenamestring required

Delivered file's display name.

idstring required

Delivery identifier.

mime_typestring required

Delivered file's MIME type.

phone_idstring required

Phone the file was pushed to.

size_bytesinteger 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.

Example response

{
  "$schema": "/api/v1/FileDeliverySummary.json"
}