Skip to main content
List all SMS messages sent by your organization.

​
Query Parameters

​
page
number
default:"1"
Page number for pagination
​
limit
number
default:"50"
Number of messages per page (max 100)
​
status
string
Filter by status: queued, sending, sent, delivered, failed, undelivered
​
to
string
Filter by recipient phone number

​
Response

​
data
array
Array of SMS message objects
​
pagination
object

​
Example

curl "https://www.unosend.co/api/v1/sms?page=1&limit=20&status=delivered" \
  -H "Authorization: Bearer un_your_api_key"

​
Response Example

{
  "data": [
    {
      "id": "sms_abc123",
      "from": "+18005551234",
      "to": "+14155551234",
      "body": "Your verification code is 123456",
      "status": "delivered",
      "segments": 1,
      "sent_at": "2024-01-15T10:30:00Z",
      "delivered_at": "2024-01-15T10:30:02Z",
      "error": null,
      "created_at": "2024-01-15T10:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 150,
    "pages": 8
  }
}