List messages

Retrieve a paginated list of messages for your account. Supports filtering
by status, recipient, channel, country, date range, and client reference.

Results are ordered by created_at descending (newest first).
Use cursor-based pagination to iterate through results.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
enum

Filter by message status

Allowed:
string

Filter by recipient phone number (E.164 format)

string
enum

Filter by messaging channel

Allowed:
string
length between 2 and 2

Filter by country code (ISO 3166-1 alpha-2)

date-time

Start of date range (ISO 8601 datetime, inclusive)

date-time

End of date range (ISO 8601 datetime, inclusive)

string

Filter by your client reference string

string

Filter by batch ID

integer
1 to 100
Defaults to 20

Number of results per page (1–100)

string

Pagination cursor from previous response

Responses

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json