---
title: "Changes to Retrieve a message"
method: GET
path: "/messages/{id}"
---

# Changes to Retrieve a message

`GET /messages/{id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 11 of 68 revisions.

- **2026-10-31** `e7aa9efd6e58`: 1 info
- **2026-10-16** `912b2a3101fc`: 2 info
- **2026-09-04** `93f3909cbde3`: 1 info
- **2026-08-19** `33842756c9f9`: 1 info
- **2026-06-30** `2dc9f9377d57`: 1 warning
- **2026-04-22** `844ecbfa0d5b`: 1 info
- **2026-02-19** `8e7818aeefab`: 4 warning
- **2026-02-12** `562a74493339`: 1 breaking
- **2026-02-01** `345fdd13af9e`: 1 breaking
- **2026-01-24** `41034d1fa948`: 1 info
- **2026-01-18** `fd3efee5d0c8`: 1 info

## Changes

- **2026-10-31** `e7aa9efd6e58`: 1 info
  - added the required property `created_at` to the response with the `200` status
- **2026-10-16** `912b2a3101fc`: 2 info
  - added the optional property `failure_reason` to the response with the `200` status
  - added the required property `conversation/phone_number/metadata` to the response with the `200` status
- **2026-09-04** `93f3909cbde3`: 1 info
  - added the optional property `status` to the response with the `200` status
- **2026-08-19** `33842756c9f9`: 1 info
  - added the optional property `conversation/contact/outbound_disabled` to the response with the `200` status
- **2026-06-30** `2dc9f9377d57`: 1 warning
  - added the new `contact` enum value to the `attachments/items/type` response property for the response status `200`
- **2026-04-22** `844ecbfa0d5b`: 1 info
  - added the required property `conversation/phone_number/name` to the response with the `200` status
- **2026-02-19** `8e7818aeefab`: 4 warning
  - added the new `file` enum value to the `attachments/items/type` response property for the response status `200`
  - added the new `image` enum value to the `attachments/items/type` response property for the response status `200`
  - added the new `link` enum value to the `attachments/items/type` response property for the response status `200`
  - added the new `video` enum value to the `attachments/items/type` response property for the response status `200`
- **2026-02-12** `562a74493339`: 1 breaking
  - the response property `blast_id` became nullable for the status `200`
- **2026-02-01** `345fdd13af9e`: 1 breaking
  - the response property `body` became nullable for the status `200`
- **2026-01-24** `41034d1fa948`: 1 info
  - added the optional property `blast_id` to the response with the `200` status
- **2026-01-18** `fd3efee5d0c8`: 1 info
  - added the optional property `metadata` to the response with the `200` status

---

[Operation](https://skmtc.dev/surgeapi/apis/surge/docs/messages/:id/get.md) - [API](https://skmtc.dev/surgeapi/apis/surge.md) - [Page](https://skmtc.dev/surgeapi/apis/surge/changes/messages/:id/get)