---
title: "Retrieves all conversations for this dashboard."
method: GET
path: "/dashboards/{dashboard_id}/conversations"
tags: ["Conversations"]
---

# Retrieves all conversations for this dashboard.

`GET /dashboards/{dashboard_id}/conversations`

Retrieves the last message across all conversations in this dashboard.

## Path parameters

- `dashboard_id` integer, required

## Query parameters

- `tags` string
- `show_unresolved_only` boolean
- `include_archived` boolean
- `search` string
- `page` integer
- `page_size` integer

## Response `200`

Conversations.

- ConversationResponseContainer
  - `meta` PaginationInfo
    - `page` integer — The current page of this get request
    - `page_size` integer — The current page-size of this get request
    - `total_items` integer — The total number of queryable items
  - `items` Conversation[]
    - `phone_number` string — The contact's phone number.
    - `last_message` Message
      - `message_id` string — The message's unique identifier.
      - `body` string — The message's text.
      - `message_direction` string — The message direction. R if the message was sent from the contact's phone, S if the message was sent from the dashboard.
      - `response_by_username` string — Name of Text Request user that sent the most recent message response
      - `message_timestamp_utc` string, date-time — Timestamp of when the message was queued to be sent.
      - `delivery_status` 'accepted' | 'queued' | 'sending' | 'scheduled' | 'error' | 'sent' | 'failed' | 'undelivered' | 'delivered' — Message's current delivery state. Will be "scheduled" when the message was created with schedule_date_utc.
      - `schedule_date_utc` string, date-time — When the message is scheduled to send. Present when delivery_status is "scheduled".
      - `delivery_error` string — An alphanumeric error code that can be used for reference when troubleshooting. This will be null if the status is "sending".
      - `mms_media` string[] — An array of MMS media urls to access the mms media that was attached and sent with this message.

## Other responses

- `204` — No conversations exist in the provided dashboard.'
- `401` — Unauthorized. Sent if the API key is omitted or invalid.

---

[API](https://skmtc.net/textrequest/apis/text-request-api-v3.md) · [All operations](https://skmtc.net/textrequest/apis/text-request-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/textrequest/text-request-api-v3/revisions/e4e42efcd650/schema)