Get a single message

GET

/api/v2/messages/{id}

curl --request GET \
  --url https://api.sipstack.com/api/v2/messages/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
  --header 'x-api-key: <x-api-key>'

import requests

url = "https://api.sipstack.com/api/v2/messages/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"

headers = {"x-api-key": "<x-api-key>"}

response = requests.get(url, headers=headers)

print(response.json())

const url = 'https://api.sipstack.com/api/v2/messages/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0';
const options = {method: 'GET', headers: {'x-api-key': '<x-api-key>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.sipstack.com/api/v2/messages/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0',
  headers: {'x-api-key': '<x-api-key>'}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Returns one message by its UUID. Org-scoped — a message id that belongs to another organization is indistinguishable from a missing one (both 404). Requires the sms:read scope.

Authorizations

apiKeyAuth

Parameters

Path Parameters

required

string format: uuid

Responses

200

The message.

application/json

object

success

boolean

data

A single SMS record as returned by GET /api/v2/messages.

object

string format: uuid

uuid

string format: uuid

direction

string

Allowed values: inbound outbound

status

string

to_phone_number

string

from_phone_number

string

body

string

segments

integer

media_urls

Attached MMS media URLs; null for a plain SMS. For uploaded media these are time-limited signed URLs, valid for 24 hours from the time the message is read — re-fetch the message for a fresh URL rather than storing them. Hosted URLs are returned exactly as supplied.

Array<string>

nullable

error_code

string

nullable

error_message

string

nullable

sent_at

string format: date-time

nullable

delivered_at

string format: date-time

nullable

created_at

string format: date-time

updated_at

string format: date-time

Examples

message

A single message

{
  "success": true,
  "data": {
    "id": "3a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d",
    "uuid": "3a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d",
    "direction": "outbound",
    "status": "delivered",
    "to_phone_number": "+14165550100",
    "from_phone_number": "+16135550200",
    "body": "Hi! Your appointment is confirmed for tomorrow at 2pm.",
    "segments": 1,
    "media_urls": null,
    "error_code": null,
    "error_message": null,
    "sent_at": "2026-01-15T14:30:01.000Z",
    "delivered_at": "2026-01-15T14:30:04.000Z",
    "created_at": "2026-01-15T14:30:00.000Z",
    "updated_at": "2026-01-15T14:30:04.000Z"
  }
}

401

Missing or invalid API key.

application/json

Inline error shape used by the messaging API and management endpoints.

object

success

boolean

error

string

Example

{
  "success": false,
  "error": "Recipient phone number (to) is required"
}

404

Message not found in your organization.

application/json

Inline error shape used by the messaging API and management endpoints.

object

success

boolean

error

string

Example

{
  "success": false,
  "error": "Recipient phone number (to) is required"
}

500

Internal error.

application/json

Inline error shape used by the messaging API and management endpoints.

object

success

boolean

error

string

Example

{
  "success": false,
  "error": "Recipient phone number (to) is required"
}