Phones
Get a phone
Returns a single phone by its identifier.
get/phones/{phone_id}
Path parameters
phone_idstring required
device identifier
device identifier
Response
OK
created_atstring date-time required
When the phone record was created.
current_session_idstring nullable required
Session currently holding the phone, if allocated.
last_heartbeatstring date-time nullable required
Time of the phone's most recent heartbeat.
last_interaction_timestampstring date-time nullable required
Time of the most recent interaction on the phone.
locationstring nullable required
Physical hosting location of the phone.
model_idstring nullable required
Hardware model identifier.
model_namestring nullable required
Hardware model name.
nicknamestring nullable required
User-assigned nickname.
owner_organization_idstring nullable required
Owning organization, for private phones.
ownership_type'shared' | 'private' required
'shared' for pool phones, 'private' for dedicated rentals.
phone_idstring required
Phone identifier used by allocate and the phone APIs.
phone_namestring nullable required
Display name of the phone.
phone_type'android' | 'iphone' | 'unknown' nullable required
Platform of the phone.
rental_expires_atstring date-time nullable required
When the current rental ends, for rented phones.
status'active' | 'inactive' | 'maintenance' | 'suspended' required
Fleet status of the phone.
updated_atstring date-time required
When the phone record was last updated.