List Messages

Endpoint

GET /api/sms/messages

Query parameters

Field	Type	Required	Description
`page`	integer	No	Page number, minimum `1` (default: 1)
`per_page`	integer	No	Results per page, `1`–`100` (default: 10)
`from`	date	No	Return messages created on/after this date (`YYYY-MM-DD`)
`to`	date	No	Return messages created on/before this date (`YYYY-MM-DD`)

Messages are returned newest first. Passing per_page above 100 returns 422.

Example

curl "https://sms.lamah.com/api/sms/messages?page=1&per_page=20&from=2024-01-01&to=2024-01-31" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Response

The response is wrapped in a data key containing a Laravel paginator object:

{
  "data": {
    "current_page": 1,
    "data": [
      {
        "short_message": "Your appointment is confirmed for Tuesday at 4:30 PM.",
        "message_type": "sms",
        "send_type": "single",
        "contact_group_id": null,
        "message_consumption": 1,
        "created_at": "2024-01-15T10:30:00Z",
        "updated_at": "2024-01-15T10:30:00Z",
        "receiver": [
          {
            "number": "00218912345678",
            "sent_at": "2024-01-15T10:30:02Z",
            "delivered_at": "2024-01-15T10:30:15Z",
            "status": "delivered",
            "delivery_report": null,
            "created_at": "2024-01-15T10:30:00Z",
            "updated_at": "2024-01-15T10:30:15Z"
          }
        ]
      }
    ],
    "first_page_url": "https://sms.lamah.com/api/sms/messages?page=1",
    "from": 1,
    "last_page": 5,
    "last_page_url": "https://sms.lamah.com/api/sms/messages?page=5",
    "links": [
      { "url": null, "label": "&laquo; Previous", "active": false },
      { "url": "https://sms.lamah.com/api/sms/messages?page=1", "label": "1", "active": true },
      { "url": "https://sms.lamah.com/api/sms/messages?page=2", "label": "2", "active": false },
      { "url": "https://sms.lamah.com/api/sms/messages?page=2", "label": "Next &raquo;", "active": false }
    ],
    "next_page_url": "https://sms.lamah.com/api/sms/messages?page=2",
    "path": "https://sms.lamah.com/api/sms/messages",
    "per_page": 20,
    "prev_page_url": null,
    "to": 20,
    "total": 95
  }
}

Top-level response fields

Field	Type	Description
`data`	object	Laravel paginator containing message records

Pagination fields

Field	Type	Description
`current_page`	integer	Current page number
`data`	array	Message records on the current page
`first_page_url`	string	URL of the first page
`from`	integer\|null	Index of the first record on the current page
`last_page`	integer	Total number of pages
`last_page_url`	string	URL of the last page
`links`	array	Laravel pagination navigation links
`next_page_url`	string\|null	URL of the next page
`path`	string	Base URL for this paginated resource
`per_page`	integer	Messages per page
`prev_page_url`	string\|null	URL of the previous page
`to`	integer\|null	Index of the last record on the current page
`total`	integer	Total number of messages matching filters

Message object fields

Field	Type	Description
`short_message`	string	Message content
`message_type`	string	Always `sms` for SMS messages
`send_type`	string	`single` or `multiple`
`contact_group_id`	string\|null	Contact group UUID if applicable
`message_consumption`	integer	SMS parts consumed
`created_at`	string	ISO 8601 timestamp
`updated_at`	string	ISO 8601 timestamp
`receiver`	array	List of receipt objects for each recipient

Receipt object fields

Field	Type	Description
`number`	string	Recipient phone number
`sent_at`	string	ISO 8601 timestamp when message was sent
`delivered_at`	string	ISO 8601 timestamp when message was delivered
`status`	string	Delivery status — see Get Message for the full list
`delivery_report`	string\|null	Raw delivery report if available
`created_at`	string	ISO 8601 creation timestamp
`updated_at`	string	ISO 8601 last update timestamp

Only messages that have been persisted appear here. A send accepted moments ago may still be in the ingest queue and absent from this list — fetch it by message_id via Get Message instead.

Error responses

422 Unprocessable Entity — Validation failed

{
  "message": "The per page field must not be greater than 100.",
  "errors": {
    "per_page": ["The per page field must not be greater than 100."]
  }
}

401 Unauthorized

{ "message": "Invalid or missing token." }

Pagination example

const getAllMessages = async () => {
  let allMessages = [];
  let currentPage = 1;
  let hasNextPage = true;

  while (hasNextPage) {
    const response = await fetch(
      `https://sms.lamah.com/api/sms/messages?page=${currentPage}&per_page=50`,
      { headers: { 'Authorization': 'Bearer YOUR_API_TOKEN' } }
    );

    const data = await response.json();
    allMessages = allMessages.concat(data.data.data);

    hasNextPage = data.data.current_page < data.data.last_page;
    currentPage++;
  }

  return allMessages;
};

List Messages

On this page