---
title: "Get speaker details"
method: GET
path: "/v1/speakers/{id}"
tags: ["Speaker information & management"]
---

# Get speaker details

`GET /v1/speakers/{id}`

## Request

- Base URL: `https://api.ui.com/v1/connector/consoles/942A6FF664C0000000000964970E0000000009E710560000000068A9873F:9999999999/proxy/protect/integration`
- URL: `https://api.ui.com/v1/connector/consoles/942A6FF664C0000000000964970E0000000009E710560000000068A9873F:9999999999/proxy/protect/integration/v1/speakers/{id}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/ubiquiti/apis/unifi-protect-api/docs/v1/speakers/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

Get detailed information about a specific speaker

## Path parameters

- `id` string, required: The primary key of speaker

## Response `200`

Success response

- Speaker
  - `id` string, required: The primary key of speaker
  - `modelKey` 'speaker', required: The model key of the speaker
  - `state` 'CONNECTED' | 'CONNECTING' | 'DISCONNECTED', required: Connection state of the device.
  - `name` string, required: The name of the device.
  - `mac` string, required: The primary MAC address of the device.
  - `volume` integer, required: Speaker volume: a number from 0-100.
  - `micVolume` integer, required: Mic volume: a number from 0-100.
  - `isMicEnabled` boolean, required: Whether or not the microphone on the speaker is enabled.
  - `speakerState` SpeakerState, required: Real-time state of Speaker
    - `status` 'idle' | 'streaming' | 'playing' | 'tts_playing' | 'uploading', required: Current status of the speaker
    - `mode` 'listen' | 'talk', required: Current mode of the speaker
  - `featureFlags` SpeakerFeatureFlags, required: Feature flags of the speaker
    - `hasMic` boolean, required: Whether the device has a microphone.

## Other responses

- `default`: Error response

---

[API](https://skmtc.dev/ubiquiti/apis/unifi-protect-api.md) - [All operations](https://skmtc.dev/ubiquiti/apis/unifi-protect-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ubiquiti/apis/unifi-protect-api/revisions/e341e1381db1?raw)