---
title: "List SIP accounts"
method: GET
path: "/api/v1/sipaccounts"
tags: ["SIP Accounts"]
---

# List SIP accounts

`GET /api/v1/sipaccounts`

## Request

- Base URL: `https://app.didlogic.com`
- URL: `https://app.didlogic.com/api/v1/sipaccounts`
- Auth: HTTP bearer

Retrieve list of SIP accounts (trunks) configured for the authenticated user.

**SIP Accounts** allow making/receiving calls through the platform using SIP protocol.

**Returned Information:**
- Account credentials and settings
- Call routing configuration
- Usage limits and restrictions
- Allowed IP addresses (if configured)

Technical accounts the platform manages for you — the Webphone account and
each SDK token's account (labelled `SDK Instance: <token label>`) — are
listed too, but cannot be fetched by id, updated or deleted through this API.

`sipaccounts[].id` feeds sipaccounts_show, sipaccounts_update, sipaccounts_destroy,
sipaccounts_allowed_ips_index, sipaccounts_allowed_ips_create and sipaccounts_allowed_ips_destroy;
each also takes `sipaccounts[].name` in its place. `sipaccounts[].name` feeds call_price_show,
calls_show and click2call_create as the SIP account to price, filter by or ring. Full record:
sipaccounts_show.

## Response `200`

Successfully returns list of SIP accounts with configuration details

- object
  - `sipaccounts` object[], required: List of SIP accounts
    - `id` integer, required: Unique SIP account identifier
    - `name` string, required: SIP account username
    - `callerid` string, required: Caller ID
    - `label` string, required: Account label
    - `host` string, required: SIP server host
    - `rewrite_enabled` boolean, required: Whether number rewriting is enabled
    - `rewrite_cond` string, required: Rewrite condition pattern (regular expression)
    - `rewrite_prefix` string, required: Prefix to add when rewriting numbers
    - `didinfo_enabled` boolean, required: Whether DID info is included in SIP headers
    - `ip_restrict` boolean, required: Whether access is restricted by IP address
    - `call_restrict` boolean, required: Whether the per-call duration limit is enabled
    - `call_limit` integer, required: Maximum call duration in seconds
    - `channels_restrict` boolean, required: Whether concurrent channel limits are enabled
    - `max_channels` integer, required: Maximum number of concurrent channels allowed
    - `cost_limit` boolean, required: Whether maximum call cost limit is enabled
    - `max_call_cost` string, required: Maximum allowed cost per call
    - `created_at` string, required: Account creation timestamp
    - `charge` string, required: Total charges accumulated on this account
    - `talk_time` integer, required: Total talk time in seconds
    - `low_balance` boolean, required: Whether account has low balance
    - `spend_limit` string, required: Maximum total spend amount
    - `spend_limit_enabled` boolean, required: Whether spending limit is enabled
    - `available_amount` string, required: Amount available for spending
    - `call_recording_enabled` boolean, required
    - `allowed_ips` unknown[], required: List of IP addresses allowed to authenticate
      - unknown

## Other responses

- `403`: Returns 403 error when SIP accounts are disabled for this user

---

[API](https://skmtc.dev/didlogic/apis/get-started.md) · [All operations](https://skmtc.dev/didlogic/apis/get-started/llms.txt) · [OpenAPI document](https://skmtc.dev/didlogic/apis/get-started/revisions/dc972d592b34?raw)