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

# GET /v1/sipteleport/{id}

`GET /v1/sipteleport/{id}`

## Request

- Base URL: `https://api.subspace.com`
- URL: `https://api.subspace.com/v1/sipteleport/{id}`
- 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/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `id` string, required

## Response `200`

A successful response.

- 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

## 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 `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/:id/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)