ONVIF SIP Spec 26.12 ONVIF™ www.onvif.org December, 2026 2008-2026 ONVIF™ All rights reserved. Recipients of this document may copy, distribute, publish, or display this document so long as this copyright notice, license and disclaimer are retained with all copies of the document. No license is granted to modify this document. THIS DOCUMENT IS PROVIDED "AS IS," AND THE CORPORATION AND ITS MEMBERS AND THEIR AFFILIATES, MAKE NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO, WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, OR TITLE; THAT THE CONTENTS OF THIS DOCUMENT ARE SUITABLE FOR ANY PURPOSE; OR THAT THE IMPLEMENTATION OF SUCH CONTENTS WILL NOT INFRINGE ANY PATENTS, COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS. IN NO EVENT WILL THE CORPORATION OR ITS MEMBERS OR THEIR AFFILIATES BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL, PUNITIVE OR CONSEQUENTIAL DAMAGES, ARISING OUT OF OR RELATING TO ANY USE OR DISTRIBUTION OF THIS DOCUMENT, WHETHER OR NOT (1) THE CORPORATION, MEMBERS OR THEIR AFFILIATES HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES, OR (2) SUCH DAMAGES WERE REASONABLY FORESEEABLE, AND ARISING OUT OF OR RELATING TO ANY USE OR DISTRIBUTION OF THIS DOCUMENT. THE FOREGOING DISCLAIMER AND LIMITATION ON LIABILITY DO NOT APPLY TO, INVALIDATE, OR LIMIT REPRESENTATIONS AND WARRANTIES MADE BY THE MEMBERS AND THEIR RESPECTIVE AFFILIATES TO THE CORPORATION AND OTHER MEMBERS IN CERTAIN WRITTEN POLICIES OF THE CORPORATION. 26.12 Dec-2026 Initial version. Introduction of SIP specification. This specification defines the SIP-related operations for ONVIF compliant devices. It covers SIP server configuration, NAT traversal configuration, and call management. The WSDL for this service is defined at: http://www.onvif.org/ver10/sip/wsdl Prefix Namespace URI env http://www.w3.org/2003/05/soap-envelope ter http://www.onvif.org/ver10/error xs http://www.w3.org/2001/XMLSchema tt http://www.onvif.org/ver10/schema tsip http://www.onvif.org/ver10/sip/wsdl

This command returns the capabilities of the SIP service. request This is an empty message. response Capabilities [tsip:Capabilities] The capability response message contains the requested SIP service capabilities. faults No command specific faults defined. access class PRE_AUTH Capability Description MaximumServerConfigurations Indicates the maximum number of server configurations supported. MaximumRegistrars Indicates the maximum number of SIP registrars supported per server configuration. MaximumStunServers Indicates the maximum number of STUN server URIs supported per server configuration. MaximumTurnServers Indicates the maximum number of TURN servers supported per server configuration. CallButtons Indicates if the device supports call buttons.

A device indicating SIP capabilities shall support the CreateServerConfiguration, DeleteServerConfiguration, GetServerConfigurations and SetServerConfiguration commands. The maximum number of server configurations supported is indicated by the MaximumServerConfigurations SIP capability. The maximum number of registrars per server configuration is indicated by the MaximumRegistrars SIP capability. A server configuration consists of the following fields: Registrar One or more SIP registrar entries. Each entry contains a Uri and a Transport field. The Transport field specifies the transport protocol to use for the registrar and shall be one of: UDP, TCP, or TLS. UserId The user info/extension of the Address of Record (AoR) in SIP, identifying the device on the registrar. CertPathValidationPolicyID Optional. The unique identifier of the certification path validation policy to be used for validating the server certificate as declared in the security service. If not configured, server certificate validation behavior is undefined and the device may either apply a vendor specific default validation policy or skip validation at all. Authentication Authentication configuration. Either Credential (UserName and Password) or AuthorizationServer may be provided. Credential contains the username and password used to authenticate with the SIP server. AuthorizationServer is a reference token referring to the server that provides access tokens to authorize with the renewal endpoint as defined in the Security specification. Name Optional name of the server configuration.

This operation creates a new SIP server configuration on the device. request ServerConfiguration [tsip:ServerConfiguration] The new server configuration to be added on the device. response Token [tt:ReferenceToken] Token of the created server configuration. faults env:Receiver - ter:OperationProhibited - ter:MaximumServerConfigurations The device cannot create a new server configuration because it already has the maximum number of server configurations that it supports. env:Receiver - ter:OperationProhibited - ter:MaximumRegistrars The number of registrars exceeds the maximum number supported by the device. env:Sender - ter:InvalidArgVal - ter:InvalidRegistrar The URI set in a registrar is not valid. env:Sender - ter:InvalidArgVal - ter:AuthorizationServer No AuthorizationServer exists for the specified token. env:Sender - ter:OperationProhibited - ter:ConfigurationConflict Cannot have both AuthorizationServer and Credential configured at the same time. Only one may be provided. env:Sender - ter:InvalidArgVal - ter:CertPathValidationPolicyID No certification path validation policy exists under the requested CertPathValidationPolicyID. access class WRITE_SYSTEM

