---
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', required
- `connection_id` string, required

## Response `200`

Registration status payload

- SipRegistrationStatus
  - `connection_id` string — Identifier of the UAC connection.
  - `connection_name` string — Human-readable connection name.
  - `credential_type` 'uac_external_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.
    - `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.

## 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

## Changes

- **2026-06-04** `3390803c3bb0` — 1 warning, 3 info
  - removed the optional property `sip_registration_details/sipUriUserHost` from the response with the `200` status
  - api tag `UAC Connections` added
  - api tag `SIP Registration Status` removed
  - added the optional property `sip_registration_details/sip_uri_user_host` to the response with the `200` status
- **2026-06-02** `a46ce382e6e2` — 8 warning, 3 info
  - removed the optional property `b2bua_external` from the response with the `200` status
  - removed the optional property `b2bua_internal` from the response with the `200` status
  - removed the optional property `external_state` from the response with the `200` status
  - removed the optional property `external_uac_settings` from the response with the `200` status
  - …7 more
- **2026-06-02** `3477b848e756` — 1 warning
  - deleted the `query` request parameter `user_id`
- **2026-06-01** `2b3a20efe796` — 2 breaking, 4 info
  - removed the enum value `sip_credential_connection` from the `query` request parameter `credential_type`
  - removed the enum value `telephony_credential` from the `query` request parameter `credential_type`
  - added the optional property `b2bua_external` to the response with the `200` status
  - added the optional property `b2bua_internal` to the response with the `200` status
  - …2 more
- **2026-05-29** `9958429375f5` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/team-telnyx/apis/telnyx-api/changes/sip_registration_status/get.md)

---

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