GOgoguava
SMS

List received SMS messages

Lists SMS messages received on one of your organization's numbers, oldest first.

Results are paginated. If next_url is non-null, send a GET request to it (with the same credentials) to fetch the next page. When next_url is null, you've reached the most recent message.

get/v1/sms/messages

Request

Query parameters

to_numberstring required

Your organization's number to list received messages for, in E.164 format.

Example:+14155550100
received_afterstring date-time nullable

Only return messages received strictly after this time, as an ISO 8601 timestamp. Timestamps without an offset are treated as UTC. Defaults to returning all messages.

Example:2026-10-19T17:00:00Z
from_numberstring nullable

Only return messages from this sender, in E.164 format.

Example:+14155550123
limitinteger

Maximum number of messages per page.

Response

Successful Response

next_urlstring nullable

URL of the next page of results, or null if this is the last page. Send a GET request to it as-is.

Example response

{
  "results": [
    {
      "id": "6710a3f2c1e4b5a6d7e8f901",
      "from_number": "+14155550123",
      "to_number": "+14155550100",
      "content": "Yes, 3pm works for me.",
      "direction": "inbound"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.