---
title: "Get a conversation's messages by contact phone."
method: GET
path: "/dashboards/{dashboard_id}/contacts/{phone_number}/messages"
tags: ["Conversations", "Messages"]
---

# Get a conversation's messages by contact phone.

`GET /dashboards/{dashboard_id}/contacts/{phone_number}/messages`

Retrieves the conversation between the specified dashboard and phone number.

## Path parameters

- `dashboard_id` integer, required
- `phone_number` string, required

## Query parameters

- `page` integer
- `page_size` integer

## Response `200`

Messages in the conversation.

- MessageResponseContainer
  - `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` 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 contact in the dashboard matches the provided number.'
- `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)