---
title: "List inbox conversations"
method: GET
path: "/inboxes/{inbox_id}/conversations"
tags: ["Inboxes"]
---

# List inbox conversations

`GET /inboxes/{inbox_id}/conversations`

List the conversations in an inbox. For more advanced filtering, see the [search endpoint](https://dev.frontapp.com/reference/conversations#search-conversations).


Required scope: `conversations:read`

## Path parameters

- `inbox_id` string, required

## Query parameters

- `q` string
- `limit` integer
- `page_token` string

## Response `200`

Array of conversations

- object
  - `_pagination` object
    - `next` string, nullable — Link to next [page of results](https://dev.frontapp.com/docs/pagination)
  - `_links` object
    - `self` string — Link to resource
  - `_results` ConversationResponse[]
    - `_links` object, required
      - `self` string — Link to resource
      - `related` object
        - `events` string — Link to conversation events
        - `followers` string — Link to conversation followers
        - `messages` string — Link to conversation messages
        - `comments` string — Link to conversation comments
        - `inboxes` string — Link to conversation inboxes
        - `last_message` string — Link to last message of the conversation
    - `id` string, required — Unique identifier of the conversation
    - `type` 'conversation' | 'discussion' | 'task', required — Type of the conversation
    - `subject` string, required — Subject of the message for email message
    - `status` 'archived' | 'unassigned' | 'deleted' | 'assigned', required — Status of the conversation
    - `status_id` string — Unique identifier of the conversation status category, only present if ticketing is enabled
    - `status_category` 'open' | 'waiting' | 'resolved' — Status category of the conversation
    - `ticket_ids` string[], required — List of ticket ids associated with the conversation
    - `assignee` TeammateResponse, required — A teammate is a user in Front.
      - `_links` object, required
        - `self` string — Link to resource
        - `related` object
          - `inboxes` string — Link to teammate's inboxes
          - `conversations` string — Link to teammate's conversations
          - `botSource` string — Link to the source resource of the bot (e.g. rule)
      - `id` string, required — Unique identifier of the teammate
      - `email` string, required — Email address of the teammate
      - `username` string, required — Username of the teammate (used for "@" mentions)
      - `first_name` string, required — First name of the teammate
      - `last_name` string, required — Last name of the teammate
      - `is_admin` boolean, required — Whether or not the teammate is an admin in your company
      - `is_available` boolean, required — Whether or not the teammate is available
      - `is_blocked` boolean, required — Whether or not the teammate account has been blocked
      - `type` 'user' | 'visitor' | 'ai' | 'api' | 'application' | 'bulk_reply' | 'csat' | 'integration' | 'macro' | 'rule' | 'smart_csat', required — Type of the teammate, normal teammates are denoted as "user", while visitors are denoted as "visitor". Bot users are denoted by their parent resource type. The following bot types are available: * ai: acting on behalf of an AI * api: acting on behalf of OAuth clients * application: acting on behalf of an Application * bulk_reply: acting on behalf of a Bulk Reply * csat: used for authoring CSAT response comments * integration: acting on behalf of an Integration * macro: acting on behalf of a Macro, author of comments and drafts * rule: acting on behalf of a Rule, author of comments and drafts * smart_csat: acting on behalf of a Smart CSAT
      - `custom_fields` CustomFieldParameter, required — An object whose key is the `name` property defined for the custom field in the Front UI. The value of the key must use the same `type` specified for the custom field, as described in https://dev.frontapp.com/reference/custom-fields
    - `recipient` RecipientResponse, required
      - `_links` object, required
        - `related` object
          - `contact` string, nullable — Link to recipient contact
      - `name` string, nullable, required — Name of the recipient.
      - `handle` string, required — Handle of the contact. Can be any string used to uniquely identify the contact
      - `role` 'from' | 'to' | 'cc' | 'bcc' | 'reply-to', required — Role of the recipient
    - `tags` TagResponse[], required — List of the tags for this conversation
      - `_links` object, required
        - `self` string — Link to resource
        - `related` object
          - `conversations` string — Link to tag conversations
          - `owner` string, nullable — Link to tag owner
          - `parent_tag` string, nullable — Link to parent tag
          - `children` string, nullable — Link to tag children
      - `id` string, required — Unique identifier of the tag
      - `name` string, required — Name of the tag
      - `description` string, nullable, required — Description of the tag
      - `highlight` string, nullable, required — Highlight color or emoji of the tag. Null if the tag does not have a highlight.
      - `is_private` boolean, required — Whether or not the tag is individual
      - `is_visible_in_conversation_lists` boolean, required — Whether the tag is visible in conversation lists.
      - `created_at` number — Timestamp of tag create creation
      - `updated_at` number — Timestamp of the last tag update
    - `links` LinkResponse[], required — List of the links for this conversation
      - `_links` object, required
        - `self` string — Link to resource
      - `id` string, required — Unique identifier of the link
      - `name` string, required — Display name of the link
      - `type` string, required — Type of the link. Typically associated with the underlying link provider (if known)
      - `external_url` string, required — Underlying identifying external URL of the link
      - `custom_fields` CustomFieldParameter, required — An object whose key is the `name` property defined for the custom field in the Front UI. The value of the key must use the same `type` specified for the custom field, as described in https://dev.frontapp.com/reference/custom-fields
    - `custom_fields` CustomFieldParameter, required — An object whose key is the `name` property defined for the custom field in the Front UI. The value of the key must use the same `type` specified for the custom field, as described in https://dev.frontapp.com/reference/custom-fields
    - `created_at` number — Timestamp at which the conversation was created.
    - `updated_at` number — Timestamp at which the conversation was last updated.
    - `waiting_since` number — Timestamp of the oldest unreplied message.
    - `is_private` boolean, required — Whether or not the conversation is private
    - `scheduled_reminders` Reminder[], required — List of scheduled (non-expired and non-canceled) reminders for this conversation
      - `_links` object, required
        - `related` object
          - `owner` string — Link to conversation owner
      - `created_at` number — Timestamp at which the conversation reminder has been created
      - `scheduled_at` number — Timestamp that the conversation reminder has been scheduled for
      - `updated_at` number — Timestamp at which the conversation reminder has been updated
    - `description` string, nullable — Description of the task. Only present on task conversations.
    - `due_at` number, nullable — Unix timestamp in seconds when the task is due. Only present on task conversations.
    - `metadata` object, required — Optional metadata about the conversation
      - `external_conversation_ids` string[] — List of external_ids for partner channel associated with the conversation. Only present for partner channel token authenticated requests.

---

[API](https://skmtc.net/frontapp/apis/core-api.md) · [All operations](https://skmtc.net/frontapp/apis/core-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/frontapp/core-api/versions/76d1eaa2d0eb/schema)