---
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 status for a Telnyx endpoint: whether it is currently registered, when the current registration expires, and the last response Telnyx received from the registrar.

The endpoint supports three credential types, selected with the `credential_type` query parameter. Each type is keyed by a different identifier:

| `credential_type` | Keyed by | Use case |
| --- | --- | --- |
| `uac_external_credential` | `connection_id` | A UAC (SIP attach) connection that registers to an external PBX. |
| `telephony_credential` | `username` | An ephemeral, one-time-use telephony credential. |
| `sip_credential_connection` | `username` | A traditional SIP credential connection that registers directly to Telnyx. |

The authenticated account is taken from your API key; you can only read the registration status of connections and credentials your account owns.

## Query parameters

- `credential_type` 'uac_external_credential' | 'telephony_credential' | 'sip_credential_connection', 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' | 'sip_credential_connection' — The credential type that was looked up.
  - `credential_username` string — SIP username used for the registration.
  - `last_registration_response` string, nullable — SIP response from the last registration attempt.
  - `registered` boolean — True if the endpoint is currently registered.
  - `sip_registration_details` object — Detailed registration information reported by the registrar. The populated fields depend on `credential_type`: UAC external credentials report `auth_retries`, `uptime`, `next_action_at`, `failures`, and `sip_uri_user_host`; telephony credentials and SIP credential connections report `ua_ip`, `ua_port`, `transport`, and `last_modified`. All types report `expires`.
    - `auth_retries` integer — Number of authentication retries on the last attempt (uac_external_credential).
    - `expires` integer — Unix timestamp when the current registration expires.
    - `failures` integer — Count of consecutive registration failures (uac_external_credential).
    - `last_modified` string — Timestamp when the registration was last modified (telephony_credential and sip_credential_connection).
    - `next_action_at` integer — Unix timestamp of the next scheduled registration action (uac_external_credential).
    - `sip_uri_user_host` string — SIP URI user@host of the registered contact (uac_external_credential).
    - `transport` string — Transport used for the registration, e.g. UDP/TCP/TLS (telephony_credential and sip_credential_connection).
    - `ua_ip` string — IP address of the registered user agent (telephony_credential and sip_credential_connection).
    - `ua_port` integer — Port of the registered user agent (telephony_credential and sip_credential_connection).
    - `uptime` integer — Registration uptime reported by the registrar (uac_external_credential).
  - `sip_registration_status` 'unregistering' | 'connection_disabled' | 'standby' | 'failed' | 'trying' | 'registered' | 'unknown' — Human-readable registration status derived from the registrar state.

## Other responses

- `400` — Missing or invalid query parameters. Returned when `credential_type` is unsupported, or when the identifier required for the chosen `credential_type` (`connection_id` or `username`) is missing.
- `401` — Missing or invalid API key
- `403` — The connection or credential exists but is not owned by the authenticated account
- `404` — No connection or credential matches the supplied identifier, or it has no known registration

---

[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/1571b0380bd7/schema)