---
title: "GET /v1/sipteleport"
method: GET
path: "/v1/sipteleport"
tags: ["SipTeleportService"]
---

# GET /v1/sipteleport

`GET /v1/sipteleport`

## Request

- Base URL: `https://api.subspace.com`
- URL: `https://api.subspace.com/v1/sipteleport`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://id.subspace.com/oauth/token` scopes: `accelerators:read`, `accelerators:write`, `sipteleport:read`, `sipteleport:write`
- TypeScript: <https://skmtc.dev/subspace/apis/subspace-product-api/docs/v1/sipteleport/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `before` string, uint64
- `limit` integer

## Response `200`

A successful response.

- V1ListSipTeleportResponse
  - `data` V1SipTeleportResponse[]
    - `id` string
    - `name` string
    - `destination` string
    - `teleport_entry_points` V1TeleportAddresses[]
      - `address` string
      - `transport_type` 'UDP_TCP' | 'TLS'
    - `status` 'UNKNOWN' | 'DISABLED' | 'ENABLED'
    - `date_created` string, date-time
    - `date_updated` string, date-time
  - `next_page` V1NextPage
    - `before` string, uint64
    - `limit` integer

## Other responses

- `400`: Bad request
- `401`: Access token is missing or invalid
- `402`: Quota exceeded
- `403`: Not authorized
- `404`: Returned when the resource does not exist.
- `429`: Too many client requests
- `default`: An unexpected error response.

## Changes

- **2021-12-22** `87668cb11b8d`: 1 warning, 1 info
  - added the new `UNKNOWN` enum value to the `data/items/status` response property for the response status `200`
  - the `status` response's property default value changed from `DISABLED` to `UNKNOWN` for the status `200`
- **2021-10-28** `20391f04dc93`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/subspace/apis/subspace-product-api/changes/v1/sipteleport/get.md)

---

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