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

---

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