This operation deletes an existing SIP server configuration from the device. Deleting a server configuration removes all other configuration types that reference this configuration. request Token [tt:ReferenceToken] Token of the server configuration to delete. response This is an empty message. faults env:Sender - ter:InvalidArgVal - ter:InvalidServerConfigurationToken The Token does not reference an existing server configuration. access class WRITE_SYSTEM

This operation gets the SIP server configuration(s) of the device. The device shall support this command. The device shall not return the password in the response. request Token - optional [tt:ReferenceToken] Optional token of the requested server configuration. If omitted, all server configurations are returned. response Configuration - unbounded [tsip:ServerConfigurationTokenPair] The SIP server configuration(s) of the device, each paired with its Token. faults env:Sender - ter:InvalidArgVal - ter:InvalidServerConfigurationToken The Token does not reference an existing server configuration. access class READ_SYSTEM

This operation sets the SIP server configuration of the device. The device shall support this command. The number of registrars shall not exceed the value indicated by the MaximumRegistrars SIP capability. request Token [tt:ReferenceToken] Token of the server configuration. ServerConfiguration [tsip:ServerConfiguration] The SIP server configuration to update on the device. response This is an empty message. faults env:Sender - ter:InvalidArgVal - ter:InvalidServerConfigurationToken The Token does not reference an existing server configuration. env:Receiver - ter:OperationProhibited - ter:MaximumRegistrars The number of registrars exceeds the maximum number supported by the device. env:Sender - ter:InvalidArgVal - ter:InvalidRegistrar The URI set in a registrar is not valid. env:Sender - ter:InvalidArgVal - ter:AuthorizationServer No AuthorizationServer exists for the specified token. env:Sender - ter:OperationProhibited - ter:ConfigurationConflict Cannot have both AuthorizationServer and Credential configured at the same time. Only one may be provided. env:Sender - ter:InvalidArgVal - ter:CertPathValidationPolicyID No certification path validation policy exists under the requested CertPathValidationPolicyID. access class WRITE_SYSTEM

A device indicating MaximumStunServers > 0 or MaximumTurnServers > 0 in the SIP capabilities shall support the GetNatConfigurations and SetNatConfiguration commands. Only one NAT configuration is supported per server configuration. The maximum number of STUN server URIs is indicated by the MaximumStunServers SIP capability and the maximum number of TURN servers is indicated by the MaximumTurnServers SIP capability. The NAT configuration consists of the following fields: ServerConfiguration Token of the server configuration that this NAT configuration applies to. Stun Optional. Contains one or more STUN server URIs used for NAT traversal. Turn Optional, unbounded. Each entry contains one or more TURN server URIs and optional credentials (UserName and Password) used to authenticate with the TURN server. The device shall not return the password in the response.

This operation gets the NAT configurations of the device. There shall be 1 configuration per ServerConfiguration token. The device shall not return TURN server passwords in the response. request ServerConfiguration - optional [tt:ReferenceToken] Optional token to filter configurations based on server configuration token. response NatConfiguration - unbounded [tsip:NatConfiguration] The NAT configurations of the device. Maximum 1 per ServerConfiguration token. faults env:Sender - ter:InvalidArgVal - ter:InvalidServerConfigurationToken The ServerConfiguration token does not reference an existing server configuration. access class READ_SYSTEM

This operation updates a NAT configuration of the device based on the ServerConfiguration token. The number of STUN server URIs shall not exceed the value indicated by the MaximumStunServers SIP capability. The number of TURN servers shall not exceed the value indicated by the MaximumTurnServers SIP capability. request NatConfiguration [tsip:NatConfiguration] The NAT configuration to set. response This is an empty message. faults env:Sender - ter:InvalidArgVal - ter:InvalidServerConfigurationToken The ServerConfiguration token does not reference an existing server configuration. env:Receiver - ter:OperationProhibited - ter:MaximumStunServers The number of STUN server URIs exceeds the maximum number supported by the device. env:Receiver - ter:OperationProhibited - ter:MaximumTurnServers The number of TURN servers exceeds the maximum number supported by the device. access class WRITE_SYSTEM

A device indicating SIP capabilities shall support the GetCallConfigurations and SetCallConfiguration commands. Shall contain 1 call configuration per ServerConfiguration. A call configuration consists of the following fields: ServerConfiguration Token of the server configuration that this call configuration applies to. AllowIncomingCalls Indicates whether the device shall allow incoming calls. AutoAnswer Indicates whether the device shall automatically answer incoming calls.

This operation gets the call configurations of the device. request ServerConfiguration - optional [tt:ReferenceToken] The matching ServerConfiguration token for the call configuration. response CallConfiguration - unbounded [tsip:CallConfiguration] One or all call configurations of the device. faults env:Sender - ter:InvalidArgVal - ter:InvalidServerConfigurationToken The ServerConfiguration token does not reference an existing server configuration. access class READ_SYSTEM

