---
title: "Get desks"
method: GET
path: "/{sub_domain}/api/desks"
tags: ["Desks"]
---

# Get desks

`GET /{sub_domain}/api/desks`

## Request

- Base URL: `https://api.commpeak.com/dialer`
- URL: `https://api.commpeak.com/dialer/{sub_domain}/api/desks`
- Auth: API key in header `Authorization`

Returns the desks in your account, each with the users assigned to it.

**When to use.** List desks before assigning users to them or configuring their breaks.
**Returns.** `{ "userDesks": [ ... ] }`, one entry per desk.
**Example.** `GET /api/desks`

## Path parameters

- `sub_domain` string, required: Dialer Name (subdomain)

## Response `200`

Successful Response

- UserDesksResponse
  - `userDesks` UserDeskItem[], required
    - `id` integer, nullable: Desk ID.
    - `name` string, nullable: Desk name.
    - `userIds` integer[], nullable: IDs of the users assigned to the desk.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/commpeak/apis/commpeak-dialer-api.md) - [All operations](https://skmtc.dev/commpeak/apis/commpeak-dialer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/commpeak/apis/commpeak-dialer-api/revisions/18c5edc07544?raw)