---
title: "Retrieve a message"
method: GET
path: "/api/v1/messages/{id}"
tags: ["Messaging"]
---

# Retrieve a message

`GET /api/v1/messages/{id}`

## Request

- Base URL: `https://api.callnode.io`
- URL: `https://api.callnode.io/api/v1/messages/{id}`
- Auth: API key in header `X-Api-Key` and API key in header `X-Timestamp` and API key in header `X-Signature`

## Path parameters

- `id` string, required

## Response `200`

The message, including its latest delivery status.

- Message
  - `id` string
  - `status` 'queued' | 'sent' | 'delivered' | 'failed'
  - `from` string: Plus sign followed by 7–15 digits.
  - `to` string: Plus sign followed by 7–15 digits.
  - `messageType` 'sms' | 'mms'
  - `segments` integer
  - `cost` number
  - `errorCode` string, nullable
  - `errorMessage` string, nullable
  - `deliveredAt` string, date-time, nullable
  - `createdAt` string, date-time
  - `metadata` object

## Other responses

- `401`: Missing, unknown, or badly signed credentials — check the HMAC and the timestamp skew.
- `404`: No such resource on this account.

---

[API](https://skmtc.dev/callnode/apis/callnode-outbound-api.md) · [All operations](https://skmtc.dev/callnode/apis/callnode-outbound-api/llms.txt) · [OpenAPI document](https://skmtc.dev/callnode/apis/callnode-outbound-api/revisions/c7da6ad06509?raw)