--- title: "Get a message" method: GET path: "/messages/{id}" tags: ["Messages"] --- # Get a message `GET /messages/{id}` ## Request - Base URL: `https://api.superchat.com/v1.0` - URL: `https://api.superchat.com/v1.0/messages/{id}` - Auth: API key in header `X-API-KEY` Returns a single message. ## Path parameters - `id` string, required ## Response `200` OK - 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 - `id` string: The ID of the attached file - `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 - `position` integer, required: The placeholder position of the template variable - `value` string, required: The resolved value of the template variable - 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 - MESSAGEWHATSAPPQUICKREPLYHEADERTEXT - `type` 'text', required - `value` string, required: The text value of the WhatsApp header - MESSAGEWHATSAPPQUICKREPLYHEADERIMAGE - `type` 'image', required - `value` string: The file ID used for the image header - MESSAGEWHATSAPPQUICKREPLYHEADERVIDEO - `type` 'video', required - `value` string: The file ID used for the video header - MESSAGEWHATSAPPQUICKREPLYHEADERDOCUMENT - `type` 'document', required - `value` string: The file ID used for the document header - `replies` PAMessageContentWhatsAppQuickReplyReply[], required: The quick reply options available to the recipient - `value` string, required: The quick reply option text - `type` 'whats_app_quick_reply', required - MESSAGECONTENTRESWHATSAPPTEMPLATE - `file` PAMessageContentResWhatsAppTemplateFileDTO - `id` string, nullable, required: The ID of the file used in the WhatsApp template header - `template_id` string: The ID of the WhatsApp template that was used - `type` 'whats_app_template', required - `variables` PAMessageResTemplateVariableDTO[]: The resolved template variables - `position` integer, required: The placeholder position of the template variable - `value` string, required: The resolved value of the template variable - MESSAGECONTENTRESWHATSAPPLIST - `body` string, required: The body text of the WhatsApp list message - `footer` string: The optional footer of the WhatsApp list message - `header` PAMessageContentWhatsAppListHeader - `value` string, required: The text value of the WhatsApp list header - `sections` PAMessageContentWhatsAppListSection[], required: The sections shown in the WhatsApp list message - `rows` PAMessageContentWhatsAppListSectionRow[], required: The rows contained in the WhatsApp list section - `description` string: The optional description of the WhatsApp list row - `title` string, required: The title of the WhatsApp list row - `title` string: The title of the WhatsApp list section - `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 - `id` string: The ID of the attached file - `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 - `position` integer, required: The placeholder position of the template variable - `value` string, required: The resolved value of the template variable - 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 - MESSAGEWHATSAPPQUICKREPLYHEADERTEXT - `type` 'text', required - `value` string, required: The text value of the WhatsApp header - MESSAGEWHATSAPPQUICKREPLYHEADERIMAGE - `type` 'image', required - `value` string: The file ID used for the image header - MESSAGEWHATSAPPQUICKREPLYHEADERVIDEO - `type` 'video', required - `value` string: The file ID used for the video header - MESSAGEWHATSAPPQUICKREPLYHEADERDOCUMENT - `type` 'document', required - `value` string: The file ID used for the document header - `replies` PAMessageContentWhatsAppQuickReplyReply[], required: The quick reply options available to the recipient - `value` string, required: The quick reply option text - `type` 'whats_app_quick_reply', required - object - `file` PAMessageContentResWhatsAppTemplateFileDTO - `id` string, nullable, required: The ID of the file used in the WhatsApp template header - `template_id` string: The ID of the WhatsApp template that was used - `type` 'whats_app_template', required - `variables` PAMessageResTemplateVariableDTO[]: The resolved template variables - `position` integer, required: The placeholder position of the template variable - `value` string, required: The resolved value of the template variable - object - `body` string, required: The body text of the WhatsApp list message - `footer` string: The optional footer of the WhatsApp list message - `header` PAMessageContentWhatsAppListHeader - `value` string, required: The text value of the WhatsApp list header - `sections` PAMessageContentWhatsAppListSection[], required: The sections shown in the WhatsApp list message - `rows` PAMessageContentWhatsAppListSectionRow[], required: The rows contained in the WhatsApp list section - `description` string: The optional description of the WhatsApp list row - `title` string, required: The title of the WhatsApp list row - `title` string: The title of the WhatsApp list section - `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 ## 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/messages/:id/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)