This operation sets the call configuration of the device. request CallConfiguration [tsip:CallConfiguration] The call configuration to set on the device. response This is an empty message. faults env:Sender - ter:InvalidArgVal - ter:InvalidServerConfigurationToken The ServerConfiguration token does not reference an existing server configuration. access class WRITE_SYSTEM

A device indicating the CallButtons SIP capability shall support the GetCallButtons, SetCallButtons and GetCallButtonOptions commands. Shall contain 1 button configuration per ServerConfiguration. A call button consists of the following fields: ButtonId The button's reference token. Name Display name of the call recipient. UserId The user info/extension of the Address of Record (AoR) in SIP, identifying the recipient on the registrar. Enabled Optional attribute indicating whether this button is enabled or not. Defaults to true.

This operation gets the call button configurations of the device. This method is optional. It shall be available if the CallButtons capability is TRUE. request ServerConfiguration - optional [tt:ReferenceToken] The matching ServerConfiguration token for the button configuration. response ButtonConfiguration - unbounded [tsip:ButtonConfiguration] A button configuration of the device. faults env:Sender - ter:InvalidArgVal - ter:InvalidServerConfigurationToken The ServerConfiguration token does not reference an existing server configuration. env:Receiver - ter:ActionNotSupported - ter:NotImplemented This optional method is not implemented. access class READ_SYSTEM

This operation sets the call button configuration of the device. This method is optional. It shall be available if the CallButtons capability is TRUE. request ButtonConfiguration [tsip:ButtonConfiguration] The button configuration to set on the device. response This is an empty message. faults env:Sender - ter:InvalidArgVal - ter:InvalidServerConfigurationToken The ServerConfiguration token does not reference an existing server configuration. env:Sender - ter:InvalidArgVal - ter:InvalidButtonId The ButtonId does not reference a supported physical, relay or virtual button. env:Receiver - ter:ActionNotSupported - ter:NotImplemented This optional method is not implemented. access class WRITE_SYSTEM

This operation gets the list of supported physical, relay and virtual call button identifiers of the device. This method is optional. It shall be available if the CallButtons capability is TRUE. request This is an empty message. response Physical - unbounded [tsip:ButtonDescription] List of physical button ids. Relay - unbounded [tsip:ButtonDescription] List of relay button ids. Virtual - unbounded [tsip:ButtonDescription] List of virtual button ids. Example for a touchscreen interface. faults env:Receiver - ter:ActionNotSupported - ter:NotImplemented This optional method is not implemented. access class READ_SYSTEM

The SIP streaming configuration defines the media configurations used during SIP-based streaming sessions. It allows a client to update the provided configurations used when the device participates in a SIP call. Shall support a streaming configuration per ServerConfiguration. The SIP streaming configuration determines the media parameters applied during incoming or outgoing SIP sessions. A configuration shall be provided per configuration type that the device supports for SIP streaming. For example, if the device supports both video and audio streaming over SIP, the SIP streaming configuration shall include a video source configuration, a video encoder configuration, an audio source configuration and an audio encoder configuration. If the device supports only audio output (such as a speaker device), then the configuration shall only include the audio output configuration and audio decoder configuration. Note: The configurations listed as part of the SIP streaming configuration are not expected to be used by the device for non-SIP streaming sessions. This means that the configurations need not be returned in GetXConfigurations, nor to be configured through SetXConfiguration. The SIP streaming configuration consists of the following fields: ServerConfiguration The ServerConfiguration token for the streaming configuration to be modified. VideoSource Optional. Video source configuration used for the SIP session. VideoEncoder Optional. Video encoder configuration used for the SIP session. AudioSource Optional. Audio source configuration used for the SIP session. AudioEncoder Optional. Audio encoder configuration used for the SIP session. AudioOutput Optional. Audio output configuration used for the SIP session. AudioDecoder Optional. Audio decoder configuration used for the SIP session.

This operation gets the SIP streaming configurations of the device. request ServerConfiguration - optional [tt:ReferenceToken] The matching ServerConfiguration token for the streaming configuration. response StreamingConfiguration - unbounded [tsip:StreamingConfiguration] The current SIP streaming configuration(s) of the device. faults env:Sender - ter:InvalidArgVal - ter:InvalidServerConfigurationToken The ServerConfiguration token does not reference an existing server configuration. access class READ_MEDIA

This operation sets the SIP streaming configuration of the device. request StreamingConfiguration [tsip:StreamingConfiguration] The SIP streaming configuration to set on the device. response This is an empty message. faults env:Sender - ter:InvalidArgVal - ter:InvalidServerConfigurationToken The ServerConfiguration token does not reference an existing server configuration. access class ACTUATE

This operation gets the supported options for SIP streaming configuration of the device. request This is an empty message. response StreamingConfigurationOptions [tsip:StreamingConfigurationOptions] The supported options for SIP streaming configuration. faults No command specific faults defined. access class READ_MEDIA