---
title: "Returns a list of messages."
method: GET
path: "/v1/message_export"
---

# Returns a list of messages.

`GET /v1/message_export`

## Query parameters

- `created_after` string, date
- `created_before` string, date

## Response `200`

Array of messages

- MessageInfo[]
  - `id` string, uuid — Id of the message
  - `csid` integer — Id of the conversation the message belongs to
  - `created_at` integer — Timestamp of when the message was created
  - `initial_channel` string — The channel through which the communication was established
  - `author_name` string — Name of the author of the message
  - `author_email` string — Email of the author of the message
  - `direction` 'inbound' | 'outbound' — Direction of the conversation
  - `text` string — The full message text. Not relevant for PSTN phone and voicemail channels
  - `from_phone_number` string — Phone number the conversation was initiated from. Relevant only for PTSN phone and voicemail channels
  - `to_phone_number` string — Phone number the conversation was aimed for. Relevant only for PTSN phone and voicemail channels
  - `duration` number — Length of the call/voicemail. Relevant only for PTSN phone and voicemail channels
  - `recording_url` string — Link to the recording of the call. Relevant only for PTSN phone channel
  - `voicemail_url` string — Link to the voicemail. Relevant only for voicemail channel
  - `to` string[] — Email address(es) a conversation was aimed for. Relevant only for email and contact form channels
  - `from` string — Email address a conversation was initiated from. Relevant only for email and contact form channels
  - `cc` string[] — Email address(es) included in the email as CC. Relevant only for email channel
  - `bcc` string[] — Email address(es) included in the email as BCC. Relevant only for email channel
  - `attached_files` string[] — Link(s) to files that have been attached to the message. Relevant only for email and Facebook Messenger channel
  - `is_automated_message` boolean — Whether a message has been generated automatically or by an agent. Relevant only for widget chat
  - `chat_input_question` string — Input question initiating the conversation. Relevant only for widget chat
  - `chat_input_answer` string — Input answer initiating the conversation. Relevant only for widget chat
  - `chat_menu_text` string — Menu text initiating the conversation. Relevant only for widget chat
  - `form_submission` object — Form submission associated with the message. Relevant only for Messenger and ContactForm channels

## Other responses

- `400` — Invalid query parameters
- `401` — Invalid or missing credentials
- `429` — API limit has been reached
- `5XX` — Internal error

---

[API](https://skmtc.dev/dixa/apis/exports-api.md) · [All operations](https://skmtc.dev/dixa/apis/exports-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dixa/exports-api/revisions/286aee55f976/schema)