---
title: "Conversation volume report"
method: GET
path: "/reports/{inbox_id}/conversations"
tags: ["Reports"]
---

# Conversation volume report

`GET /reports/{inbox_id}/conversations`

## Request

- Base URL: `https://api.thrivedesk.com/v1`
- URL: `https://api.thrivedesk.com/v1/reports/{inbox_id}/conversations`
- Auth: HTTP bearer

Conversation volume report.

## Path parameters

- `inbox_id` string, required

## Query parameters

- `start_date` string, date, required
- `end_date` string, date, required

## Response `200`

Success.

- ReportsConversations
  - `total_conversations` integer
  - `new_conversations_count` integer
  - `new_conversations` ReportDayCount[]
    - `count` integer
    - `year` integer
    - `month` integer
    - `day` integer
  - `resolutions_count` integer
  - `resolutions` ReportDayCount[]
    - `count` integer
    - `year` integer
    - `month` integer
    - `day` integer
  - `contacts_helped_count` integer
  - `contacts_helped` ReportDayCount[]
    - `count` integer
    - `year` integer
    - `month` integer
    - `day` integer
  - `inbox` InboxDetail: The full inbox model (with `extra`, `organization_id`, and the soft-delete timestamp), as embedded in a report or a single-message response. Differs from the list shape returned by `GET /v1/inboxes`.
    - `id` string
    - `name` string
    - `inbox_address` string
    - `connected_email_address` string, nullable
    - `email_forwarding_enabled` integer
    - `from_name` string, nullable
    - `default_status` string
    - `default_assignee` string
    - `signature` string, nullable
    - `auto_bcc_enabled` boolean
    - `auto_bcc` string, nullable
    - `auto_reply_enabled` boolean
    - `auto_reply_subject` string, nullable
    - `auto_reply_body` string, nullable
    - `off_hours_auto_reply_subject` string, nullable: Auto-reply used when the inbox is outside its business hours.
    - `off_hours_auto_reply_body` string, nullable
    - `satisfaction_ratings_enabled` boolean
    - `satisfaction_ratings` object: Satisfaction-ratings configuration and copy (free-form).
    - `extra` object: Additional inbox metadata (free-form).
    - `organization_id` string
    - `deleted_at` string, date-time, nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `reply_as_alias` boolean
    - `insert_signature` integer

## Other responses

- `401`: Missing or invalid bearer token.
- `403`: Token is valid but does not include a required scope, or the user does not have access to the resource.
- `404`: Resource not found.
- `422`: Request body failed validation.
- `429`: Rate limit exceeded. The `Retry-After` header indicates how long to wait before retrying. See [Pagination and rate limits](/get-started/pagination) for the full rate-limit policy.
- `500`: Unexpected server error.

---

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