latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-15394599.9 KB

58dc5cff0ca7

SMS

Get an SMS log

Returns a single SMS log entry enriched with message details fetched live from the SMS provider: message body, delivery status, sent/delivered timestamps, and failure reason. If provider details are unavailable, the entry is returned with status: "unknown" and null detail fields.

get/v2/sms-logs/{sms_log_id}

Path parameters

sms_log_idinteger required

SMS log entry ID from the list endpoint.

Response

SMS log entry with message details.

idinteger required

Unique SMS log entry identifier.

direction'inbound' | 'outbound' required

Message direction relative to your organization.

from_numberstring nullable

The phone number the message was sent from.

to_numberstring required

The phone number the message was sent to.

session_idstring nullable

ID of the linked session when the message was part of an SMS conversation.

created_atstring date-time required

When the message was logged.

status'delivered' | 'failed' | 'sent' | 'queued' | 'unknown' required

Delivery status reported by the SMS provider. unknown when provider details are unavailable.

messagestring nullable

The message body, fetched from the SMS provider.

sent_atstring date-time nullable

When the message was sent by the provider.

delivered_atstring date-time nullable

When the message was delivered.

failure_reasonstring nullable

Reason the message failed, if delivery failed.

Example response

{
  "id": 42,
  "from_number": "+16625658792",
  "to_number": "+17189153182",
  "message": "Hello from OpenMic!"
}