1. Version
NetSapiens API v2
  • Version
    • Get API version
      GET
    • Check API health
      GET
  • Authentication
    • Access Token (Oauth - Username/Password)
      • Get access token
      • Get JWT from OAuth grant
      • Link SSO identity to user
    • API Key (Machine 2 Machine)
      • List API keys
      • Get your API key
      • Create API key
      • Update API key
      • Revoke API key
      • Get API key
    • JWT (JSON Web Token)
      • Create JWT
      • Revoke JWTs
      • Revoke current JWT
      • Read current JWT
      • Generate short-lived application JWT
    • NetsapiensJs Auth
      • MFA
        • Generate MFA authenticator secret
        • Verify MFA passcode
        • Enroll in MFA with username and password
        • Enroll in MFA with access token
        • Remove MFA enrollment
      • Refresh session tokens
      • Start OIDC login
    • Masquerade
  • Resellers
    • Get Resellers
      GET
    • Create Reseller
      POST
    • Count Resellers
      GET
    • Update Reseller
      PUT
    • Delete Reseller
      DELETE
    • Get Specific Reseller
      GET
  • Phone Numbers
    • destination-application mappings and parameter parsing
    • Get phone numbers for domain
      GET
    • Create phone number
      POST
    • Count phone numbers for domain
      GET
    • Get phone numbers for all domains
      GET
    • Count phone numbers for all domains
      GET
    • Delete phone number
      DELETE
    • Update phone number
      PUT
    • Get phone number
      GET
    • List phone numbers for domain
      GET
    • Change phone number routing
      PUT
  • Phones/Macs
    • Supported Models and Servers
      • Create core server
      • Read NDP connection config
      • Update core server
      • Delete core server
      • Create device model
      • Read device model
      • Update device model
      • Delete device model
      • List device model overrides
      • Create device model override
      • Read raw device model overrides
      • Replace raw device model overrides
      • Delete raw device model overrides
      • Read device model override
      • Update device model override
      • Delete device model override
      • List device models
      • List core servers
      • Read core server
    • Phone Configurations
    • Provisioning Defaults
      • List domains with provisioning defaults
      • List sites with provisioning defaults
      • List brand defaults
      • Create brand default
      • List brands with defaults
      • List defaults for brand
      • Create default for brand
      • List defaults for brand and server
      • Read brand default
      • Update brand default
      • Delete brand default
      • List domain provisioning defaults
      • Create domain provisioning option
      • List domain provisioning defaults for server
      • Read raw domain provisioning defaults
      • Replace raw domain provisioning defaults
      • Delete raw domain provisioning defaults
      • Read domain provisioning option
      • Update domain provisioning option
      • Delete domain provisioning option
      • List site provisioning defaults
      • Create site provisioning option
      • List site provisioning defaults for server
      • Read raw site provisioning defaults
      • Replace raw site provisioning defaults
      • Delete raw site provisioning defaults
      • Read site provisioning option
      • Update site provisioning option
      • Delete site provisioning option
    • 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
    • List device profiles
    • Count Device Profiles
    • Read a device profile
    • 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
    • Create a device profile
    • Update a device profile
    • Delete a device profile
  • 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
  • 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
      • Read Agent Current Status
      • 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
  • Dialrule
    • List dial rules in dial plan
    • Create dial rule
    • Count dial rules in dial plan
    • Read dial rule
    • Update dial rule
    • Delete dial rule
    • List dial plans
    • Create dial plan with domain in body
    • Create dial plan in domain
    • Update dial plan
    • Delete dial plan
    • Count dial plans
    • List dial rule summaries in dial plan
    • Read admin-only dial plan
    • Create admin-only dial plan
    • Update admin-only dial plan
    • Delete admin-only dial plan
    • List dial rules in admin-only dial plan
    • Create dial rule in admin-only dial plan
    • Count dial rules in admin-only dial plan
    • Read dial rule in admin-only dial plan
    • Update dial rule in admin-only dial plan
    • Delete dial rule in admin-only dial plan
    • List dial plans in domain
    • Count dial plans in domain
    • Read dial plan
    • List dial plan summaries
    • List dial rule summaries in admin-only dial plan
  • Call Blocking
    • Read blocked numbers for a Domain
    • Add blocked numbers for a Domain
    • Delete blocked numbers for a Domain
    • Read blocked numbers for a User
    • Add blocked numbers for a User
    • 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
    • Get Call Quality (per-direction MOS/jitter/loss) by CDR Id
    • Get Call Quality by CDR Id (no domain in path)
  • 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
    • Inject a Leg Into a Call Trace
  • 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
  • Dial Permisions
    • List dial policies
    • Count dial policies
    • Read dial policy
    • List domain dial policies
    • Read domain dial policy
    • List shared dial policy rules
    • List domain dial policy rules
    • Read shared dial policy rule
    • Read domain dial policy rule
    • Create dial policy
    • Update shared dial policy
    • Update domain dial policy
    • Create shared dial policy rule
    • Create domain dial policy rule
    • Update shared dial policy rule
    • Update domain dial policy rule
    • Delete shared dial policy rule
    • Delete domain dial policy rule
    • Delete shared dial policy
    • Delete domain dial policy
    • List domain dial policies, reduced
    • List domain dial policy rules, reduced
    • Create domain dial policy
  • 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
    • Play Recording
  • Email
    • Send Email using Template
    • Validate SMTP creds and Send Test Email
    • Send Call Center Email Report
  • Connections
    • Read domain connection
    • List domain connections
    • Delete domain connection
    • Update domain connection
    • Create domain connection
    • Create connection
    • List connections
    • Read connection
    • Update connection
    • Delete connection
    • Count connections
    • List domain connections, reduced
  • Routes
    • List routes
    • Count routes
    • List route connections
    • Count route connections
    • Create route
    • Create route connection
    • Update route
    • Update route connection
    • Delete route
    • Delete route connection
    • List route connections
  • Route Profiles
    • List domain route profiles
    • Create domain route profile
    • Read domain route profile
    • Update domain route profile
    • Delete domain route profile
    • List route profiles
    • Read route profile
    • Update route profile
    • Delete 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
      • LiCf Configs
        • List LiCf configuration entries
        • Create a LiCf configuration entry
        • List recording servers holding LiCf configuration
        • Read a LiCf configuration entry
        • Update a LiCf configuration entry
        • Delete a LiCf configuration entry
        • List NMC configuration entries
        • Create an NMC configuration entry
        • List recording servers holding NMC configuration
        • Read an NMC configuration entry
        • Update an NMC configuration entry
        • Delete an NMC configuration entry
        • List archive policies
        • Create an archive policy
        • Read an archive policy
        • Update an archive policy
        • Delete an archive policy
      • NDP Configs
        • List NDP configuration entries
        • Create NDP configuration entry
        • List NDP configuration servers
        • Read NDP configuration entry
        • Update NDP configuration entry
        • Delete NDP 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
    • Validate a certificate hostname (DNS + cluster check)
  • 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
    • Create a domain's recording quota
    • Update a domain's recording quota
    • Delete a domain's recording quota
    • List recording quotas across the platform
    • Create a recording quota
    • Read one domain's recording quota (platform path)
    • Update one domain's recording quota (platform path)
    • Delete one domain's recording quota (platform path)
    • Create a recording quota under a reseller
    • Read one of a reseller's recording quotas
    • Update one of a reseller's recording quotas
    • Delete one of a reseller's recording quotas
  • 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
      • 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 Single Inbox
    • Get Inboxes a User is a Member of
    • Create Inbox
    • Update Inbox
    • Delete Inbox
    • Get Members in an Inbox
    • Add Member to Inbox
    • Update Member in Inbox
    • Remove Member from 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
    • List a domain's effective settings
    • Upsert a domain setting
    • Read one effective setting
    • Upsert one domain setting
    • Delete one domain setting
  • Recording Storage
    • List remote storage services (platform)
    • List a domain's remote storage services
    • Create a remote storage service for a domain
    • Read a remote storage service
    • Update a remote storage service
    • Delete a remote storage service
  • Processes
    • List processes across the cluster
    • List processes on one server
    • Count processes across the cluster
    • List processes, projected to selected fields
  • Perform an action on a user's active call
    POST
  • Schemas
    • Schemas
      • Authentication
      • Address
    • Enums
    • securitySchemes
    • Default Folder
      • Inbox
      • InboxMember
      • AuthRequirement
      • Domain Read - Additional Parameters
      • NdpServerListItem
      • User Read Additions
      • MasqueradeStartResponse
      • MasqueradeErrorResponse
      • 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
      • CdrU
      • CdrD
      • MediaRequest
      • Audiofile
      • ApiKey
      • Reseller
      • Address
      • AccessToken
      • Timeframe
      • AnswerruleFeature
      • Answerrule
      • Contact
      • Phonenumber
      • DialRule
      • Count
      • CallRequest
      • AuthRequest
      • Site
      • AnswerruleLegacy
      • Agent
      • CallQueue
      • Device
      • UserLegacy
      • DomainLegacy
      • Accesslog
    • Address
      • UserAddressCreateRequest
      • UserAddressCreateReturn
    • Authentication
      • GenAuthenticatorResponse
    • NMS Status
      • NmsStatusMetric
      • NmsStatusServer
      • NmsStatusMetricSeries
      • NmsStatusSeries
    • Custom Scopes
      • CustomScope
      • CustomScopeModifications
    • CDR (Call History)
      • CdrDBase
      • CdrUBase
      • CdrG
      • CdrGBase
    • NDP Endpoints Server (API-3162)
      • NdpCoreServerUpdate
      • DeviceModelUpdate
      • DeviceModelOverrideUpdate
      • BrandDefaultUpdate
      • ProvisioningOptionUpdate
      • ProvisioningDefaultsRawApplied
      • NdpConfigUpdate
      • DialpolicyUpdate
      • PermissionCreate
      • PermissionUpdate
      • RouteProfileCallRouting
      • RouteProfileCreate
      • RouteProfileUpdate
      • ConnectionCreate
      • DomainConnectionCreate
      • ConnectionUpdate
      • NdpErrorResponse
      • NdpSuccessResponse
      • NdpConfig
      • NdpConfigWrite
      • NdpConfigApplied
      • NdpConfigServer
      • NdpCoreServer
      • NdpCoreServerWrite
      • NdpServerConfig
      • DeviceModelRow
      • DeviceModelWrite
      • DeviceProfileRow
      • DeviceModelOverride
      • DeviceProfileButtonRow
      • DeviceModelOverrideWrite
      • DeviceProfileWrite
      • DeviceModelOverridesRaw
      • BrandDefault
      • DeviceModelOverridesRawWrite
      • BrandDefaultWrite
      • BrandDefaultApplied
      • BrandDefaultBrand
      • ProvisioningOption
      • ProvisioningOptionWrite
      • ProvisioningOptionApplied
      • ProvisioningDefaultsRaw
      • ProvisioningDefaultsRawWrite
      • ProvisioningDefaultsDomain
      • NdpPhoneAdditionalFields
    • LicfConfigApplied
    • ActiveCall
    • DefaultR
    • SpeechWordR
    • UsersettingValue
    • NetworktestR
    • IpawareError
    • SmscarrierFields
    • ServiceCode
    • Recordingserver
    • OauthClient
    • DomainTemplate
    • Park
    • Department
    • HorizonAccessRule
    • ContactListItem
    • ConferenceListItem
    • NmsConfig
    • DomainSetting
    • LicfConfig
    • ProcessR
    • DeviceListItem
    • ErrorResponse
    • PhonenumberListItem
    • DefaultC
    • SpeechWordU
    • UsersettingR
    • NetworktestReport
    • CdrSchedule
    • IpawareValidationError
    • SmscarrierR
    • ServiceCodeCreate
    • RecordingserverWrite
    • OauthClientCreate
    • TemplateVariable
    • ParkWrite
    • SiteWrite
    • HorizonAnalysisDenylist
    • AddressListItem
    • PhoneListItem
    • AttendantListItem
    • NmsConfigListItem
    • DomainSettingCatalog
    • NmcConfig
    • CountResponse
    • DialruleListItem
    • HorizonExtension
    • DefaultU
    • SpeechWordRender
    • UsersettingC
    • CdrScheduleInput
    • IpawareAllowedIpAdd
    • SmscarrierC
    • ServiceCodeKeyedUpdate
    • RecordingCoreserver
    • OauthClientUpdate
    • DomainTemplateProvisionRequest
    • HorizonAnalysisSettings
    • CdrScheduleUpdate
    • ServicecodeListItem
    • ParkListItem
    • PushListItem
    • NmsConfigServer
    • DomainSettingCatalogEntry
    • LicfConfigWrite
    • QuotaCreate
    • ConnectionListItem
    • SpeechWordUpload
    • UsersettingU
    • SpeechWordBulkRender
    • IpawareAllowedIpRemove
    • SmscarrierPortalR
    • ServiceCodeKeyedDelete
    • Recordingentry
    • OauthClientWithSecret
    • DomainTemplateProvisionResponse
    • HorizonCspCoverage
    • AgentListItem
    • DefaultListItem
    • TimeframeListItem
    • NmsConfigVerify
    • DomainSettingEffective
    • LicfConfigUpdate
    • SuccessResponse
    • SpeechWordBulkResult
    • IpawareAllowedIpMutationResult
    • SmscarrierBuiltinU
    • DomainServiceCodeCreate
    • RecordingentryWrite
    • OauthToken
    • DispositionListItem
    • AnswerruleListItem
    • NmsConfigCreate
    • DomainSettingValue
    • LicfConfigServer
    • DialpolicyListItem
    • IpawareAllowEntry
    • SmscarrierCustomU
    • DomainServiceCodeKeyedUpdate
    • RecordingentrySyncRequest
    • HorizonExtensionRuntime
    • ParticipantListItem
    • MeetingListItem
    • NmsConfigUpdate
    • DomainSettingWrite
    • ArchiveConfig
    • PermissionListItem
    • IpawareAllowedIpsList
    • RecordingentrySyncResult
    • HorizonExtensionSettings
    • SpeechwordListItem
    • UsersettingListItem
    • NmsConfigCount
    • ArchiveConfigWrite
    • IpawarePendingChange
    • RecordingentrySyncFailure
    • HorizonExtensionVersion
    • SubscriptionListItem
    • NmsSuccessResponse
    • ArchiveConfigUpdate
    • IpawareConfigState
    • RecordingentrySyncAccepted
    • HorizonReanalyzeEntry
    • NmsErrorResponse
    • RecordingStorage
    • IpawareConfigKeyState
    • RecordingentrySyncJob
    • HorizonReanalyzeResult
    • RecordingStorageWrite
    • IpawareConfigUpdateResult
    • HorizonRulePolicy
    • RecordingStorageUpdate
    • IpawareStatusZ
    • HorizonRulePolicyEntry
    • Quota
    • IpawareBlockEntry
    • QuotaWrite
    • IpawareFirewallState
    • LicfSuccessResponse
    • IpawareFirewallBlockRequest
    • LicfErrorResponse
    • IpawareFirewallUnblockRequest
    • IpawareFirewallOpResult
    • RecordNotFound
    • BadRequest
    • AuthenticationRequired
  1. Version

Get API version

GET
/version
Last modified:2026-09-26 02:31:33
OperationId:Version
Returns the build that the answering server runs: the API version, the Git commit and branch it was built from, its build date, and the PHP and CakePHP versions. No authentication is needed. Each server answers for itself, so behind a load balancer hostname shows which one replied. To check the API's dependencies rather than its build, use GET /health.

Request

None

Responses

🟢200OK
application/json
Build information for the server that answered
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/version' \
--header 'Authorization: Bearer <token>'
Response Response Example
Packaged build
{
    "apiversion": "46.0.0",
    "git-commit": "a1b2c3d",
    "git-commit-full": "a1b2c3d4e5f60718293a4b5c6d7e8f9012345678",
    "git-branch": "master-v46.0",
    "build-date": "2026-09-20T18:04:11Z",
    "hostname": "core1",
    "current-time": "2026-09-25 14:30:00",
    "php-version": "8.5.3",
    "library-version": "5.1.4"
}
Modified at 2026-09-26 02:31:33
Next
Check API health
Built with