v52

OpenAPI 3.1.0raw.githubusercontent.com2026-07-311,1941,9384.1 MB
UAC Connections

SIP Registration Status

Returns the live SIP registration state of a UAC connection: whether it is currently registered, when it last registered, and the last response Telnyx received from the registrar. Only uac_external_credential is supported today.

get/sip_registration_status

Query parameters

credential_type'uac_external_credential' | 'telephony_credential' required

The kind of credential to look up. uac_external_credential is keyed by connection_id; telephony_credential is keyed by username.

connection_idstring

Identifier of the UAC connection to look up. Required when credential_type is uac_external_credential.

usernamestring

SIP username of the telephony credential to look up. Required when credential_type is telephony_credential.

Response

Registration status payload

connection_idstring

Identifier of the connection associated with the credential.

connection_namestring

Human-readable connection name.

credential_type'uac_external_credential' | 'telephony_credential'

The credential type that was looked up.

credential_usernamestring

SIP username used for the registration.

last_registration_responsestring

SIP response from the last registration attempt.

registeredboolean

True if the endpoint is currently registered.

sip_registration_status'unregistering' | 'connection_disabled' | 'standby' | 'failed' | 'trying' | 'registered' | 'unknown'

Human-readable registration status derived from the registrar state.

Example response

{
  "last_registration_response": "200 OK"
}