---
title: "Queues"
slug: "queues-1"
updated: 2024-10-25T15:01:34Z
published: 2024-10-25T15:01:34Z
canonical: "docs.voiso.com/queues-1"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voiso.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Queues

The **Queues** API is part of Voiso's Inbound Routing APIs. Use it to obtain a list of all queues you can access based on your user API key. The API description is [here](/v1-api/apidocs/queues).

## Prerequisites

- The requesting [user](https://docs.voiso.com/docs/users-users#adding-a-user) must be configured in your contact center.
- You must have at least one queue configured for your contact center.

## Making requests

The **queues** API requires the [base URL](/v1-api/apidocs/base-endpoint) (cluster_id) and the [user API key](/v1-api/apidocs/authentication) (user_api_key). This tells Voiso which user is making the request. Voiso responds with the list of users the requesting user can access.

This API is used to request a list of queues. For example:

```
{
  "method": "GET",
  "url": "https://cluster1.voiso.com/api/v2/cdr/queues",
  "params": {
    "key": "cc7c76b8987a27ab57...00ab6c3"
  }
}
```

## Response

The following table describes the elements of the response.

| Element | Description | Type | Notes |
| --- | --- | --- | --- |
| name | The name of the queue. | string |  |
| id | The ID assigned to the queue when it was created. | number |  |

### Response sample

```
[
  {
    "name": "Sales queue",
    "id": 28982
  }
]
```