--- title: "Get conversation messages" method: GET path: "/conversations/{id}/messages" tags: ["Conversations"] --- # Get conversation messages `GET /conversations/{id}/messages` ## Request - Base URL: `https://api.superchat.com/v1.0` - URL: `https://api.superchat.com/v1.0/conversations/{id}/messages` - Auth: API key in header `X-API-KEY` List all messages for a conversation. ## Path parameters - `id` string, required ## Query parameters - `after` string, nullable - `before` string, nullable - `created_after` string, nullable - `created_before` string, nullable - `direction` 'INBOUND' | 'OUTBOUND', nullable - `limit` integer ## Response `200` OK - PAMessagePagedDocsExample - `url` string, required - `results` union[], required - union - MESSAGEINBOUND - `content` union, required: The content of the inbound message - MESSAGECONTENTRESTEXT - `body` string: The text body of the message - `type` 'text', required - MESSAGECONTENTRESMEDIA - `caption` string: The caption associated with the media message - `file_id` string: The ID of the attached file - `file_url` string: The public URL of the attached file when available - `type` 'media', required - MESSAGECONTENTRESEMAIL - `files` PASendMessageResEmailContentFileDTO[]: The files attached to the email - … - `html` string: The HTML body of the email - `subject` string: The subject of the email - `text` string: The plain text body of the email - `type` 'email', required - MESSAGECONTENTRESGENERICTEMPLATE - `template_id` string: The ID of the template that was used - `type` 'generic_template', required - `variables` PAMessageResTemplateVariableDTO[]: The resolved template variables - … - MESSAGECONTENTRESWHATSAPPQUICKREPLY - `body` string, required: The body text of the WhatsApp quick reply message - `footer` string: The optional footer of the WhatsApp quick reply message - `header` union: The optional header of the WhatsApp quick reply message - … - `replies` PAMessageContentWhatsAppQuickReplyReply[], required: The quick reply options available to the recipient - … - `type` 'whats_app_quick_reply', required - MESSAGECONTENTRESWHATSAPPTEMPLATE - `file` PAMessageContentResWhatsAppTemplateFileDTO - … - `template_id` string: The ID of the WhatsApp template that was used - `type` 'whats_app_template', required - `variables` PAMessageResTemplateVariableDTO[]: The resolved template variables - … - MESSAGECONTENTRESWHATSAPPLIST - `body` string, required: The body text of the WhatsApp list message - `footer` string: The optional footer of the WhatsApp list message - `header` PAMessageContentWhatsAppListHeader - … - `sections` PAMessageContentWhatsAppListSection[], required: The sections shown in the WhatsApp list message - … - `title` string, required: The button title used to open the list - `type` 'whats_app_list', required - MESSAGECONTENTRESINSTAGRAMSTORYREPLY - `body` string: The text content of the Instagram story reply - `type` 'instagram_story_reply', required - MESSAGECONTENTRESINSTAGRAMCOMMENT - `body` string: The text content of the Instagram comment - `type` 'instagram_comment', required - `conversation_id` string, required: The ID of the conversation the message belongs to - `created_at` string, date-time, required: The time when the message was created - `direction` 'inbound', required - `from` PAMessageInboundSenderDTO, required - `id` string, required: The ID of the contact who sent the inbound message - `identifier` string, required: The sender identifier on the source channel - `url` string: The URL of the sender contact resource - `id` string, required: The ID of the inbound message - `in_reply_to` string: The ID of the message this message replies to - `status` 'processed' | 'sent' | 'received' | 'sending_failed' | 'read', required - `to` PAMessageInboundReceiverDTO, required - `channel_id` string, required: The ID of the channel that received the inbound message - `updated_at` string, date-time, required: The time when the message was last updated - MESSAGEOUTBOUND - `url` string: The URL of the message resource - `id` string, required: The ID of the outbound message - `status` 'processed' | 'sent' | 'received' | 'sending_failed' | 'read', required - `conversation_id` string, required: The ID of the conversation the message belongs to - `in_reply_to` string, nullable, required: The ID of the message this message replies to - `content` union, required: The content of the outbound message - object - `body` string: The text body of the message - `type` 'text', required - object - `caption` string: The caption associated with the media message - `file_id` string: The ID of the attached file - `file_url` string: The public URL of the attached file when available - `type` 'media', required - object - `files` PASendMessageResEmailContentFileDTO[]: The files attached to the email - … - `html` string: The HTML body of the email - `subject` string: The subject of the email - `text` string: The plain text body of the email - `type` 'email', required - object - `template_id` string: The ID of the template that was used - `type` 'generic_template', required - `variables` PAMessageResTemplateVariableDTO[]: The resolved template variables - … - object - `body` string, required: The body text of the WhatsApp quick reply message - `footer` string: The optional footer of the WhatsApp quick reply message - `header` union: The optional header of the WhatsApp quick reply message - … - `replies` PAMessageContentWhatsAppQuickReplyReply[], required: The quick reply options available to the recipient - … - `type` 'whats_app_quick_reply', required - object - `file` PAMessageContentResWhatsAppTemplateFileDTO - … - `template_id` string: The ID of the WhatsApp template that was used - `type` 'whats_app_template', required - `variables` PAMessageResTemplateVariableDTO[]: The resolved template variables - … - object - `body` string, required: The body text of the WhatsApp list message - `footer` string: The optional footer of the WhatsApp list message - `header` PAMessageContentWhatsAppListHeader - … - `sections` PAMessageContentWhatsAppListSection[], required: The sections shown in the WhatsApp list message - … - `title` string, required: The button title used to open the list - `type` 'whats_app_list', required - object - `body` string: The text content of the Instagram story reply - `type` 'instagram_story_reply', required - object - `body` string: The text content of the Instagram comment - `type` 'instagram_comment', required - `to` PAMessageOutboundReceiverDTO[], required: The recipients of the outbound message - `contact_id` string, required: The ID of the recipient contact - `identifier` string, required: The recipient identifier on the target channel - `url` string: The URL of the recipient contact resource - `from` PAMessageOutboundSenderDTO, required - `name` string, nullable, required: The display name of the sender - `channel_id` string, required: The ID of the sending channel - `created_at` string, date-time, required: The time when the message was created - `updated_at` string, date-time, required: The time when the message was last updated - `direction` 'outbound': Whether the message is inbound or outbound - `pagination` Pagination, required - `next_cursor` string, nullable, required - `previous_cursor` string, nullable, required - `next_url` string, nullable, required - `previous_url` string, nullable, required ## Other responses - `401`: Unauthorized - `403`: Forbidden - `404`: Not Found - `500`: Internal Server Error ## Changes - **2026-11-03** `31e7bd6f37e9`: 1 info - endpoint added [Operation history](https://skmtc.dev/superchat/apis/superchat-api/changes/conversations/:id/messages/get.md) --- [API](https://skmtc.dev/superchat/apis/superchat-api.md) - [All operations](https://skmtc.dev/superchat/apis/superchat-api/llms.txt) - [OpenAPI document](https://skmtc.dev/superchat/apis/superchat-api/revisions/31e7bd6f37e9?raw)