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

# SIP-Trunk abrufen

> Rufe die komplette Konfiguration eines SIP-Trunks per ID in Famulor ab. Credentials, Routing und zugewiesene Rufnummern für deine KI-Voice-Telefonie.

Dieser Endpunkt liefert detaillierte Informationen zu einem bestimmten SIP-Trunk, inklusive interner Trunk-IDs für Debugging.

### Pfad-Parameter

<ParamField path="id" type="integer" required>
  Die eindeutige Kennung des SIP-Trunks
</ParamField>

### Antwort

<ResponseField name="data" type="object">
  Das SIP-Trunk-Objekt

  <Expandable title="SIP-Trunk-Eigenschaften">
    <ResponseField name="id" type="integer">
      Die eindeutige Kennung des SIP-Trunks
    </ResponseField>

    <ResponseField name="phone_number" type="string">
      Die SIP-Erweiterung oder Telefonnummer (DID) im E.164-Format
    </ResponseField>

    <ResponseField name="nickname" type="string">
      Ein kurzes, menschenlesbares Label für den Trunk (oder `null`, wenn nicht gesetzt)
    </ResponseField>

    <ResponseField name="sip_username" type="string">
      Der Benutzername für die SIP-Authentifizierung
    </ResponseField>

    <ResponseField name="sip_address" type="string">
      Die SIP-Serveradresse
    </ResponseField>

    <ResponseField name="sip_calling_format" type="string">
      Das ausgehende Rufnummernformat: `+e164`, `e164` oder `national`
    </ResponseField>

    <ResponseField name="inbound_authorization_type" type="string">
      Die Methode für eingehende Authentifizierung: `auth` oder `ip`
    </ResponseField>

    <ResponseField name="allowed_inbound_ips" type="array">
      Array mit freigegebenen IP-Adressen (nur wenn `inbound_authorization_type` auf `ip` steht)
    </ResponseField>

    <ResponseField name="outbound_proxy" type="boolean">
      Ob ausgehende Anrufe über eine feste Proxy-IP laufen
    </ResponseField>

    <ResponseField name="country_code" type="string">
      Der ISO-3166-2-Ländercode
    </ResponseField>

    <ResponseField name="inbound_trunk_id" type="string">
      Interne Kennung des Inbound-Voice-Trunks (hilfreich für Debugging)
    </ResponseField>

    <ResponseField name="outbound_trunk_id" type="string">
      Interne Kennung des Outbound-Voice-Trunks (hilfreich für Debugging)
    </ResponseField>

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

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

<ResponseExample>
  ```json 200 Response theme={null} theme={null}
  {
    "data": {
      "id": 42,
      "phone_number": "1000",
      "nickname": "Provider X — Haupt",
      "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>