v1

latestOpenAPI 3.1.02026-07-24317911.4 MB
Devices

Get Devices for User

get/domains/{domain}/users/{user}/devices

Path parameters

domainstring required

This is the main organization name. This is used to link resource to its group/tenant/organization/enterprise. Then using in path for GET you can set to "~" to use the domain name linked to your token/key instead of the domain name itself when reading for your own domain.

Example:example.com
userstring required

This is the main user extension for the user account. ~ can be used to mean "my account" which will extract the user from the token/key used for authentication.

Example:1000

Response

devicestring required

This is the "device" id which will be the first part of the device-sip-registration-uri which can be used to read specific device information.

userstring required

This is the main user extension for the user account.

domainstring required

This is the main organization name. This is used to link resource to its group/tenant/organization/enterprise. ~ and * can be used alone in special cases to mean My Domain (~) and All Domains (*).

device-sip-registration-uristring

This read-only value is the full SIP uri and will often be sip:[device]@[domain]

device-sip-registration-state'registered' | 'unregistered'

This is the current registration status for the device. This value will be registered if its in the value time windoe

device-sip-registration-passwordstring password

This is the password which would be used for device registration. If left unset on device create it will create a new random password with a default length of 16 characters.

caller-id-number-emergencystring

This is a override value for emergency caller id value that would be specific to this device and would override the user's set value.

device-force-notify-new-voicemails-enabled'yes' | 'no'
device-level-call-recording-enabled'yes' | 'no'
device-push-enabled'yes' | 'no'
device-sip-registration-contactstring

This is the contact value for the device from the last successfull registration.

device-sip-registration-core-serverstring hostname

This is the hostname for which the last registration was completed. This would be used to connect the device from on inbound call.

device-sip-registration-datetimestring date-time nullable

This date-time will be the last registration time of the device. This time may be slightly delayed to improve replication throughput.

device-sip-registration-expires-datetimestring date-time nullable

This date-time will be the time at which the device will be treated as unregisted and should be in the future for active registed devices.

device-sip-registration-expiry-secondsinteger

This is the requested re-register perior for the device. The device will be treated as unregistered if they do not register in this window + a system wide grace period.

device-sip-registration-ignore-for-presence-calculation'yes' | 'no'
device-sip-registration-ignore-report-enabled'yes' | 'no'
device-sip-registration-ip-addressstring i

This is the read-only value is the IP:port for the last successfull registration.

device-sip-registration-user-agentstring

This is the read-only value for the user-agent used during the last successfully registration.

device-sip-no-to-tag-in-cancel'yes' | 'no'
device-srtp-enabled'yes' | 'no' | 'opportunistic'

This setting will enable SRTP (secure/encrypted audio) on the the device. Yes will force and "opp

auto-answer-enabled'yes' | 'no'
recording-configuration'yes' | 'yes-with-transcription' | 'yes-with-transcription-and-sentiment' | 'no'

Option whether to record calls or not. Available options are "yes", "yes-with-transcription", "yes-with-transcription-and-sentiment", or "no"

device-sip-allowed-user-agentstring

This value can be used to restrict registration to a specific User Agent or partial match of User Agent. This allows for an extra layer of secutiry if you know the expected user agent.

device-sip-nat-traversal-enabled'automatic' | 'none' | 'never' | 'fixed'

This is the main nat transveral setting. In most all device cases "automatic" is the correct answe

device-sip-latency-seconds-currentnumber

This is the latency from the latest registration measured in seconds from the time the core sent a 407 challenge to the 200ok with Auth.

device-sip-latency-seconds-averagenumber

This is the average of the last 5 registration attempts measured similiarly to device-sip-latency-seconds-current.

emergency-address-idstring nullable

This value if set will be the address-id specific to this device for emegeny calling

error-reading-from-endpoint-modulestring

If yes, it means the API had an issue accessing the NDP for mac specific data

login-usernamestring

This is a read-only value of the user's login for the owner of the device.

name-full-namestring

This is a read-only value of the user's full name for the owner of the device.

device-models-modelstring

This is an optional model that when provided with device-provisioning-mac-address will link this device to the mac address in the device provisioning platform.

device-provisioning-mac-addressstring

This is the mac address that has this device linked to it. This field can be used to link a mac address on device create. Must also provide a device-models-model

device-provisioning-registration-core-serverstring

This is the SiPbx Servers primary server config from a list of valid

device-provisioning-sip-transport-protocol'udp' | 'tcp' | 'tls'

This is the transport that will be requested when provising the device.

device-provisioning-usernamestring nullable

The provisioning username for the request to authenticate the configuration request.

device-provisioning-passwordstring nullable

The provisioning password for the request to authenticate the configuration request.

device-provisioning-lineinteger

Optional setting to select which line is used on the device when provisionined with device-models-model and device-provisioning-mac-address

device-provisioning-overridesstring

This is the overrides set for the mac address in the provisioning server on the mac linked to this device.

Example response

[
  {
    "user": "1000",
    "domain": "example.com",
    "device-sip-registration-user-agent": "Yealink T48 2.3.232"
  }
]