1. Domain Settings
NetSapiens API v2
  • Authentication
    • Access Token (Oauth - Username/Password)
      • Get Access Token From Refresh
      • Get Access Token From User/Pass
      • Get Access Token after MFA request
    • API Key (Machine 2 Machine)
      • Read API Keys under your account
      • Read API Keys under your account
      • Read API Key info on your API Key
      • Create API Key
      • Update API Key
      • Revoke API Key
      • Read Info on specific APIKey via Key ID
      • Read API Keys
    • JWT (JSON Web Token)
      • Create JWT token From User/Pass
      • Create JWT token from Refresh JWT
      • Create JWT token after MFA request
      • Create JWT token For Delegated Access
      • Revoke JWT(s) by UID (user@domain)
      • Revoke JWT by JTI (JWT ID)
      • Revoke current JWT
      • Read Current JWT
      • Generate Short-Lived Application JWT
      • Create JWT token from Refresh JWT
      • Create JWT token after MFA request
    • NetsapiensJs Auth
      • MFA
        • Generate MFA Authenticator
        • MFA Verify
        • MFA Enroll (without token)
        • MFA Enroll (with token)
        • MFA Delete
      • OIDC Authorize
    • Masquerade
  • Phone Numbers
    • destination-application mappings and parameter parsing
    • Use Cases
      • Send Phonenumber to Call Queue
      • Send Phonenumber to a User
      • Send Phonenumber to Offnet Number
      • Move phonenumber back to Available in Inventory
      • Send Phonenumber to a User
      • Send Phonenumber to Offnet Number
      • Move phonenumber back to Available in Inventory
    • Count Phone Numbers for Domain
      GET
    • Get All Phone Numbers for System or Reseller
      GET
    • Count All Phone Numbers for System or Reseller
      GET
    • Get All Phone Numbers for Domain
      GET
    • Add Phone Number in Domain
      POST
    • Remove Phone Number from Domain
      DELETE
    • Update Phone Number in Domain
      PUT
    • Get Specific Phone Number in Domain
      GET
    • List Domain Phone Numbers
      GET
  • Phones/Macs
    • Supported Models and Servers
      • Get list of Supported/Provisionable Models
      • Get list of Supported/Provisionable by Vendor
      • Get details of Specific Model
      • Get list of Provisionable Server Profiles
      • Read Provisionable Server Details
    • Phone Configurations
    • Read Mac Addresses
      GET
    • Count Mac Addresses
      GET
    • Read Mac Addresses in Domain
      GET
    • Read Specific Mac Address
      GET
    • Read Specific Mac Addresses in Domain
      GET
    • Add MAC address
      POST
    • Add MAC address for Domain
      POST
    • Update MAC address
      PUT
    • Update MAC address in Domain
      PUT
    • Remove MAC address
      DELETE
    • Remove MAC address in Domain
      DELETE
  • SnapBuilder
    • Phone Templates
      • Read Phone Templates available to a Domain
      • Read Specific Phone Templates by name
      • Count Phone Templates for a Domain
      • Create Phone Template in domain
      • Update Phone Template in domain
      • Delete Phone Template in domain
    • Read Device Profiles
    • Count Device Profiles
    • Get specific Device Profile for Model of Phone
    • Count Phone Configurations in a Domain
    • Get Phone Configuration for specific Mac
    • Create Phone Configuration for Specific Mac Address
    • Update Phone Configuration for Specific Mac Address
    • Delete Phone Configuration for Specific Mac Address
  • Version
    • Read API Version
    • Get Health Status of the API
  • Event Subscriptions
    • Read Event Subscriptions
    • Read Event Subscriptions for Domain
    • Read Event Subscription By Id
    • Create an Event Subscription
    • Update an Event Subscription
    • Update an Event Subscription for Domain
    • Delete a subscription
    • Delete a subscription For Domain
    • Create a Event Subscription for Domain
    • List Domain Event Subscriptions
  • Resellers
    • Get Resellers
    • Count Resellers
    • Create Reseller
    • Update Reseller
    • Delete Reseller
    • Get Specific Reseller
  • Domains
    • Domain Templating
      • Create a Domain Template
      • Create a Domain From Template
    • Create a Domain
    • Get Domains
    • Count Domains
    • Get Specific Domain
    • Update a Domain
    • Delete a Domain
    • Get Specific Domain With Billing Summary
    • Get My Domain Info
    • Check if Domain Exists
  • Users
    • Get Users in Domain
    • Count users in Domain
    • Search for Users in Domain
    • Create User in Domain
    • Delete User in Domain
    • Update a User in Domain
    • Get Specific User in Domain
    • Get My User
    • List Basic Info on Users in Domain
    • Search for Users in Domain
  • Devices
    • Get Devices for User
    • Count Devices for Domain
    • Count Devices for Reseller
    • Count Devices for User
    • Count Devices by Device
    • Create Device for User
    • Update Device for User
    • Delete Device for User
    • Get Specifc Device
    • Get Devices in Domain
    • Get Devices for Reseller or System Wide
    • Get device profile image
    • Read a single device
    • List devices for a reseller
    • Reboot Device for User
    • Reboot Device
    • Reboot Devices in Bulk
    • List Domain Devices
    • List User Devices
  • Sites
    • List Sites in Domain
    • Read Sites in Domain
    • Count Sites in Domain
    • Create Site in Domain
    • Update Site in Domain
    • Read Specific Site in Domain
    • Delete a site
  • Call Center
    • Callqueues
      • Read Call Queues in Domain
      • Create Call Queue in Domain
      • Update Call Queue in Domain
      • Delete Call Queue
      • Read Specific Call Queue
      • List Call Queues in Domain
    • Agents
      • Read Agents in Call Queue
      • Count Agents in Call Queue
      • Read Agents in Domain
      • Read Specific Agent in Call Queue
      • Add Agent to Call Queue
      • Update Agent in Call Queue
      • Remove Agent from Call Queue
      • List Domain Call Queue Agents
      • List Call Queue Agents
    • Agent Actions
      • Agent Login
      • Agent Logout
      • Agent Single Call
      • Agent Set Offline Status
    • QueuedCalls
      • Read Queued Calls
      • Add a Queued Call
    • Statistics
      • Get Callqueue Statistics for a Specific Queue
      • Get Callqueue Statistics for all Queues Aggregated
      • Get Callqueue Statistics for all Queues by Queue
      • Get Agent Statistics for all Queues by Agent
      • Get Agent Statistics for Single Queues by Agent
      • Get Agent Statistics for Single Agent
      • Get DNIS Statistics for all Queues
      • Get DNIS Statistics for Single Queue
      • Get Agent Log
      • Send Call Center Email Report
      • Get Abandoned Calls for all Queues
      • Get Abandoned Calls for a Specific Queue
    • Call Dispositions
      • Read Call Dispostions
      • Create Call Disposition in Domain
      • List Domain Dispositions
  • Answer Rules
    • Read Answerrules for a User
    • Count Answerrules for a User
    • Read Answerrules for my User
    • Read Specifc Timeframe Answerrule for User
    • Add a Answerrule for a User
    • Delete a Answerrule for a User
    • Update a Answerrule for a User
    • Reorder Answerrules for my User
    • List User Answer Rules
  • Call Blocking
    • Read blocked numbers for a Domain
    • Read blocked numbers for a User
    • Add blocked numbers for a Domain
    • Add blocked numbers for a User
    • Delete blocked numbers for a Domain
    • Delete blocked numbers for a User
  • Auto Attendant
    • Create Auto Attendant
    • Read Auto Attendants
    • Read Specific Auto Attendant
    • Update Specific Auto Attendant
    • Delete Specific Auto Attendant
    • List Domain Auto Attendants
  • Media
    • Voicemail
      • Read Voicemail for User by Folder
      • Count Voicemail for User by Folder
      • Read Specific Voicemail for User
      • Move Voicemail to save folder
      • Forward Voicemail to another user
      • Delete Voicemail
    • Greetings
      • Read Greetings for User
      • Count Greetings for User
      • Read Specific Greeting for User
      • Delete Specific Greeting for User
      • Create a new Greeting from TTS
      • Update Greeting with TTS script
      • Create a new Greeting from Upload (JSON + Base64 File)
      • Update Greeting from Upload (JSON + Base64 File)
      • Create a new Greeting from Upload (Multipart/Mixed Post)
      • Update Greeting from Upload (Multipart/Mixed Post)
      • Create a new Greeting from Upload (JSON + Base64 File)
      • Update Greeting from Upload (JSON + Base64 File)
      • Create a new Greeting from Upload (Multipart/Mixed Post)
      • Update Greeting from Upload (Multipart/Mixed Post)
    • Music on Hold
      • Domain
        • Read MOH for Domain
        • Count MOH for Domain
        • Create a new MOH for Domain from TTS
        • Update MOH for Domain from TTS
        • Create a new MOH for Domain from Upload (JSON + Base64 File)
        • Update MOH for Domain from Upload (JSON + Base64 File)
        • Create a new MOH for Domain from Upload (Multipart/Mixed Post)
        • Update MOH for Domain from Upload (Multipart/Mixed Post)
        • Reorder MOH for Domain
        • Delete MOH for Domain
        • Create a new MOH for Domain from Upload (JSON + Base64 File)
        • Update MOH for Domain from Upload (JSON + Base64 File)
        • Create a new MOH for Domain from Upload (Multipart/Mixed Post)
        • Update MOH for Domain from Upload (Multipart/Mixed Post)
      • User
        • Read MOH for User
        • Count MOH for User
        • Create a new MOH for Domain from TTS
        • Create a new MOH for User from Upload (JSON + Base64 File)
        • Update MOH for User from Upload (JSON + Base64 File)
        • Update MOH for Domain from TTS
        • Create a new MOH for User from Upload (Multipart/Mixed Post)
        • Update a MOH for User from Upload (Multipart/Mixed Post)
        • Reorder MOH for User
        • Delete MOH for User
        • Create a new MOH for User from Upload (JSON + Base64 File)
        • Update MOH for User from Upload (JSON + Base64 File)
        • Create a new MOH for User from Upload (Multipart/Mixed Post)
        • Update a MOH for User from Upload (Multipart/Mixed Post)
    • Hold Messages
      • Domain
        • Read Hold Messages for Domain
        • Count Hold Messages for Domain
        • Create a new Hold Messge for Domain from Upload (Multipart/Mixed Post)
        • Update Hold Messge for Domain from Upload (Multipart/Mixed Post)
        • Reorder Hold Messages for Domain
        • Delete Hold Messge for Domain
      • User
        • Read Hold Messages for User
        • Count Hold Messages for User
        • Create a new Hold Messge for User from Upload (Multipart/Mixed Post)
        • Update Hold Messge for User from Upload (Multipart/Mixed Post)
        • Reorder Hold Messages for User
        • Delete Hold Messge for User
    • Text to Speech
      • Get Available Voices
      • Synthesize Voice (Text to Speech)
      • Synthesize Voice (Text to Speech) via GET
  • CDR (Call History)
    • CDR (Call History)
    • Read CDRs
    • Read CDRs for Domain
    • Read CDRs for Specific User
    • Count CDRs and SUM minutes
    • Count CDRs and SUM minutes for Domain
    • Count CDRs and SUM minutes for Specifc User
    • Read a single CDR by call ID
    • Update a CDR record
    • Read a domain-scoped CDR by call ID
    • Update a domain-scoped CDR
    • Read a user-scoped CDR by call ID
    • Search CDRs for Domain
    • Update a user-scoped CDR
    • Read CDRs for Site in Domain
    • CDR call/minute time-series for a domain
    • CDR call/minute time-series (reseller / system-wide)
    • Top domains / resellers by call volume
  • CDR Schedule
    • Count CDR Schedules for Domain
    • List CDR Schedules for Domain
    • Create CDR Schedule
    • Update CDR Schedule
    • Delete CDR Schedule
    • Read CDR Schedule
    • Count CDR Schedules for Reseller
    • Count CDR Schedules by Name
    • List All CDR Schedules (Super User)
    • Create CDR Schedule (System-wide)
    • Read CDR Schedule (System-wide)
    • Update CDR Schedule (System-wide)
    • Delete CDR Schedule (System-wide)
    • Read CDR Schedule by Reseller
    • Update CDR Schedule by Reseller
    • Delete CDR Schedule by Reseller
    • List CDR Schedules for Reseller
    • Create CDR Schedule for Reseller
    • Count CDR schedules across all domains
    • List CDR schedules (list form)
    • List a domain's CDR schedules (list form)
    • List a reseller's CDR schedules (list form)
  • Call Traces & Cradle to Grave
    • Get Call Trace Data (SIPFlow) by Id
    • Get Call Trace Data (Craddle 2 Grave) by ID
    • Get Call Trace (SIPFlow) For Call
    • Get Cradle to Grave Info For Call
    • Get CSV of call trace For Call
    • Get Cradle to Grave Info For Call
    • Get CSV of call trace For Call
  • Transcriptions & Sentiment
    • Read Transcription for Specific Call
  • Calls (live/active calls)
    • Read Active Calls In Domain
    • Read Specific Active Call In Domain
    • Count Active Calls In Domain
    • Read Active Calls for User
    • Read Specific Active Call
    • Make a new Call
    • Make a new Call to Record File
    • Disconnect Call
    • Transfer Peer Call
    • Transfer Call
    • Answer Call
    • Hold Active Call
    • Un-Hold Active Call
    • Reject Call
    • Report Active Calls
    • Active call time-series for a domain
    • Active call time-series (reseller / system-wide)
  • Contacts
    • Shared Contacts
      • Get Domain Contacts
      • Create Shared Contact
      • Get Specific Domain Contact
      • Update Shared Contact
      • Delete Shared Contact
      • List Domain Contacts
    • Get List of Contacts Groups for User
    • Get Contacts for User
    • Create Contact
    • Get Specific Contact for User
    • Update Contact
    • Delete Contact
    • Count Contacts for User
    • Get My Contacts
    • List User Contacts
  • Addresses
    • Get Addresses for Domain
    • Create Address for Domain
    • Validate Address
    • Update Address for Domain
    • Delete Address For Domain
    • Update Address for User
    • Get Address Using Address ID
    • Update Address Endpoint
    • Delete Address Endpoint
    • Create Address for User
    • Get Addresses for User
    • Delete Address For User
    • Create Address Endpoint
    • Get Address Endpoints for a Domain
    • Count Domain Addresses
    • List Domain Addresses
    • List User Addresses
  • Voicemail Reminders
    • Get Voicemail Reminders for Specific User
    • Count Voicemail Reminders for Specific User
    • Delete Voicemail Reminders for Specific User
    • Create Voicemail Reminder
    • Update Voicemail Reminders for Specific User
  • Dialrule
    • Read Dialrules in a Dialplan
    • Count Dialrules in a Dialplan
    • Read Specific Dialrule in a Dialplan
    • Add a new dial rule into a dial plan
    • Update a dial rule by ID in a dial plan
    • Delete a dial rule by ID in a dial plan
    • Read Dialplans
    • Create Dialplan Global
    • Create Dialplan for Domain
    • Update Dialplan for Domain
    • Delete Dialplan for Domain
    • Count Dialplans
    • List Dial Plan Dial Rules
  • Dial Permisions
    • Read Policies
    • Count Policies
    • Read Specific Policy
    • Read Policies in Domain
    • Read Specific Policy in Domain
    • Read Permissions in a DialPolicy
    • Read Permissions in a DialPolicy in Domain
    • Read Specific Permission in a Dialpolicy
    • Read Specific Permission in a Dialpolicy in Domain
    • Create Dialpolicy Table
    • Update Dialpolicy
    • Update Dialpolicy in Domain
    • Add a new permission to a dialpolicy table
    • Add a new permission to a dialpolicy table in Domain
    • Update a permission in a dialpolicy table
    • Update a permission in a dialpolicy table in Domain
    • Delete a permission by ID in a dialpolicy
    • Delete a permission by ID in a dialpolicy in Domain
    • Delete Dialpolicy
    • Delete Dialpolicy in Domain
    • List Domain Dial Policies
    • List Dial Policy Permissions
  • Messages
    • SMS Block
      • Read SMS Blocks for Domain
      • Read SMS Blocks for all Domains
      • Update SMS Block for Domain
      • Delete/Deactivate SMS Block for Domain
      • Add SMS Blocks for Domain
    • Get Messagesessions for Domain
    • Start a new Message Session
    • Get Messagesessions for User
    • Get Messages for Messagesession
    • Send a message (Chat)
    • Send a message (Group Chat)
    • Send a message (Media Chat)
    • Send a message (SMS)
    • Send a message (Group SMS)
    • Send a message (MMS)
    • Update Messagesession (Participants)
    • Update Messagesession (Session Name)
    • Update Messagesession (Leave)
    • Delete Messagesession
    • Add Participant to Messagesession
    • Remove Participant from Messagesession
    • Create a message session
    • Send a message (Group Chat)
    • Send a message (Media Chat)
    • Send a message (SMS)
    • Send a message (Group SMS)
    • Send a message (MMS)
    • Update Messagesession (Session Name)
  • SMS Numbers
    • Get SMS Numbers for Domain
    • Get SMS Numbers for Domain Copy
    • Create SMS Number
    • Get All SMS Numbers for System
    • Update SMS Number
    • Delete an SMS Number
    • Get SMS Numbers for User
    • Count SMS Numbers for User
  • Recordings
    • Get Specific Recording by Callid for User
    • Get Specific Recording by Callid for Domain
  • Email
    • Send Email using Template
    • Validate SMTP creds and Send Test Email
    • Send Call Center Email Report
  • Connections
    • Get a specific Domain Connection
    • Get All Connections for a Domain
    • Delete a Domain Connection
    • Update a Domain Connection
    • Create a Domain Connection
    • Create a Connection (not domain-scoped)
    • Read All Connections (not domain-scoped)
    • Get a Specific Connection (not domain-scoped)
    • Update a Specific Connection (not domain-scoped)
    • Delete a Specific Connection (not domain-scoped)
    • Count All Conections
    • List route connections
    • List Domain Connections
  • Routes
    • Read Routes
    • Count All Routes
    • Read Route Connections for Route
    • Count All Route Connections
    • Create a Route
    • Create a Route Connection
    • Update A Specific Route
    • Update A Specific Route Connection
    • Delete A Specific Route
    • Delete A Specific Route connection
  • Route Profiles
    • List Route Profiles for a Domain
    • Create a Domain Route Profile
    • Get a Specific Domain Route Profile
    • Update a Domain Route Profile
    • Delete a Domain Route Profile
    • List All Route Profiles
    • Get a Specific Route Profile
    • Update a Specific Route Profile
    • Delete a Specific Route Profile
  • Meetings
    • Event Logs
      • Create a Meeting Log Event
      • Read Meeting Events
    • Iotum
      • Read Iotum Video Domain Resellers
      • Read Iotum Video Host
      • Read All Iotum Video Hosts in a Domain
      • Read Iotum Video Host Conferences
      • Read Iotum Video Host Contacts
      • Read Iotum Video Company
      • Read Iotum Video Company Products
      • Read Iotum Video Available Products
      • Create a Host
      • Create Host Contacts
      • Create Iotum Video Subscription
      • Update Domain's Iotum Company
      • Update Domain's Iotum Subscriptions
      • Update User's Iotum Host
      • Delete Iotum Video Subscription
      • Delete a Host
      • Create Iotum Video Company
      • Create a Ad-hoc Conference
      • Delete a Video Company
    • Create a Meeting with Id
    • Read Meeting
    • Create a Meeting
    • Read Meetings for User
    • Count Domains Meetings
    • Count Meeting
    • Register Meeting
    • Update a Meeting
    • Delete a Meeting
    • Request a Meeting ID
    • List User Meetings
  • Backup & Restore
    • Manually Backup a Domain
    • Request a Full System backup
    • Read Available Restore Points
    • Restore a Specifc Domain Backup
  • Configs
    • Configurations
      • NS Configs
      • NMS Configs
        • List NMS configuration entries
        • Create an NMS configuration entry
        • Count NMS configuration entries
        • List NMS configuration key names
        • List cluster servers and their configuration state
        • Read one NMS configuration entry
        • Update an NMS configuration entry
        • Delete an NMS configuration entry
      • Read a Specific Configuration
      • Read all Configurations
      • Count Configurations
      • Create a Configuration
      • Update a Configuration
      • Delete a Configuration
    • Configuration Definitions
      • Read all Configuration Definitions
      • Create a Configuration Definition
      • Read a Specific Configuration Definition
      • Update a Configuration Definition
      • Delete Configuration Definition
  • Images
    • Read Image
    • Create Image from Upload (JSON + Base64 File)
    • Delete an Image
    • Update Image from Upload (Multipart/Mixed Post)
    • Create Image from Upload (Multipart/Mixed Post)
    • Update Image from Upload (JSON + Base64 File)
    • Create Image from Upload (Multipart/Mixed Post)
    • Update Image from Upload (JSON + Base64 File)
  • Templates
    • Read Template
    • Create Template from Upload (JSON + Base64 File)
    • Delete a Template
    • Create Template from Upload (JSON + Base64 File)
    • Update Template from Upload (JSON + Base64 File)
    • Update Template from Upload (JSON + Base64 File)
  • Timeframes
    • Domain (Shared)
      • Always
        • Create Always Timeframe
      • Specific Dates
        • Create Specific Dates Timeframe
        • Create Additional Date Ranges within Specific Dates Timeframe
        • Convert Timeframe to Another Type
        • Update Date Ranges within Specific Dates Timeframe
        • Delete Specific Timeframe for Domain (Shared)
        • Create Specific Dates Timeframe
        • Replace All Date Ranges in Specific Dates Timeframe
        • Delete Date Range within Specific Dates Timeframe
        • Update Date Ranges within Specific Dates Timeframe
      • Days of Week
        • Create Days of Week Timeframe
        • Update Days of Week Timeframe
        • Create Days of Week Timeframe
        • Update Days of Week Timeframe
      • Holiday
        • Create Holidays Timeframe
        • Create Additional Holidays within Holiday Timeframe
        • Replace All Holidays in Holiday Timeframe
        • Update Holidays within Holiday Timeframe
        • Delete Holiday within Holiday Timeframe
        • Create Additional Holidays within Holiday Timeframe
        • Delete Holiday within Holiday Timeframe
        • Create Holidays Timeframe
        • Replace All Holidays in Holiday Timeframe
        • Update Holidays within Holiday Timeframe
      • Custom
        • Create Custom Timeframe
        • Create Additional Entries within Custom Timeframe
        • Replace All Entries in Custom Timeframe
        • Update Entries within Custom Timeframe
        • Delete Entry within Custom Timeframe
        • Create Additional Entries within Custom Timeframe
        • Delete Entry within Custom Timeframe
        • Create Custom Timeframe
        • Replace All Entries in Custom Timeframe
        • Update Entries within Custom Timeframe
      • Count Timeframes for Domain (all users)
      • Read All Timeframes for Domain (Shared)
      • Read Specific Timeframe for Domain (Shared)
      • Delete Specific Timeframe for Domain (Shared)
      • Convert Timeframe to Another Type
      • List Domain Timeframes
    • User
      • Always
        • Create Always Timeframe
      • Specific Dates
        • Create Specific Dates Timeframe
        • Create Additional Date Ranges within Specific Dates Timeframe
        • Convert Timeframe to Another Type
        • Update Date Ranges within Specific Dates Timeframe
        • Delete Specific Timeframe for User
        • Create Specific Dates Timeframe
        • Replace All Date Ranges in Specific Dates Timeframe
        • Delete Date Range within Specific Dates Timeframe
        • Update Date Ranges within Specific Dates Timeframe
      • Days of Week
        • Create Days of Week Timeframe
        • Update Days of Week Timeframe
        • Create Days of Week Timeframe
        • Update Days of Week Timeframe
      • Holiday
        • Create Additional Holidays within Holiday Timeframe
        • Delete Holiday within Holiday Timeframe
        • Create Holidays Timeframe
        • Update Holidays within Holiday Timeframe
        • Replace All Holidays in Holiday Timeframe
        • Create Additional Holidays within Holiday Timeframe
        • Delete Holiday within Holiday Timeframe
        • Create Holidays Timeframe
        • Update Holidays within Holiday Timeframe
        • Replace All Holidays in Holiday Timeframe
      • Custom
        • Create Additional Entries within Custom Timeframe
        • Delete Entry within Custom Timeframe
        • Create Custom Timeframe
        • Update Entries within Custom Timeframe
        • Replace All Entries in Custom Timeframe
        • Create Additional Entries within Custom Timeframe
        • Delete Entry within Custom Timeframe
        • Create Custom Timeframe
        • Update Entries within Custom Timeframe
        • Replace All Entries in Custom Timeframe
      • Read All Timeframes for User
      • Read Specific Timeframe for User
      • Delete Specific Timeframe for User
      • Convert Timeframe to Another Type
      • List User Timeframes
    • Holiday Information
      • Read List of Supported Countries
      • Read List of Supported Regions
      • Read Holiday Information by Country
      • Read Holiday Information by Country and Region
  • Firebase
    • Read firebase service accounts
    • Add firebase service account
  • SSL Certificates
    • Read SSL certificates for CertManager
    • Read SSL certificate by Common Name
    • Create SSL certificate for CertManager
    • Update SSL certificate for CertManager
    • Delete SSL certificate for CertManager
  • Manage Code
    • View Servers Available to manage code on
    • Read all code packages for all servers in cluster
    • Read all package details for a specific server
    • Update/Refresh repository info on Server
    • View current repos info on Server
    • Add repository version to Server
    • Remove repository version from Server
    • Install/Update a netsapiens package or packages on a specific server
    • Prefrom a dist-upgrade on a server updating all existing packages (netsapiens and not) to latest version available
    • Cleanup unused packages on a specific server
  • iNSight
    • Query Healthcheck Data from iNSight
    • Query Data from iNSight for alerts
    • Query Healthcheck Data from iNSight
  • Conference
    • Conferences
      • Get Conferences in Domain
      • Get Conference in Domain
      • Count Conferences in Domain
      • Get Conference CDR from Domain
      • Create Conference for Domain
      • Update Conference in Domain
      • Delete Conference in Domain
      • List Domain Conferences
    • Participants
      • Get Participants from Conference
      • Create Participant for Conference
      • Update Participant for Conference
      • Delete Participant from Conference
      • List Conference Participants
  • Charts
    • Count Charts
    • List Charts
  • Dashboards
    • Count Dashboards for a User
    • List User Dashboards
  • Quotas
    • Get Quota for Domain
    • Get Quota for Domains in Reseller
    • Count Quotas for Domain
    • Count Quotas for Reseller
  • Departments
    • List Departments in a Domain
    • Read a domain's departments
    • Count a domain's departments
    • Read one department
  • Presence
    • List Presence in a Domain
    • List Presence in a Department
  • Audit Log
    • Read Audit Log
  • Access Log
    • Read Accesslog
  • Avatars
    • Generic
      • Read Available Generic Avatars
      • Add Avatar for Shared Generic Use
      • Add Avatar for Shared Generic Use
      • Get Avatar Image (default 48px)
      • Get Avatar Image by Size
    • Add/Update Avatar for User
    • Read Avatar Metadata by Filename
    • Delete Avatar for User by Filename
    • Read Avatar Metadata for User
    • Count Avatars for User
    • Add/Update Avatar for User's Contact
    • Add/Update Avatar for Domains's Shared Contact
    • Add Avatar for User
    • Add Avatar for User's Contact
    • Add Avatar for Domain's Shared Contact
    • Delete Avatar for User
    • Read Avatar Metadata for User's Contact
    • Delete Avatar for User's Contact
    • Read Avatar Metadata for Domain's Shared Contact
    • Delete Avatar for Domain's Shared Contact
  • Translations
    • Get Available Locales
    • Get Available Namespaces
    • Get All Translations for Locale
    • Get Translations for Locale and Namespace
    • Get All Translations (Raw Database Data)
    • Create Translation(s)
    • Update Translation(s)
    • Delete Translation(s)
    • Sync Filesystem
  • License
    • List license entries
    • List license entries for a specific host
  • Reject Log
    • List rejected SIP requests
    • List rejected SIP requests for a specific host
  • Push Notifications
    • List push configurations for system
    • List push configurations for a domain
    • List push configurations for a user
    • Register a push configuration for a user
    • Update a push configuration for a user
    • Unregister a push configuration for a user
    • Register a push configuration (system scope)
    • Update a push configuration (system scope)
    • Unregister a push configuration (system scope)
    • Register a push configuration for a domain
    • Update a push configuration for a domain
    • Unregister a push configuration for a domain
    • List Domain Push Registrations
    • List User Push Registrations
  • App Info
    • List element domain records
  • Brands
    • Global
      • List all brands (Super User)
    • Reseller
      • List brands for a reseller (minimal fields)
      • Get all brands for a reseller (full data)
      • List brands for reseller + hostname (minimal fields)
      • Get all brands for reseller + hostname (full data)
      • Get active brand for hostname (resolved)
      • Get a specific brand (full data)
      • Create a new brand
      • Update a brand
      • Delete a brand
      • Copy a brand
    • Domain
      • List brands for a domain (minimal fields)
      • Get all brands for a domain (full data)
      • Create a new brand (domain-scoped)
      • List brands for domain + hostname (minimal fields)
      • Get all brands for domain + hostname (full data)
      • Get active brand for domain + hostname (resolved)
      • Get a specific brand (domain-scoped)
      • Update a brand (domain-scoped)
      • Delete a brand (domain-scoped)
      • Copy a brand (domain-scoped)
  • Brand Assets
    • Reseller
      • List assets for a brand
      • Upload a new brand asset
      • Get a specific asset (metadata)
      • Replace a brand asset image
      • Delete a brand asset
      • Download brand asset (binary)
    • Domain
      • List assets (domain-scoped)
      • Upload asset (domain-scoped)
      • Get asset metadata (domain-scoped)
      • Replace asset image (domain-scoped)
      • Delete asset (domain-scoped)
      • Download asset binary (domain-scoped)
  • vCon
    • Read the vCon for a parent cdr_id (domain-scoped)
    • Read the vCon for a parent cdr_id, scoped to a specific user
  • Phones
    • Macs
      • Supported Models and Servers
        • Get list of Supported/Provisionable by Vendor
        • Get details of Specific Model
      • List Domain Phones
  • Horizon SDK
    • UIExtensions
      • Runtime projection — what should this browser execute
      • List manageable extensions
      • Register an extension
      • Get one extension
      • Update an extension
      • Delete an extension
      • List access rules
      • Create an access rule
      • Update an access rule
      • Delete an access rule
      • Verification history (read-only)
      • Read platform-global SDK settings
      • Update platform-global SDK settings
      • Re-judge stored versions against the current ruleset
      • Deploy a bundle — fetch, verify, promote
  • Inboxes
    • Get Inboxes in Domain
    • Get Inboxes a User is a Member of
    • Create Inbox
    • Update Inbox
    • Delete Inbox
    • Get Members in an Inbox
    • Add Member to Inbox
    • Remove Member from Inbox
    • Get Single Inbox
  • Defaults
    • List defaults
    • Create a default
    • Update a default
    • Delete a default
    • List defaultable objects
    • List the v2 fields of an object
    • List defaults for a domain
    • Create a default for a domain
    • List defaults for a reseller
    • Create a default for a reseller
    • List Domain Defaults
  • Speech Words
    • List system speech words
    • Read a system speech word
    • Update a system speech word
    • Download a system speech word audio file
    • Re-record a system speech word via TTS
    • Replace a system speech word audio file
    • List a domain's speech words
    • Read a domain's resolved speech word
    • Create or update a domain override
    • Delete a domain override
    • Download a domain's speech word audio file
    • Re-record a domain's speech word via TTS
    • Replace a domain's speech word audio file
    • Stream a system speech word via a timed-auth link
    • Bulk re-record system speech words via TTS
    • Stream a domain's speech word via a timed-auth link
    • Bulk re-record a domain's speech words via TTS
    • List Domain Speech Words
  • User Settings
    • List a user's settings
    • Upsert a setting for a user
    • Read a single setting
    • Upsert a setting (by key in path)
    • Upsert a setting (by key in path)
    • Delete a single setting
    • List User Settings
  • Network Tests
    • List network test reports
    • Create a network test report
    • Get a single network test report
    • Delete a network test report
    • List a user's network test reports
    • Create a network test report for a user
    • Get a single network test report under a user
    • Delete a network test report under a user
    • List network test reports system-wide
    • Get a single network test report (system-wide)
    • Delete a network test report (system-wide)
  • SMS Carriers
    • List SMS carriers
    • Create a custom SMS carrier
    • Read an SMS carrier
    • Update an SMS carrier
    • Delete a custom SMS carrier
  • ipaware
    • allowed-ips
      • List allowed IPs
      • Add or update an allowed IP/CIDR
      • Remove an allowed IP/CIDR
      • Remove an allowed IP/CIDR (POST alias)
    • config
      • Read the full configuration
      • Update configuration keys
      • Read one configuration key
      • Set one configuration key
      • Remove a key override (revert to default)
    • service
      • Restart the service
      • Health check (service → Tomcat AJP chain)
    • diagnostics
      • Full runtime status
      • Prometheus metrics
      • Core fraud-scanner status
    • firewall
      • Firewall status and active blocks
      • Per-IP kernel drop counters
      • Block an IP at the packet level
      • Remove a packet-level block
  • Service Codes
    • Read a Service Code
    • Update a Service Code
    • Delete a Service Code
    • Read a Service Code for a Domain
    • Update a Service Code for a Domain
    • Delete a Service Code for a Domain
    • List Service Codes
    • Create a Service Code
    • Count Service Codes
    • List Service Codes for a Domain
    • Create a Service Code for a Domain
    • Count Service Codes for a Domain
    • List Domain Service Codes
  • Recording Servers
    • List recording servers
    • Create a recording server
    • Get one recording server
    • Update a recording server
    • Delete a recording server
    • List the recording entries on one server
    • Create a recording entry on one server
    • List recording entries
    • Create a recording entry
    • Update a recording entry
    • Delete a recording entry
    • List recording-server enablement per core server
    • Get one core server's recording-server enablement
    • Set which recording servers are enabled on one core server
    • Copy entries from another recording server
    • Poll a sync job
    • Cancel a sync job
  • OAuth Clients
    • List OAuth Clients
    • Create an OAuth Client
    • Count OAuth Clients
    • Read an OAuth Client
    • Update an OAuth Client
    • Delete an OAuth Client
  • OAuth Tokens
    • List Issued Tokens
    • Count Issued Tokens
    • Read an Issued Token
    • Revoke an Issued Token
  • Domain Templates
    • Read domain templates
    • Count domain templates
    • Read a template's variables
    • Count a template's variables
    • Check that a template carries one variable
  • Call Parks
    • Read call parks
    • Create a call park
    • Count call parks
    • Read a domain's call parks
    • Create a call park
    • Count a domain's call parks
    • Read one call park
    • Update a call park
    • Delete a call park
    • List Domain Call Parks
  • Call Queues
    • Count Call Queues
  • NMS Status
    • Read NMS Status Series
    • List NMS Status Metrics
    • List NMS Status Servers
  • Custom Scopes
    • List Custom Scopes
    • Create Custom Scope
    • Count Custom Scopes
    • Read Custom Scope
    • Update Custom Scope
    • Delete Custom Scope
  • Domain Settings
    • System
      • List the system-tier settings
      • Upsert a system setting
      • Read one system setting
      • Upsert one system setting
      • Delete one system setting
    • Reseller
      • List a reseller's settings
      • Upsert a reseller setting
      • Read one reseller setting
      • Upsert one reseller setting
      • Delete one reseller setting
    • Read the generated settings catalog
      GET
    • List a domain's effective settings
      GET
    • Upsert a domain setting
      POST
    • Read one effective setting
      GET
    • Upsert one domain setting
      PUT
    • Delete one domain setting
      DELETE
  • Perform an action on a user's active call
    POST
  • Schemas
    • Schemas
      • Authentication
      • Address
    • Enums
    • securitySchemes
    • Default Folder
      • Inbox
      • InboxMember
      • AuthRequirement
      • AuthenticationRequired
      • BadRequest
      • RecordNotFound
      • RouteProfile
      • Vcon
      • MfaDeleteRequest
      • MfaEnrollWithTokenRequest
      • MfaEnrollRequest
      • MfaVerifyResponse
      • MfaVerifyRequest
      • GenAuthenticatorRequest
      • BrandAsset
      • Brand
      • InsightAlertResponse
      • ApplicationTokenResponse
      • ApplicationTokenRequest
      • AppinfoR
      • PushR
      • RejectlogR
      • LicenseR
      • BulkTranslationResponse
      • Error
      • TranslationRawRecord
      • HealthResponse
      • TranslationCreateResponse
      • TranslationNamespacesResponse
      • TranslationLocalesResponse
      • CdrUpdatable
      • MasqueradePopNoTargetResponse
      • MasqueradeV2EndResponse
      • MasqueradeV2Response
      • RefreshCookieResponse
      • MeResponse
      • NetsapiensJsResponse
      • RepoDetails
      • RepoRequest
      • CodeApplicationServerDetails
      • CodeApplicationServer
      • CodeApplication
      • AuthenticationRequired1
      • BadRequest1
      • RecordNotFound1
      • EmailTestResponse
      • EmailValidate
      • Avatar
      • OIDCProvider
      • SmsBlock
      • SSOEnroll
      • AbandondedCallStat
      • Phoneconfiguration
      • PhoneConfigBtn
      • QueueStat
      • Auditlog
      • InsightValue
      • Holiday
      • DeviceModelButtonType
      • DeviceModel
      • DeviceImage
      • DeviceProfile
      • DeviceProfileButton
      • Dialpolicy
      • Permission
      • DispositionReason
      • PublicUserInfo
      • RouteConnection
      • Route
      • Presence
      • Dashboard
      • Chart
      • AnswerruleFeatureSimRing
      • ConferenceCDR
      • Conference
      • ConferenceParticipant
      • Dialplan
      • NumberEnabledMap
      • Certficate
      • Start
      • Limit
      • Transcription
      • CallBlocking
      • AnswerruleFeatureWithRemove
      • IotumContact
      • IotumHost
      • RecurringTimeframeHolidayObservance
      • RecurringTimeframeType
      • TimeframeDOW
      • TimeframeHoliday
      • TimeframeSpecificDate
      • RecurringTimeframe
      • RecordingOld
      • DatetimeEnd
      • DatetimeStart
      • StringInteger
      • ConfigDefinition
      • AuthRequestMFA
      • StringDefaultStar
      • MimeTypes
      • MessageType
      • RecordingConfiguration
      • MeetingStatus
      • Template
      • Image
      • JwtRequestSuccess
      • OneZeroDefaultZero
      • OneZeroDefaultOne
      • OneZeroBoolean
      • JwtResponse
      • DeletegateRequest
      • Connection
      • ConnectionExtra
      • DeleteType
      • Timestamp
      • Configuration
      • Meeting
      • SmsNumber
      • AddressCreateReturn
      • BackupResponse
      • Restore
      • MessageSend
      • AddressEndpoint
      • AddressValidate
      • AutoAttendantFailOptions
      • AutoAttendantTierOption
      • AutoAttendantTier
      • AutoAttendant
      • Timerange
      • TtsVoice
      • AgentPath
      • CallqueuePath
      • CallActions
      • DialruleApplication
      • UserNamePath
      • DeviceLegacy
      • Agentlog
      • EmailCreate
      • YesNoStringNoDefault
      • YesNoStringYesDefault
      • UserName
      • DomainNamePath
      • Synchronous
      • Recording
      • ApiKeyAuth
      • SubscriptionModel
      • Subscription
      • DomainName
      • Scopes
      • TimeZone
      • YesNoString
      • DomainBilling
      • User
      • Domain
      • Message
      • Vmailnag
      • Messagesession
      • NdpServer
      • NdpModel
      • NdpPhone
      • CdrR
      • CdrU
      • CdrD
      • MediaRequest
      • Audiofile
      • ApiKey
      • Reseller
      • Address
      • AccessToken
      • Timeframe
      • AnswerruleFeature
      • Answerrule
      • Contact
      • Phonenumber
      • DialRule
      • Count
      • CallRequest
      • AuthRequest
      • Site
      • AnswerruleLegacy
      • Agent
      • CallQueue
      • Device
      • UserLegacy
      • DomainLegacy
    • Address
      • UserAddressCreateRequest
      • UserAddressCreateReturn
    • Authentication
      • GenAuthenticatorResponse
    • NMS Status
      • NmsStatusMetric
      • NmsStatusServer
      • NmsStatusMetricSeries
      • NmsStatusSeries
    • Custom Scopes
      • CustomScope
      • CustomScopeModifications
    • ActiveCall
    • ErrorResponse
    • DefaultR
    • SpeechWordR
    • UsersettingValue
    • NetworktestR
    • IpawareError
    • SmscarrierFields
    • ServiceCode
    • Recordingserver
    • OauthClient
    • DomainTemplate
    • Park
    • Department
    • HorizonAccessRule
    • ContactListItem
    • DeviceListItem
    • ConferenceListItem
    • PhonenumberListItem
    • NmsConfig
    • DomainSetting
    • DefaultC
    • SpeechWordU
    • UsersettingR
    • NetworktestReport
    • CdrSchedule
    • IpawareValidationError
    • SmscarrierR
    • ServiceCodeCreate
    • RecordingserverWrite
    • OauthClientCreate
    • TemplateVariable
    • ParkWrite
    • SiteWrite
    • HorizonAnalysisDenylist
    • AddressListItem
    • PhoneListItem
    • AttendantListItem
    • DialruleListItem
    • NmsConfigListItem
    • DomainSettingCatalog
    • HorizonExtension
    • DefaultU
    • SpeechWordRender
    • UsersettingC
    • CdrScheduleInput
    • IpawareAllowedIpAdd
    • SmscarrierC
    • ServiceCodeKeyedUpdate
    • RecordingCoreserver
    • OauthClientUpdate
    • DomainTemplateProvisionRequest
    • HorizonAnalysisSettings
    • CdrScheduleUpdate
    • ServicecodeListItem
    • ParkListItem
    • ConnectionListItem
    • PushListItem
    • NmsConfigServer
    • DomainSettingCatalogEntry
    • SuccessResponse
    • SpeechWordUpload
    • UsersettingU
    • SpeechWordBulkRender
    • IpawareAllowedIpRemove
    • SmscarrierPortalR
    • ServiceCodeKeyedDelete
    • Recordingentry
    • OauthClientWithSecret
    • DomainTemplateProvisionResponse
    • HorizonCspCoverage
    • AgentListItem
    • DefaultListItem
    • TimeframeListItem
    • NmsConfigVerify
    • DomainSettingEffective
    • SpeechWordBulkResult
    • IpawareAllowedIpMutationResult
    • SmscarrierBuiltinU
    • DomainServiceCodeCreate
    • RecordingentryWrite
    • OauthToken
    • DispositionListItem
    • DialpolicyListItem
    • AnswerruleListItem
    • NmsConfigCreate
    • DomainSettingValue
    • IpawareAllowEntry
    • SmscarrierCustomU
    • DomainServiceCodeKeyedUpdate
    • RecordingentrySyncRequest
    • HorizonExtensionRuntime
    • ParticipantListItem
    • PermissionListItem
    • MeetingListItem
    • NmsConfigUpdate
    • DomainSettingWrite
    • IpawareAllowedIpsList
    • RecordingentrySyncResult
    • HorizonExtensionSettings
    • SpeechwordListItem
    • UsersettingListItem
    • NmsConfigCount
    • IpawarePendingChange
    • RecordingentrySyncFailure
    • HorizonExtensionVersion
    • SubscriptionListItem
    • NmsSuccessResponse
    • IpawareConfigState
    • RecordingentrySyncAccepted
    • HorizonReanalyzeEntry
    • NmsErrorResponse
    • IpawareConfigKeyState
    • RecordingentrySyncJob
    • HorizonReanalyzeResult
    • IpawareConfigUpdateResult
    • HorizonRulePolicy
    • IpawareStatusZ
    • HorizonRulePolicyEntry
    • IpawareBlockEntry
    • IpawareFirewallState
    • IpawareFirewallBlockRequest
    • IpawareFirewallUnblockRequest
    • IpawareFirewallOpResult
    • RecordNotFound
    • BadRequest
    • AuthenticationRequired
  1. Domain Settings

Read one effective setting

GET
/domains/{domain}/settings/{setting}
Last modified:2026-09-04 03:33:20
OperationId:ReadDomainSetting
The effective value of one setting for the domain. 404 when no tier defines it.

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Path Params

Responses

🟢200OK
application/json
The effective setting
Bodyapplication/json

🟠400Bad Request
🟠401Authentication Required
🟠403Forbidden
🟠404Not Found
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//settings/messaging.media.keep-days' \
--header 'Authorization: Bearer <token>'
Response Response Example
200 - Example 1
{
    "domain": "example.com",
    "reseller": "resellerA",
    "setting": "voiceservices.transcription.vendor",
    "value": "string",
    "source": "system",
    "domain-editable": "yes",
    "description": "string"
}
Modified at 2026-09-04 03:33:20
Previous
Upsert a domain setting
Next
Upsert one domain setting
Built with