---
title: "List SIP trunks"
method: GET
path: "/v1/trunks"
tags: ["SIP trunks"]
---

# List SIP trunks

`GET /v1/trunks`

Returns a paginated list of SIP trunks for the authenticated account.

## Query parameters

- `page` integer
- `per_page` integer

## Response `200`

Returns a paginated list of SIP trunks.

- SIPTrunkListResponse
  - `sip_trunks` SIPTrunkSummary[], nullable, required — SIP trunks associated with the account.
    - `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 associated with 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
    - `auth_method` string, required — SIP trunk authentication method. Can be either `Digest` or `IP auth`.
    - `host_request` object, nullable, required — For SIP trunks with IP-based authentication, contains the status of the IP authentication request.
      - `host` string — The IP address submitted for authentication
      - `status` string — Status of the IP authentication request
    - `passthrough` boolean — Indicates whether Caller ID passthrough is enabled for the SIP trunk
    - `multiple_numbers` boolean, required — Indicates whether multiple Caller IDs are enabled for the SIP trunk
    - `status` string, required — Status of the SIP trunk. Possible values are: `active` - The SIP trunk is active and can be used to place outbound calls. `pending` - The IP authentication request is under review by the Wavix team. `rejected` - The IP authentication request was rejected by the Wavix team. SIP trunks with a `pending` or `rejected` status can't be used to place calls.
    - `talk_time` integer, required — Total duration of all outbound calls placed through the SIP trunk the current month, in seconds. Automatically resets at the beginning of each month.
    - `charge` string, required — Total cost of all outbound calls placed through the SIP trunk in the current month, in USD. Automatically resets at the beginning of each month.
    - `call_recording_enabled` boolean — Indicates whether outbound call recording is enabled for the SIP trunk
    - `machine_detection_enabled` boolean — Indicates whether automatic voicemail detection is enabled for the SIP trunk. Available for `Flex Pro` customers only.
    - `transcription_enabled` boolean — Indicates whether automatic call transcription is enabled for the SIP trunk. Available for `Flex Pro` customers only.
    - `transcription_threshold` integer — Minimum call duration (in seconds) required to automatically generate a transcription. Transcriptions are created for calls that meet or exceed this value. Available to `Flex Pro` customers only.
    - `encrypted_media` boolean — Indicates whether SRTP media encryption is enabled for the SIP trunk.
    - `access_token` string, nullable, required — Static authentication token for the SIP trunk.
  - `pagination` Pagination, required
    - `current_page` integer, required — Current page number.
    - `per_page` integer, required — Number of records per page.
    - `total` integer, required — Total number of records.
    - `total_pages` integer, required — Total number of pages.

## Other responses

- `401` — Unauthorized
- `403` — Request failed. The feature is disabled for your account.

---

[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)