AXaxilioai
phones

Get a phone

Changed on

Returns a single phone by its identifier.

get/phones/{phone_id}

Request

Path parameters

phone_idstring required

device identifier

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

created_atstring date-time required

When the phone record was created.

current_session_idstring nullable required

Session currently holding the phone, if allocated.

last_heartbeat_atstring date-time nullable required

Time of the phone's most recent heartbeat.

last_interaction_atstring 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_numberstring nullable required

The phone's own number in E.164, for a dedicated phone your organization rents: what its SIM reports, or else the number its latest received text was sent to. Null when neither is known, and for shared phones.

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' | 'recovering' | 'out_of_service' required

Fleet status of the phone. Only active is allocatable. inactive: unreachable, back on its next heartbeat. maintenance: planned work that releases itself. suspended: an administrative hold. recovering: being repaired automatically. out_of_service: needs a repair at the rack. Treat unknown values as unavailable.

updated_atstring date-time required

When the phone record was last updated.

Example response

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

Changes

  • 49b1da5a7974Revision changes
    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

  • 7abfd1e84b24Revision changes
    • warning

      added the new out_of_service enum value to the response property for the response status

    • warning

      added the new recovering enum value to the response property for the response status