---
title: "Get distribution of the maximum number of concurrent conversations"
method: GET
path: "/v1/{account_id}/{project_id}/conversations/concurrency"
---

# Get distribution of the maximum number of concurrent conversations

`GET /v1/{account_id}/{project_id}/conversations/concurrency`

Returns the maximum number of concurrent conversations in several 5-minute intervals based on the given parameters.

## Path parameters

- `account_id` string, required
- `project_id` string, required

## Query parameters

- `start_time` string, date-time, required
- `end_time` string, date-time, required
- `client_env` 'sandbox' | 'pre-release' | 'live'
- `variant_name` string
- `variant_id` string
- `language` string
- `phone_number` string
- `slice_by` string

## Response `200`

OK.

- object
  - `account_id` string, required — Customer PolyAI Account ID.
  - `project_id` string, required — Customer PolyAI Project ID.
  - `intervals` object[], required — Array of intervals returned in ascending chronological order.
    - `time` string, date-time, required — UTC lower bound time for this interval in ISO8601 format.
    - `max_concurrent_conversations` integer, required — Maximum number of concurrent conversations in the 5-minute interval starting from `time`, after applying all filters.
    - `variant_id` string — Variant ID for this interval if `slice_by=variant`.
    - `variant_name` string — Variant name for this interval if `slice_by=variant`.
    - `language` string — Language for this interval if `slice_by=language` (not currently implemented).
    - `phone_number` string — Phone number for this interval if `slice_by=phone_number` (not currently implemented).

## Other responses

- `400` — Validation error.
- `401` — Missing or invalid API key.
- `403` — Missing or invalid API key.
- `404` — Resource not found.
- `500` — Internal Server Error.

---

[API](https://skmtc.net/poly/apis/polyai-agents-api.md) · [All operations](https://skmtc.net/poly/apis/polyai-agents-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/poly/polyai-agents-api/revisions/76f3c606e395/schema)