---
title: "Get a message"
method: GET
path: "/v2/messages/{messageId}"
tags: ["messaging"]
---

# Get a message

`GET /v2/messages/{messageId}`

Fetches a single direct message by its Blotato ID. The message may be an inbound message received from a contact, or an outbound message the user sent through Blotato.

## Path parameters

- `messageId` string, required

## Response `200`

Default Response

- object
  - `conversationId` string, nullable, required — Parent Blotato conversation id.
  - `createdAt` string, required
  - `direction` 'incoming' | 'outgoing', required
  - `errorCode` integer, nullable, required — Set only when status is `failed`.
  - `errorMessage` string, nullable, required — Set only when status is `failed`.
  - `id` string, required
  - `payload` object, nullable
    - `attachment` object
      - `type` 'button', required
      - `buttons` union[], required — Up to 3 call-to-action buttons attached to the message.
        - union
          - object
            - `type` 'web_url', required
            - `title` string, required — Button label shown to the recipient.
            - `url` string, required — https URL the button opens when tapped.
          - object
            - `type` 'postback', required
            - `title` string, required — Button label shown to the recipient.
            - `payload` string, required — Message posted back on tap.
    - `quickReplies` object[]
      - `title` string, required — Chip label shown to the recipient.
      - `payload` string, required — Message replied with on chip selection.
    - `selection` object
      - `payload` string, nullable, required
      - `type` 'postback' | 'quick-reply', required
  - `platform` 'facebook' | 'instagram', required
  - `recipientId` string, required
  - `senderId` string, nullable, required
  - `status` 'delivered' | 'failed' | 'processing' | 'queued' | 'sent', required
  - `text` string, required

## Other responses

- `403` — Forbidden
- `404` — Not found
- `500` — Server error

---

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