SMS messages

Get an SMS

One message and its current status.

GEThttps://api.falconzo.com/v1/sms/messages/{id}

Use it to check a message you sent, or rely on webhooks to be told as its status changes.

A test key only finds messages sent with test keys; a live key only finds real ones.

Permission

The API key needs sms.read (read sms messages and their status). Without it the answer is 403 MISSING_SCOPE.

Path parameters

idstringrequired: The messageId returned when it was sent.

Errors

Besides UNAUTHORIZED, MISSING_SCOPE and RATE_LIMITED, which any endpoint can return:

NOT_FOUND · 404The message or template doesn't exist, or belongs to the other mode (test or live).

All codes are listed in Errors and limits.

Request

curl -X GET "https://api.falconzo.com/v1/sms/messages/cmx1abc2def3" \
  -H "Authorization: Bearer fz_test_YOUR_KEY"

Response

{
  "data": {
    "id": "cmx1abc2def3",
    "to": "94771234567",
    "from": "ABCSHOP",
    "body": "Your order #1042 has shipped.",
    "status": "DELIVERED",
    "type": "TRANSACTIONAL",
    "parts": 1,
    "encoding": "GSM",
    "price": "0.40",
    "currency": "LKR",
    "test": false,
    "clientReference": "1042",
    "errorCode": null,
    "errorMessage": null,
    "createdAt": "2026-11-08T10:15:00.000Z",
    "sentAt": "2026-11-08T10:15:01.000Z",
    "deliveredAt": "2026-11-08T10:15:04.000Z"
  }
}