---
title: "List SIP addresses"
method: GET
path: "/api/fabric/sip_addresses"
tags: ["SIP Addresses"]
---

# List SIP addresses

`GET /api/fabric/sip_addresses`

Returns a paginated list of SIP addresses in the authenticated project.

#### Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Calling_, _Fax_, _Messaging_, or _Video_.

[Learn more about API scopes](/docs/platform/your-signalwire-api-space).

## Query parameters

- `page_size` integer
- `page_number` integer
- `page_token` string

## Response `200`

The request has succeeded.

- SipAddressListResponse
  - `links` SipAddressPaginationResponse, required
    - `self` string, uri, required — Link to the current page of results.
    - `first` string, uri, required — Link to the first page of results.
    - `next` string, uri — Link to the next page of results.
    - `prev` string, uri — Link to the previous page of results.
  - `items_count` integer, required — The number of SIP addresses in this page of results.
  - `data` SipAddress[], required — An array of SIP address objects.
    - `id` string, uuid, required — Universal Unique Identifier.
    - `type` 'sip_address', required — The object type. Always `sip_address`.
    - `resource_id` string, uuid, required — Universal Unique Identifier.
    - `name` string, required — URL-safe name for the SIP address. Used to build its SIP URI.
    - `display_name` string, required — Human-friendly label for the SIP address. Defaults to `name`.
    - `context` string, required — The Domain this address is grouped under — for example, `public` for your project's default Domain.
    - `uri` string, required — Full SIP URI for this address.
    - `user` string, required — SIP username used to reach this address. `*` accepts any username.
    - `encryption` 'required' | 'optional' | 'forbidden', required
    - `codecs` SipAddressCodec[], required — Enabled codecs for calls to this address.
    - `ciphers` Ciphers[], required — Enabled SRTP ciphers for calls to this address.
    - `ip_auth_enabled` boolean, required — Whether IP authentication is enforced for this address.
    - `ip_auth` string[], required — Whitelisted IP/CIDR entries used when `ip_auth_enabled` is `true`.
    - `calling_handler_resource_id` string, uuid, required — Universal Unique Identifier.
    - `created_at` string, date-time, required — Date and time when the SIP address was created.
    - `updated_at` string, date-time, required — Date and time when the SIP address was last updated.

## Other responses

- `401` — Access is unauthorized.
- `404` — The server cannot find the requested resource.
- `422` — The request contains invalid parameters. See errors for details.
- `500` — An internal server error occurred.

---

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