Resource ManagementSIP Credentials

Get SIP credential

View as MarkdownOpen in Claude
Returns a SIP Credential by ID #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space).

Authentication

AuthorizationBasic
SignalWire Basic Authentication using Project ID and API Token. The client sends HTTP requests with the Authorization header containing the word Basic followed by a space and a base64-encoded string of project_id:token. The project ID will be used as the username and the API token as the password. Example: ``` Authorization: Basic base64(project_id:token) ```

Path parameters

idstringRequiredformat: "uuid"
Unique ID of the SIP endpoint.

Response

The request has succeeded.
typestring
A string representation of the type of object this record is.
idstringformat: "uuid"
The unique identifier of the SIP endpoint.
usernamestring
The username for the SIP endpoint.
caller_idstring or null
Friendly Caller ID used as the CNAM when dialing a phone number or the From when dialing another SIP Endpoint.
send_asstring

When dialing a PSTN phone number, you must send it From a number you have purchased or verified. send_as indicates which number this endpoint has set as its origination. random indicates it will randomly choose a purchased or verified number from within the project.

cipherslist of strings
A list of encryption ciphers this endpoint will support.
codecslist of strings
A list of codecs this endpoint will support.
encryptionenum
Whether connections to this endpoint require encryption or if encryption is optional.
Allowed values:
call_handlerenum or null
What type of handler you want to run on inbound calls.
calling_handler_resource_idstring or nullformat: "uuid"
The unique identifier of the calling handler resource.
call_request_urlstring or null

A string representing the LaML URL to access when a call is received. This is only used (and required) when call_handler is set to laml_webhooks.

call_request_methodenum or null

A string representing the HTTP method to use with call_request_url. Valid values are GET and POST.

Allowed values:
call_fallback_urlstring or null

A string representing the LaML URL to access when the call to call_request_url fails. This is only used (and required) when call_handler is set to laml_webhooks.

call_fallback_methodenum or null

A string representing the HTTP method to use with call_fallback_url. Valid values are GET and POST.

Allowed values:
call_status_callback_urlstring or null

A string representing a URL to send status change messages to. This is only used (and required) when call_handler is set to laml_webhooks.

call_status_callback_methodenum or null

A string representing the HTTP method to use with call_status_callback_url. Valid values are GET and POST.

Allowed values:
call_laml_application_idstring or null

A string representing the ID of the LaML application to forward incoming calls to. This is only used (and required) when call_handler is set to laml_application.

call_dialogflow_agent_idstring or null

A string representing the ID of the Dialogflow agent to forward incoming calls to. This is only used (and required) when call_handler is set to dialogflow.

call_relay_topicstring or null

A string representing the Relay topic to forward incoming calls to. This is only used (and required) when call_handler is set to relay_topic.

call_relay_topic_status_callback_urlstring or null

A string representing a URL to send status change messages to. This is only used (and required) when call_handler is set to relay_topic.

call_relay_contextstring or null

A string representing the Relay context to forward incoming calls to. This is only used (and required) when call_handler is set to relay_context.

call_relay_context_status_callback_urlstring or null

A string representing a URL to send status change messages to. This is only used (and required) when call_handler is set to relay_context.

call_relay_applicationstring or null

A string representing the Relay application to forward incoming calls to. This is only used (and required) when call_handler is set to relay_application.

call_video_room_idstring or nullformat: "uuid"

A string representing the ID of the Video Room to forward incoming calls to. This is only used (and required) when call_handler is set to video_room.

call_relay_script_urlstring or null

A string representing a URL of a SWML script to respond to incoming calls. This is only used (and required) when call_handler is set to relay_script.

Errors

401
Unauthorized Error
404
Not Found Error
500
Internal Server Error