## Retrieve

`client.messages.retrieve(stringmessageID, RequestOptionsoptions?): MessageRetrieveResponse`

**get** `/api/v2/messages/{message_id}`

Retrieve details of a specific message by its ID

### Parameters

- `messageID: string`

### Returns

- `MessageRetrieveResponse`

  - `data?: Data`

    - `accountEmail?: string`

      Email of the account

    - `content?: string`

      Message content

    - `date_sent?: string`

      When the message was sent

    - `date_updated?: string`

      When the message was last updated

    - `error_code?: number | null`

      Numeric error code if message failed

    - `error_detail?: string | null`

      Detailed error information

    - `error_message?: string | null`

      Error message if message failed

    - `error_reason?: string | null`

      Error reason if message failed

    - `from_number?: string`

      Sender phone number

    - `group_display_name?: string | null`

      Display name for group messages

    - `group_id?: string | null`

      Group ID for group messages

    - `is_outbound?: boolean`

      Whether this is an outbound message

    - `media_url?: string | null`

      URL of attached media

    - `message_handle?: string`

      Unique message identifier

    - `message_type?: "message" | "group"`

      - `"message"`

      - `"group"`

    - `number?: string`

      Primary phone number (to_number for outbound, from_number for inbound)

    - `opted_out?: boolean`

      Whether the recipient has opted out

    - `participants?: Array<string>`

      List of participants for group messages

    - `plan?: string`

      Account plan used for this message

    - `send_style?: "celebration" | "shooting_star" | "fireworks" | 10 more`

      The iMessage expressive message style

      - `"celebration"`

      - `"shooting_star"`

      - `"fireworks"`

      - `"lasers"`

      - `"love"`

      - `"confetti"`

      - `"balloons"`

      - `"spotlight"`

      - `"echo"`

      - `"invisible"`

      - `"gentle"`

      - `"loud"`

      - `"slam"`

    - `sendblue_number?: string | null`

      Sendblue phone number used

    - `service?: "iMessage" | "SMS" | "RCS"`

      The messaging service used

      - `"iMessage"`

      - `"SMS"`

      - `"RCS"`

    - `status?: "REGISTERED" | "PENDING" | "SENT" | 7 more`

      - `"REGISTERED"`

      - `"PENDING"`

      - `"SENT"`

      - `"DELIVERED"`

      - `"RECEIVED"`

      - `"QUEUED"`

      - `"ERROR"`

      - `"DECLINED"`

      - `"ACCEPTED"`

      - `"SUCCESS"`

    - `to_number?: string`

      Recipient phone number

    - `was_downgraded?: boolean`

      Whether the message was downgraded from iMessage to SMS

  - `status?: string`

### Example

```typescript
import SendblueAPI from 'sendblue';

const client = new SendblueAPI({
  apiKey: process.env['SENDBLUE_API_API_KEY'], // This is the default and can be omitted
  apiSecret: process.env['SENDBLUE_API_API_SECRET'], // This is the default and can be omitted
});

const message = await client.messages.retrieve('msg_abc123def456');

console.log(message.data);
```