List Messages

GET /messages

Returns a paginated list of outbound communication log entries (SMS and email) for the authenticated clinic.

Scope required: communication.read.sms

Query Parameters

Parameter	Type	Description
patient_id	UUID	Filter by patient
channel	string	sms | email
from	string	Start date — Y-m-d
to	string	End date — Y-m-d
page	integer	Default: 1
limit	integer	Default: 20, max: 100

Response 200

{
  "data": [
    {
      "id": "018e1f2a-3b4c-7d5e-f6a7-b8c9d0e1f2a3",
      "channel": "sms",
      "type": "general",
      "recipient": "+905321234567",
      "subject": null,
      "message": "Your appointment is confirmed for tomorrow at 09:00.",
      "status": "delivered",
      "provider": "netgsm",
      "provider_message_id": "MSG-98765",
      "error_message": null,
      "sent_at": "2026-02-14T16:00:00+03:00",
      "patient": { "id": "…", "full_name": "Ali Yılmaz" }
    }
  ],
  "meta": { "page": 1, "limit": 20, "total": 1, "total_pages": 1 }
}