---
title: "List the customer's SIP accounts"
method: GET
path: "/sip_accounts"
tags: ["SIP-Accounts"]
---

# List the customer's SIP accounts

`GET /sip_accounts`

## Request

- Base URL: `https://api.commpeak.com/portal`
- URL: `https://api.commpeak.com/portal/sip_accounts`
- Auth: API key in header `Authorization`

Returns all SIP accounts of the customer that have not been deleted. Each account is identified by its `id` (display token) and shows its name, authentication method — `password` (with `username`) or `ip` (with the list of authorized `auth_ips`) — and the concurrent channel limit. `active` is false while the account has not yet been created in the billing system and cannot place calls. The `id` can be used to filter outbound call records by SIP account.

## Response `200`

Successful Response

- SipAccountsResponse: Envelope returned by `GET /portal/sip_accounts`.
  - `sip_accounts` SipAccountItem[], required
    - `id` string, required: SIP account display token (opaque identifier; not the SIP username).
    - `name` string, required: Human-readable name (empty string when unset).
    - `auth_method` string, required: Authentication method: `password` or `ip`.
    - `username` string, nullable: SIP username (only when `auth_method` is `password`).
    - `ip_acl` string[], nullable: IPs allowed to use the credentials (only when `auth_method` is `password`).
    - `jwt_enabled` boolean, nullable: Whether JWT signature authentication is enabled (only when `auth_method` is `password`).
    - `auth_ips` string[], nullable: Authenticated IPs (only when `auth_method` is `ip`).
    - `channel_limit` integer, required: Maximum concurrent channels (0 = unlimited up to the account limit).
    - `default_tech_prefix` string, nullable: Default tech prefix of the SIP account.
    - `out_of_balance_message` boolean, nullable: Whether a message is played to the callee when the account is out of balance.
    - `caller_id_fixing` boolean, nullable: Whether the Caller ID format is corrected automatically.
    - `auto_nat_fix` boolean, nullable: Whether the automatic NAT traversal fix is enabled.
    - `dynamic_caller_ids` integer[], nullable: Ids of the assigned Dynamic Caller ID rules (see `GET /portal/dynamic_caller_ids`).
    - `editable` boolean, nullable: False for accounts provisioned by CommPeak, whose authentication can't be changed.
    - `active` boolean, required: Whether the SIP account is provisioned and ready for use.

---

[API](https://skmtc.dev/commpeak/apis/commpeak-portal-api.md) - [All operations](https://skmtc.dev/commpeak/apis/commpeak-portal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/commpeak/apis/commpeak-portal-api/revisions/df57b0c16367?raw)