> ## Documentation Index > Fetch the complete documentation index at: https://developers.telnyx.com/llms.txt > Use this file to discover all available pages before exploring further. # SIP Registration Status > Check live registration status using the shared GET /v2/sip_registration_status endpoint. Select sip_credential_connection or telephony_credential and supply its SIP username. For a SIP credential connection, use the connection's user_name. ## OpenAPI ````yaml /openapi/playground/sip-registration-status/credentials.json get /sip_registration_status openapi: 3.0.0 info: version: 1.0.0 x-latency-category: responsive x-endpoint-cost: light title: SIP Registration Status description: >- Check the live SIP registration status of a Telnyx connection or credential. Supports UAC external credentials, ephemeral telephony credentials, and traditional SIP credential connections. contact: email: support@telnyx.com servers: - url: https://api.telnyx.com/v2 description: Telnyx API v2 security: - bearerAuth: [] paths: /sip_registration_status: get: tags: - SIP Registration Status summary: SIP Registration Status description: >- Check live registration status using the shared GET /v2/sip_registration_status endpoint. Select sip_credential_connection or telephony_credential and supply its SIP username. For a SIP credential connection, use the connection's user_name. operationId: GetCredentialRegistrationStatus parameters: - name: credential_type in: query required: true description: Credential type supported by this playground. schema: type: string enum: - sip_credential_connection - telephony_credential default: sip_credential_connection example: sip_credential_connection - name: username in: query required: true description: SIP username of the connection or telephony credential. schema: type: string example: useralice12345 responses: '200': description: Registration status payload content: application/json: schema: $ref: '#/components/schemas/SipRegistrationStatus' examples: telephony_credential: summary: Telephony credential - registered value: connection_id: '2845678901234567890' connection_name: Softphone Credential Connection credential_type: telephony_credential credential_username: gencredq7f3k9x2 registered: true sip_registration_status: registered last_registration_response: 200 OK sip_registration_details: expires: 3600 ua_ip: 192.0.2.55 ua_port: 14934 transport: UDP last_modified: '2026-06-15T11:23:13Z' sip_credential_connection: summary: SIP credential connection - registered value: connection_id: '1701773312243271678' connection_name: Office Softphone credential_type: sip_credential_connection credential_username: office_softphone_01 registered: true sip_registration_status: registered last_registration_response: 200 OK sip_registration_details: expires: 3600 ua_ip: 192.0.2.88 ua_port: 5060 transport: TCP last_modified: '2026-06-05T09:10:00Z' not_registered: summary: Not registered (trying) value: connection_id: '1701773312243271678' connection_name: Office Softphone credential_type: sip_credential_connection credential_username: office_softphone_01 registered: false sip_registration_status: trying last_registration_response: null sip_registration_details: {} connection_disabled: summary: Connection disabled value: connection_id: '1088210431736022026' connection_name: Disabled Connection credential_type: sip_credential_connection credential_username: disabled_user_01 registered: false sip_registration_status: connection_disabled last_registration_response: null sip_registration_details: {} '400': description: >- 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': description: Missing or invalid API key '403': description: >- The connection or credential exists but is not owned by the authenticated account '404': description: >- No connection or credential matches the supplied identifier, or it has no known registration components: schemas: SipRegistrationStatus: type: object properties: connection_id: type: string description: Identifier of the connection associated with the credential. connection_name: type: string description: Human-readable connection name. credential_type: type: string description: The credential type that was looked up. enum: - uac_external_credential - telephony_credential - sip_credential_connection credential_username: type: string description: SIP username used for the registration. registered: type: boolean description: True if the endpoint is currently registered. sip_registration_status: type: string description: Human-readable registration status derived from the registrar state. enum: - unregistering - connection_disabled - standby - failed - trying - registered - unknown last_registration_response: type: string nullable: true description: SIP response from the last registration attempt. example: 200 OK sip_registration_details: type: object description: >- 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`, but its unit differs by `credential_type` — see that field. properties: auth_retries: type: integer description: >- Number of authentication retries on the last attempt (uac_external_credential). expires: type: integer description: >- When the current registration expires. The unit depends on `credential_type`: for `uac_external_credential` this is a Unix timestamp (seconds since epoch) of the next scheduled re-registration; for `telephony_credential` and `sip_credential_connection` this is the registration lifetime in seconds as negotiated with the registrar (the `Expires` value, defaulting to 3600 when the endpoint sends none). uptime: type: integer description: >- Registration uptime reported by the registrar (uac_external_credential). next_action_at: type: integer description: >- Unix timestamp of the next scheduled registration action (uac_external_credential). failures: type: integer description: >- Count of consecutive registration failures (uac_external_credential). sip_uri_user_host: type: string description: >- SIP URI user@host of the registered contact (uac_external_credential). ua_ip: type: string description: >- IP address of the registered user agent (telephony_credential and sip_credential_connection). ua_port: type: integer description: >- Port of the registered user agent (telephony_credential and sip_credential_connection). transport: type: string description: >- Transport used for the registration, e.g. UDP/TCP/TLS (telephony_credential and sip_credential_connection). last_modified: type: string description: >- Timestamp when the registration was last modified (telephony_credential and sip_credential_connection). securitySchemes: bearerAuth: type: http scheme: bearer ````