---
title: "Get Speaker Sip Accounts"
method: GET
path: "/speakers/{speaker_id}/sip-accounts"
tags: ["speakers"]
---

# Get Speaker Sip Accounts

`GET /speakers/{speaker_id}/sip-accounts`

## Request

- Base URL: `https://api.verdun.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.verdun.ai/speakers/{speaker_id}/sip-accounts`
- Auth: HTTP bearer

The device's own SIP accounts, read live, so the console offers a
dropdown instead of a text field somebody transcribes into.

502 when the device cannot be reached — the console then degrades to its
free-text field, so a horn behind an unfinished port forward does not block
the rest of the install.

## Path parameters

- `speaker_id` string, required

## Response `200`

Successful Response

- SpeakerSipAccountsResponse: The SIP accounts a speaker's device reports, read live. This is what turns the console's SIP-account field from a string somebody transcribes into a dropdown the device answers for. Blank stays the RECOMMENDED state — a single peer-to-peer account is what the device default means, and the call is placed without an account id at all.
  - `speaker_id` string, uuid, required: The speaker whose device was read.
  - `accounts` SipAccountOption[], required: Every SIP account the device reported.
    - `id` string, required: The account IDENTIFIER — what the device wants when placing a call. Not its display name.
    - `name` string, nullable: The account's descriptive name, as typed into the device's own UI.
    - `is_default` boolean, required: Whether this is the device's default account. Only one can be.
    - `enabled` boolean, required: Whether the account is enabled on the device.
  - `read_at` string, date-time, required: When the device answered.
  - `derived_checklist` object: The checklist items the DEVICE answers, computed from this read and stored nowhere. Today that is one: whether a default account exists. `confirmed` is always present — a device that stopped reporting a default must show the tick gone, and an absent key would read as 'we did not ask'. The owner's own attestations live on the speaker record, under `onboarding_checklist`.

## Other responses

- `422`: Validation Error

---

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