---
title: "Return SIP endpoints"
method: GET
path: "/v1/projects/{projectId}/trunks/{sipTrunkId}/endpoints"
tags: ["SIP Endpoints"]
---

# Return SIP endpoints

`GET /v1/projects/{projectId}/trunks/{sipTrunkId}/endpoints`

## Request

- Base URL: `https://elastic-trunking.api.sinch.com`
- URL: `https://elastic-trunking.api.sinch.com/v1/projects/{projectId}/trunks/{sipTrunkId}/endpoints`
- Auth: one of:
  - HTTP basic
  - OAuth 2
    - Client credentials
    - Token URL: `https://auth.sinch.com/oauth2/token`

Returns a list of all SIP endpoints with paging.

## Path parameters

- `projectId` string, required
- `sipTrunkId` string, required

## Query parameters

- `page` integer
- `size` integer

## Response `200`

A successful response.

- object
  - `totalItems` integer: Total size of the result.
  - `pageNumber` string: The token to be used for listing the next page
  - `size` integer: The number of items per page. default is 1000
  - `endpoints` SipEndpoint[]
    - union: A SIP endpoint which is the address of your SIP infrastructure. SIP endpoints can be one of two types: static endpoints or registered endpoints. | Endpoint | Description | | -------- | ----------- | | Static endpoints | Static endpoints are defined by a static value which can either be an IP address or a domain name. | | Registered endpoints | Registered endpoints use a credential list to determine the endpoint. | ---
      - object
        - `address` string, required: The address of the SIP endpoint can be an IP address or a domain name. EST uses IP authentication and will only accept calls from the specified address or domain.
        - `port` integer: The port of the SIP endpoint.
        - `id` string: The ID of the SIP endpoint.
        - `sipTrunkId` string: The ID of the SIP trunk to which the endpoint is assigned.
        - `name` string, required: The friendly name of the SIP endpoint.
        - `transport` 'TCP' | 'UDP' | 'TLS': The transport protocol of the SIP endpoint.
        - `priority` integer, required: Inbound call routing priority. If two or more endpoints have the same priority, calls will be routed to them using a round-robin strategy. Lower priority endpoints will be routed to first. Equal priority endpoints will round-robin calls between them.
        - `enabled` boolean: Sets whether the SIP endpoint is enabled or not.
        - `createTime` string, date-time: The date and time that the SIP endpoint was created.
        - `updateTime` string, date-time: The date and time that the SIP endpoint was last modified.
      - object
        - `isRegistered` boolean, required: This property determines whether the endpoint is static or registered. If registered, this must be set to `true`.
        - `credentialUsername` string, required: The username for the credential list you want to use to register the endpoint.
        - `id` string: The ID of the SIP endpoint.
        - `sipTrunkId` string: The ID of the SIP trunk to which the endpoint is assigned.
        - `name` string, required: The friendly name of the SIP endpoint.
        - `transport` 'TCP' | 'UDP' | 'TLS': The transport protocol of the SIP endpoint.
        - `priority` integer, required: Inbound call routing priority. If two or more endpoints have the same priority, calls will be routed to them using a round-robin strategy. Lower priority endpoints will be routed to first. Equal priority endpoints will round-robin calls between them.
        - `enabled` boolean: Sets whether the SIP endpoint is enabled or not.
        - `createTime` string, date-time: The date and time that the SIP endpoint was created.
        - `updateTime` string, date-time: The date and time that the SIP endpoint was last modified.

## Changes

- **2026-10-01** `108d6bcb3948`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sinch/apis/elastic-sip-trunk-api/changes/v1/projects/:projectId/trunks/:sipTrunkId/endpoints/get.md)

---

[API](https://skmtc.dev/sinch/apis/elastic-sip-trunk-api.md) - [All operations](https://skmtc.dev/sinch/apis/elastic-sip-trunk-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sinch/apis/elastic-sip-trunk-api/revisions/8f15a650c7cd?raw)
