---
title: "SIP Registration Status"
method: GET
path: "/sip_registration_status"
tags: ["UAC Connections"]
---

# SIP Registration Status

`GET /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.

## Query parameters

- `credential_type` 'uac_external_credential' | 'telephony_credential', required
- `connection_id` string
- `username` string

## Response `200`

Registration status payload

- SipRegistrationStatus
  - `connection_id` string — Identifier of the connection associated with the credential.
  - `connection_name` string — Human-readable connection name.
  - `credential_type` 'uac_external_credential' | 'telephony_credential' — The credential type that was looked up.
  - `credential_username` string — SIP username used for the registration.
  - `registered` boolean — 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.
  - `last_registration_response` string — SIP response from the last registration attempt.
  - `sip_registration_details` object — Detailed registration information reported by the registrar. The populated fields depend on `credential_type`.
    - `auth_retries` integer — Number of authentication retries on the last attempt.
    - `expires` integer — Unix timestamp when the current registration expires.
    - `uptime` integer — Registration uptime reported by the registrar.
    - `next_action_at` integer — Unix timestamp of the next scheduled registration action.
    - `failures` integer — Count of consecutive registration failures.
    - `sip_uri_user_host` string — SIP URI user@host of the registered contact.
    - `ua_ip` string — IP address of the registered user agent (telephony_credential).
    - `ua_port` integer — Port of the registered user agent (telephony_credential).
    - `transport` string — Transport used for the registration, e.g. UDP/TCP/TLS (telephony_credential).
    - `node` string — Registrar node handling the registration (telephony_credential).
    - `last_modified` string — Timestamp when the registration row was last modified (telephony_credential).

## Other responses

- `400` — Missing or invalid query parameters
- `401` — Missing or invalid API key
- `403` — Connection exists but is not owned by the authenticated account
- `404` — No connection matches connection_id

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/8f5f4e537994/schema)