Skip to main content

List all SIP Endpoints.

Returns a list of your SIP Endpoints. The endpoints are returned sorted by creation date, with the most recent endpoints appearing first. The list is filterable by sending in any of the following parameters.

Permissions

The API token must include the following scopes: Voice.

Query Parameters
filter_username string

String representing the username portion of the endpoint. Will return all SIP Endpoints containing this value as a substring.

filter_caller_id string

Friendly Caller ID used as the CNAM when dialing a phone number or the From when dialing another SIP Endpoint. Will return all SIP Endpoints containing this value as a substring.

Responses
200

OK

Schema OPTIONAL
links object OPTIONAL
self string OPTIONAL
first string OPTIONAL
next string OPTIONAL
prev string OPTIONAL
data object[] OPTIONAL
id string OPTIONAL

The unique identifier of the SIP Endpoint on SignalWire. This can be used to update or delete the endpoint programmatically.

username string

String representing the username portion of the endpoint. Must be unique across your project and must not container white space characters or @.

caller_id string OPTIONAL

Friendly Caller ID used as the CNAM when dialing a phone number or the From when dialing another SIP Endpoint.

send_as string OPTIONAL

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.

Defaults to the project's SIP Settings default send as number.

ciphers string[] OPTIONAL

A list of encryption ciphers this endpoint will support.

Currently supported values are: AEAD_AES_256_GCM_8, AES_256_CM_HMAC_SHA1_80, AES_CM_128_HMAC_SHA1_80, AES_256_CM_HMAC_SHA1_32, AES_CM_128_HMAC_SHA1_32.

Defaults to the project's SIP Settings default cipher list. You can unset the custom cipher list and use the project's SIP Settings default cipher list by sending an empty array.

codecs string[] OPTIONAL

A list of codecs this endpoint will support.

Currently supported values are: OPUS, G722, PCMU, PCMA, VP8, H264.

Defaults to the project's SIP Settings default codec list. You can unset the custom codec list and use the project's SIP Settings default codec list by sending an empty array.

encryption string OPTIONAL

A string representing whether connections to this endpoint require encryption or if encryption is optional. Encryption will always be used if possible.

Possible values are default, required, optional.

Defaults to the project's SIP Settings default.

type string OPTIONAL

A string representation of the type of object this record is.