---
title: "List inboxes"
method: GET
path: "/inboxes"
tags: ["Inboxes"]
---

# List inboxes

`GET /inboxes`

## Request

- Base URL: `https://api.thrivedesk.com/v1`
- URL: `https://api.thrivedesk.com/v1/inboxes`
- Auth: HTTP bearer

List inboxes.

## Response `200`

Success.

- InboxList
  - `data` Inbox[], required
    - `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).
    - `all_count` integer
    - `mine_count` integer
    - `assigned_count` integer
    - `unassigned_count` integer
    - `draft_count` integer
    - `scheduled_count` integer
    - `snoozed_count` integer
    - `later_count` integer
    - `spam_count` integer
    - `teams` string[]: IDs of teams with access to the inbox.
    - `agents` string[]: IDs of agents assigned to the inbox.
    - `agents_conversations_count` object: Open conversation counts keyed by agent ID (free-form).
    - `aliases` object[]: Email aliases configured on the inbox.
    - `custom_fields` object[]: Custom fields defined on the inbox.
    - `reply_as_alias` boolean
    - `insert_signature` integer
    - `business_hour_enabled` boolean: Whether the inbox observes the business-hours profile covering its channel. See `GET /v1/business-hours`.

## 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)