Access Log1

Addresses15

Answer Rules8

Audit Log1

Authentication/Access Token (Oauth - Username/Password)5

Authentication/API Key (Machine 2 Machine)6

Authentication/JWT (JSON Web Token)8

Auto Attendant5

Backup & Restore4

Call Blocking6

Call Center/Agent Actions4

Call Center/Agents7

Call Center/Callqueues6

Call Center/QueuedCalls2

Call Center/Statistics11

Call Traces & Cradle to Grave3

Calls (live/active calls)13

CDR (Call History)8

CDR Schedule3

Charts2

Conference/Conferences7

Conference/Participants4

Configs/Configuration Definitions5

Configs/Configurations6

Connections7

Contacts7

Contacts/Shared Contacts5

Dashboards2

Departments1

Devices10

Dial Permisions18

Dialrule11

Domains9

Email2

Event Subscriptions9

Firebase2

Images6

iNSight1

Media/Greetings10

Media/Hold Messages/Domain5

Media/Hold Messages/User5

Media/Music on Hold/Domain9

Media/Music on Hold/User9

Media/Text to Speech3

Media/Voicemail6

Meetings10

Meetings/Event Logs2

Meetings/Iotum19

Messages15

Messages/SMS Block5

Phone Numbers8

Phone Numbers/Use Cases4

Phones/Macs11

Phones/Macs/Supported Models and Servers5

Presence2

Quotas4

Recordings2

Resellers6

Routes10

Sites6

SMS Numbers7

SnapBuilder8

SnapBuilder/Phone Templates6

SSL Certificates5

Templates4

Timeframes/Domain (Shared)4

Timeframes/Domain (Shared)/Always1

Timeframes/Domain (Shared)/Custom5

Timeframes/Domain (Shared)/Days of Week2

Timeframes/Domain (Shared)/Holiday5

Timeframes/Domain (Shared)/Specific Dates5

Timeframes/Holiday Information4

Timeframes/User5

Timeframes/User/Always1

Timeframes/User/Custom5

Timeframes/User/Days of Week2

Timeframes/User/Holiday5

Timeframes/User/Specific Dates5

Transcriptions & Sentiment1

Users9

Version1

Voicemail Reminders5

Phones/Macs

Read Mac Addresses

Changed on Nov 3, 2026

get/phones

Request

Base URL
https://ns-api.com/ns-api/v2
URL
https://ns-api.com/ns-api/v2/phones
Auth
HTTP bearer

Query parameters

limitnumber

This is the limit of the number of objects that will be returned in the read/list API call. This can be used with pagination to help retrieve smaller chunks of data. Should be used in conjunction with Start.

Response

device-provisioning-mac-addressstring mac required

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 (*).

resellerstring required

device-models-brand-and-modelstring required

device-provisioning-registration-core-serverstring required

notesstring required

device-provisioning-sip-uri-1string required

device-provisioning-line-1-enabled'yes' | 'no' required

device-provisioning-sip-uri-1-shared-line-enabledstring required

device-provisioning-sip-uri-2string required

device-provisioning-line-2-enabled'yes' | 'no' required

device-provisioning-sip-uri-2-shared-line-enabledstring required

device-provisioning-sip-transport-protocolstring required

device-provisioning-usernamestring required

device-provisioning-passwordstring password required

device-models-count-buttonsinteger required

device-models-fxs-support-enabledinteger required

device-models-overrides-blobstring required

device-models-resync-support-enabledstring required

device-models-shared-line-support-enabledstring required

device-models-sidecar-support-enabledstring required

device-provisioning-last-retrieved-datetimestring required

device-provisioning-directorystring required

device-provisioning-directory-supportstring required

device-provisioning-line-1-extensionsstring

device-provisioning-line-2-extensionsstring

device-provisioning-ndp-hostnamestring required

device-provisioning-presencestring required

created-datetimestring required

global-one-time-passstring required

last-modified-datetimestring date-time

redundencystring required

device-provisioning-sip-uri-3string

device-provisioning-line-3-enabledstring

device-provisioning-sip-uri-3-shared-line-enabledstring

device-provisioning-sip-uri-4string

device-provisioning-line-4-enabledstring

device-provisioning-sip-uri-4-shared-line-enabledstring

device-provisioning-sip-uri-5string

device-provisioning-line-5-enabledstring

device-provisioning-sip-uri-5-shared-line-enabledstring

device-provisioning-sip-uri-6string

device-provisioning-line-6-enabledstring

device-provisioning-sip-uri-6-shared-line-enabledstring

device-provisioning-sip-uri-7string

device-provisioning-line-7-enabledstring

device-provisioning-sip-uri-7-shared-line-enabledstring

device-provisioning-sip-uri-8string

device-provisioning-line-8-enabledstring

device-provisioning-sip-uri-8-shared-line-enabledstring

device-sip-registration-contactstring

device-sip-registration-datetimestring

device-sip-registration-expires-datetimestring

device-sip-registration-statestring nullable

device-sip-registration-user-agentstring

Example response

[
  {
    "device-provisioning-mac-address": "000011223344",
    "domain": "example.com"
  }
]

Changes

Nov 3, 2026bce16087d479 Revision changes
- breaking
  the / response's property format changed from date to no format for status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- info
  removed the non-success response with the status
- info
  removed the non-success response with the status
- info
  removed the non-success response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  the response optional property / became not read-only for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response's property default value no was removed for the status
- info
  removed the no enum value from the / response property for the response status
- info
  removed the yes enum value from the / response property for the response status
- info
  the / response's property pattern ^[A-Za-z0-9._-]+|\* was added for 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
- 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
- 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
- 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
- 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
- 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
- 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
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status

Operation history