SMS messages

List SMS

Messages you sent, newest first.

GEThttps://api.falconzo.com/v1/sms/messages

Each item has the same fields as Get an SMS: id, to, from, body, status, type, parts, encoding, price, currency, test, clientReference, errorCode, errorMessage, createdAt, sentAt, deliveredAt.

Permission

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

Query parameters

statusstring: QUEUED, SENT, DELIVERED, FAILED, EXPIRED or UNKNOWN.
tostring: Only messages to this number.
clientReferencestring: Only messages with this reference.
pageinteger: Page number, from 1. Default 1.
pageSizeinteger: Up to 100. Default 25.

Request

curl -X GET "https://api.falconzo.com/v1/sms/messages?status=FAILED&pageSize=50" \
  -H "Authorization: Bearer fz_test_YOUR_KEY"

Response

{
  "data": {
    "items": [
      {
        "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"
      }
    ],
    "meta": {
      "page": 1,
      "pageSize": 50,
      "total": 1,
      "totalPages": 1
    }
  }
}