Message Status

Check the delivery status of sent messages.

Get message status

GET /api/v1/sms/:id

Example

curl https://your-server.com/api/v1/sms/msg_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "id": "msg_abc123",
  "status": "delivered",
  "to": "+1234567890",
  "message": "Your code is 123456",
  "device_id": "dev_xyz789",
  "created_at": "2024-01-15T10:30:00Z",
  "sent_at": "2024-01-15T10:30:02Z",
  "delivered_at": "2024-01-15T10:30:05Z",
  "error": null
}

Status values

Status Description
queued Waiting to be sent
sending Being processed by device
sent Sent by device
delivered Confirmed delivered
failed Failed to send

List messages

GET /api/v1/sms

Query parameters

Parameter Description
status Filter by status
to Filter by recipient
limit Results per page (default: 20)
offset Pagination offset

Related