Extensions

Get extensions list

This endpoint allows your application to get a list of your company's users, or extensions, as well as their current phone presence status (free, oncall).

Each entry is keyed by the extension number and contains the callerid (the display name of the user), the current state, and updated, the Unix timestamp of the last state change. This is handy to display a live "who is on the phone" view, or to decide whether a call can be transferred to someone right away.

GET or POST https://api.ubity.com/extensions?key=KKKK

% curl -H "Accept: application/json;version=0" "https://api.ubity.com/extensions?key=KKKK"

{
  "api_key": "KKKK",
  "code": 200,
  "diagnostic": "Success",
  "extensions": {
    "42": {
      "callerid": "Foo Bar",
      "state": "free",
      "updated": 1518636657.0
    },
    "43": {
      "callerid": "Baz Qwe",
      "state": "oncall",
      "updated": 1518627835.0
    },
  },
  "stamp": "2018-02-14 15:37",
  "url": "https://api.ubity.com/extensions?key=KKKK",
  "version": 0
}