v1

latestOpenAPI 3.1.1Proprietary2026-07-245895107.9 KB

SMS

Get SMS

Get an SMS.

get/sms/{sid}

Path parameters

sidstring required

Short ID

Example:callrsid

Resource SID (8 lowercase alphanumeric characters)

Response

SMS

direction'inbound' | 'outbound' required

The direction. Inbound is a call or an SMS received by the Callr platform. Outbound is a call or an SMS initiated by the Callr platform.

sidstring required

Short ID

tostring required

A phone number in ITU-T E.164 format https://en.wikipedia.org/wiki/E.164, prefixed by "+"

trafficType'marketing' | 'alerting' required

Traffic type of an SMS message. Carriers require this to be set to either marketing or alerting.

The status of the SMS.

created = The SMS has been created. error = The SMS has an error. expired = The SMS has expired. failed = The SMS has failed. pending = The SMS is waiting to be sent on our side. delivered = The SMS has been delivered to the recipient. remote-queued = The SMS is queued on the remote side. sent = The SMS has been sent.

errorstring

An error message, when applicable

createdstring date-time required

RFC 3339, section 5.6

deliveredstring date-time

RFC 3339, section 5.6

updatedstring date-time required

RFC 3339, section 5.6

sentstring date-time

RFC 3339, section 5.6

partsinteger required

The parts of the message

networkstring

ITU-T E.212 MCC MNC network

encoding'gsm' | 'unicode' required

By default, we automatically detect the encoding based on the characters used in the message. If you want to force the encoding, you can use this field. The SMS body will be processed according to the encoding specified. Depending on the encoding, messages may be split into parts of 153 (GSM 03.38) or 67 (UNICODE) characters. Please note that some countries only support GSM encoding.

coststring required

Amount in cents

paymentType'postpaid' | 'prepaid' required

Either prepaid or postpaid

Example response

{
  "direction": "inbound",
  "sid": "callrsid",
  "from": "+33199001234",
  "to": "+33199001234",
  "body": {
    "text": "Hello world!"
  },
  "trafficType": "marketing",
  "status": "sent",
  "created": "2024-04-24T17:42:28Z",
  "delivered": "2024-04-24T17:42:28Z",
  "updated": "2024-04-24T17:42:28Z",
  "sent": "2024-04-24T17:42:28Z",
  "parts": 10,
  "network": "20801",
  "encoding": "gsm",
  "cost": "5.50",
  "paymentType": "prepaid",
  "statusHistory": [
    {
      "after": "sent",
      "before": "sent",
      "at": "2024-04-24T17:42:28Z"
    }
  ]
}