> ## Documentation Index
> Fetch the complete documentation index at: https://docs.suasofia.online/llms.txt
> Use this file to discover all available pages before exploring further.

# Obter tronco SIP

> Obter um único tronco SIP pelo ID

Este endpoint retorna informações detalhadas sobre um tronco SIP específico, incluindo IDs de tronco internos úteis para depuração.

### Parâmetros de Caminho

<ParamField path="id" type="integer" required>
  O identificador único do tronco SIP
</ParamField>

### Resposta

<ResponseField name="data" type="object">
  O objeto do tronco SIP

  <Expandable title="Propriedades do tronco SIP">
    <ResponseField name="id" type="integer">
      O identificador único do tronco SIP
    </ResponseField>

    <ResponseField name="phone_number" type="string">
      A extensão SIP ou número de telefone (DID) no formato E.164
    </ResponseField>

    <ResponseField name="nickname" type="string">
      Um rótulo curto e amigável para o tronco (ou `null` se não estiver definido)
    </ResponseField>

    <ResponseField name="sip_username" type="string">
      O nome de usuário usado para autenticação SIP
    </ResponseField>

    <ResponseField name="sip_address" type="string">
      O endereço do servidor SIP
    </ResponseField>

    <ResponseField name="sip_calling_format" type="string">
      O formato do número de chamada de saída: `+e164`, `e164` ou `national`
    </ResponseField>

    <ResponseField name="inbound_authorization_type" type="string">
      O método de autorização de entrada: `auth` ou `ip`
    </ResponseField>

    <ResponseField name="allowed_inbound_ips" type="array">
      Array de endereços IP autorizados (apenas quando `inbound_authorization_type` é `ip`)
    </ResponseField>

    <ResponseField name="outbound_proxy" type="boolean">
      Se as chamadas de saída usam um endereço IP de proxy fixo
    </ResponseField>

    <ResponseField name="country_code" type="string">
      O código do país ISO 3166-2
    </ResponseField>

    <ResponseField name="inbound_trunk_id" type="string">
      Identificador interno para o tronco de voz de entrada (útil para depuração)
    </ResponseField>

    <ResponseField name="outbound_trunk_id" type="string">
      Identificador interno para o tronco de voz de saída (útil para depuração)
    </ResponseField>

    <ResponseField name="created_at" type="string">
      Timestamp ISO 8601
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      Timestamp ISO 8601
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 Response theme={null}
  {
    "data": {
      "id": 42,
      "phone_number": "1000",
      "nickname": "Provedor X — Principal",
      "sip_username": "myuser",
      "sip_address": "sip.provedor.com",
      "sip_calling_format": "+e164",
      "inbound_authorization_type": "auth",
      "allowed_inbound_ips": null,
      "outbound_proxy": false,
      "country_code": "US",
      "inbound_trunk_id": "ST_xxxxxxxxxxxx",
      "outbound_trunk_id": "ST_yyyyyyyyyyyy",
      "created_at": "2026-03-31T10:00:00.000000Z",
      "updated_at": "2026-03-31T10:00:00.000000Z"
    }
  }
  ```

  ```json 404 Not Found theme={null}
  {
    "error": "Tronco SIP não encontrado."
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.