---
title: "Gets the endpoint identified by the given ID."
method: GET
path: "/endpoints/{id}"
tags: ["Custom Speech endpoints:"]
---

# Gets the endpoint identified by the given ID.

`GET /endpoints/{id}`

## Path parameters

- `id` string, uuid, required

## Response `200`

OK

- Endpoint
  - `links` EndpointLinks
    - `restInteractive` string, uri — The REST endpoint for short requests up to 15 seconds.
    - `restConversation` string, uri — The REST endpoint for requests up to 60 seconds.
    - `restDictation` string, uri — The REST endpoint for requests up to 60 seconds, supporting dictation of punctuation marks.
    - `webSocketInteractive` string, uri — The Speech SDK endpoint for short requests up to 15 seconds with a single final result.
    - `webSocketConversation` string, uri — The Speech SDK endpoint for long requests with multiple final results.
    - `webSocketDictation` string, uri — The Speech SDK endpoint for long requests with multiple final results, supporting dictation of punctuation marks.
    - `logs` string, uri — The audio and transcription logs for this endpoint. See operation "Endpoints_ListLogs" for more details.
  - `properties` EndpointProperties
    - `loggingEnabled` boolean — A value indicating whether content logging (audio & transcriptions) is being used for a deployment.
    - `timeToLive` string — How long the endpoint will be kept in the system. Once the endpoint reaches the time to live after completion (successful or failed) it will be automatically deleted. Not setting this value or setting to 0 will disable automatic deletion. The longest supported duration is 31 days. The duration is encoded as ISO 8601 duration ("PnYnMnDTnHnMnS", see https://en.wikipedia.org/wiki/ISO_8601#Durations).
    - `email` string — The email address to send email notifications to in case the operation completes. The value will be removed after successfully sending the email.
    - `error` EntityError
      - `code` string — The code of this error.
      - `message` string — The message for this error.
  - `self` string, uri — The location of this entity.
  - `displayName` string, required — The display name of the object.
  - `description` string — The description of the object.
  - `text` string — The text used to adapt a language model for this endpoint.
  - `model` EntityReference
    - `self` string, uri, required — The location of the referenced entity.
  - `locale` string, required — The locale of the contained data.
  - `customProperties` object — The custom properties of this entity. The maximum allowed key length is 64 characters, the maximum allowed value length is 256 characters and the count of allowed entries is 10.
  - `lastActionDateTime` string, date-time — The time-stamp when the current status was entered. The time stamp is encoded as ISO 8601 date and time format ("YYYY-MM-DDThh:mm:ssZ", see https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
  - `status` 'NotStarted' | 'Running' | 'Succeeded' | 'Failed' — Describe the current state of the API
  - `createdDateTime` string, date-time — The time-stamp when the object was created. The time stamp is encoded as ISO 8601 date and time format ("YYYY-MM-DDThh:mm:ssZ", see https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
  - `project` EntityReference
    - `self` string, uri, required — The location of the referenced entity.

## Other responses

- `default` — An error occurred.

---

[API](https://skmtc.net/azure/apis/cognitiveservices-speech-speechtotext.md) · [All operations](https://skmtc.net/azure/apis/cognitiveservices-speech-speechtotext/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/cognitiveservices-speech-speechtotext/versions/931821089e0d/schema)