---
title: "Retrieve a SIP trunk"
method: GET
path: "/v1/trunks/{id}"
tags: ["SIP trunks"]
---

# Retrieve a SIP trunk

`GET /v1/trunks/{id}`

Returns the SIP trunk identified by `id`.

## Path parameters

- `id` integer, required

## Response `200`

Returns the SIP trunk.

- SIPTrunkResponse
  - `id` integer, required — Unique identifier of the SIP trunk on the platform
  - `name` string, required — System-generated login name of the SIP trunk
  - `callerid` string, nullable, required — Caller ID configured on the SIP trunk. Contains `null` if no Caller ID is set, or an empty string if multiple Caller IDs are allowed.
  - `label` string, required — User-defined name of the SIP trunk
  - `ip_restrict` boolean — Indicates whether IP restriction must be enabled on the SIP trunk
  - `allowed_ips` object[], required
    - `id` integer, required — IP address ID.
    - `ip` string, required — Public static IP address.
  - `channels_restrict` boolean — Indicates if the max number of concurrent outbound calls limit is activated for the SIP trunk.
  - `max_channels` integer, nullable — A maximum number of concurrent outbound calls placed via the SIP trunk. Cannot be higher than the outbound channel capacity configured on the account.
  - `cost_limit` boolean — Indicates if the max cost limit for an outbound call limit is activated for the SIP trunk.
  - `max_call_cost` string, nullable — A maximum cost of an outbound call, in USD.
  - `call_restrict` boolean, nullable — Indicates if maximum call duration limit is activated for the SIP trunk.
  - `call_limit` integer, nullable — A maximum call duration for the SIP trunk, in seconds. Cannot be higher than the max call duration set for the account.
  - `didinfo_enabled` boolean — Indicates if inbound calls carry dialed number information in the 'To' header of SIP Invites
  - `rewrite_enabled` boolean — Indicates if a custom dial plan is activated for the SIP trunk.
  - `rewrite_prefix` string — Leading digits to be added before the dialed phone numbers.
  - `rewrite_cond` string — Leading digits to be deleted from the dialed phone numbers.
  - `call_recording_enabled` boolean — Indicates if outbound call recording is enabled on the SIP trunk. Available for `Flex Pro` customers only.
  - `machine_detection_enabled` boolean — Indicates if automatic voicemail detection is enabled on the SIP trunk. Available for `Flex Pro` customers only.
  - `transcription_enabled` boolean — Indicates if automatic call transcription is enabled on the SIP trunk. Available for `Flex Pro` customers only.
  - `transcription_threshold` integer — Transcriptions will be generated for calls that meet or exceed the specified minimal call duration threshold, in seconds
  - `created_at` string, date-time, required — Date and time the SIP trunk was created
  - `host` string — Registration host for the SIP trunk. `dynamic` for credential-based registration, or a public static IP address for IP authentication.
  - `multiple_numbers` boolean — Indicates whether any active or verified phone number on the account can be used as the Caller ID for the SIP trunk.
  - `encrypted_media` boolean — Indicates whether SRTP media encryption is enabled for the SIP trunk.
  - `passthrough` boolean — Indicates whether Caller ID passthrough is enabled.
  - `access_token` string, nullable — Static authentication token for the SIP trunk.

## Other responses

- `403` — Request failed. The feature is disabled for your account.
- `404` — Returns when no SIP trunk matches `id`, or the account is not provisioned for SIP trunks.

---

[API](https://skmtc.net/wavix/apis/wavix-apis.md) · [All operations](https://skmtc.net/wavix/apis/wavix-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wavix/wavix-apis/versions/b22f170488b6/schema)