Search Sent and Received Messages

Retrieve a list of messages within a specific date range. Supports filtering by from/to dates.

GET /messages/history

Required Permission

read:SingleSMS

Your API key must have this permission enabled in order to use this endpoint.

Example Request

curl --location 'https://<hostname>/messages/history?fromDate=2025-10-01&toDate=2025-10-11' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY'

Replace YOUR_API_KEY with your API key.

All endpoints shown in this documentation use a sample base URL. The production API endpoint is provided by our team upon request.

Query Parameters

Field	Type	Required	Description
fromDate	string (YYYY-MM-DD)	Yes	Start date of the search range.
toDate	string (YYYY-MM-DD)	Yes	End date of the search range.
offset	number	No	Number of records to skip (for pagination).
limit	number	No	Maximum number of records to return.

Response (HTTP 200)

{
  "success": true,
  "records": [
    {
      "id": "e5815fe-e86-4fd7-9cad-4944f023",
      "recipient": "4479000000001",
      "originator": "test",
      "text": "Hello World",
      "status": "Delivered",
      "sent_on": "2025-10-01T12:34:56.000Z"
    }
  ],
  "offset": 0,
  "limit": 10,
  "total": 42
}

This endpoint supports sorting and pagination. See Search & Pagination Parameters for details.