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

# Obtener troncal SIP

> Recupera la configuración completa de una troncal SIP de Famulor por ID a través de la API. Consulta las credenciales, el enrutamiento y los números asignados de tu telefonía de voz con IA.

<Warning>
  **API de Famulor 1.0 (legado).** Esta página se aplica únicamente a Famulor 1.0 (`app.famulor.de`) y se conserva por compatibilidad. Para la plataforma actual, usa la [referencia de la API de Famulor 2.0](/es/api-reference/introduction).
</Warning>

Este endpoint devuelve información detallada sobre una troncal SIP específica, incluidos los ID de troncal internos útiles para la depuración.

### Parámetros de ruta

<ParamField path="id" type="integer" required>
  El identificador único de la troncal SIP
</ParamField>

### Respuesta

<ResponseField name="data" type="object">
  El objeto de troncal SIP

  <Expandable title="Propiedades de la troncal SIP">
    <ResponseField name="id" type="integer">
      El identificador único de la troncal SIP
    </ResponseField>

    <ResponseField name="phone_number" type="string">
      La extensión SIP o el número de teléfono (DID) en formato E.164
    </ResponseField>

    <ResponseField name="nickname" type="string">
      Una etiqueta corta y descriptiva para la troncal (o `null` si no está establecida)
    </ResponseField>

    <ResponseField name="sip_username" type="string">
      El nombre de usuario usado para la autenticación SIP
    </ResponseField>

    <ResponseField name="sip_address" type="string">
      La dirección del servidor SIP
    </ResponseField>

    <ResponseField name="sip_calling_format" type="string">
      El formato del número de llamada saliente: `+e164`, `e164` o `national`
    </ResponseField>

    <ResponseField name="inbound_authorization_type" type="string">
      El método de autorización de llamadas entrantes: `auth` o `ip`
    </ResponseField>

    <ResponseField name="allowed_inbound_ips" type="array">
      Array de direcciones IP en la lista blanca (solo cuando `inbound_authorization_type` es `ip`)
    </ResponseField>

    <ResponseField name="outbound_proxy" type="boolean">
      Si las llamadas salientes usan una dirección IP de proxy fija
    </ResponseField>

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

    <ResponseField name="inbound_trunk_id" type="string">
      Identificador interno de la troncal de voz entrante (útil para la depuración)
    </ResponseField>

    <ResponseField name="outbound_trunk_id" type="string">
      Identificador interno de la troncal de voz saliente (útil para la depuración)
    </ResponseField>

    <ResponseField name="created_at" type="string">
      Marca de tiempo ISO 8601
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      Marca de tiempo ISO 8601
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 Response theme={null} theme={null}
  {
    "data": {
      "id": 42,
      "phone_number": "1000",
      "nickname": "Provider X — Main",
      "sip_username": "myuser",
      "sip_address": "sip.provider.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} theme={null}
  {
    "error": "SIP trunk not found."
  }
  ```
</ResponseExample>
