Skip to main content
GET
List received messages

Authorizations

Authorization
string
header
required

API key with an sk_live_ or sk_test_ prefix.

Query Parameters

limit
integer
default:50

Page size (1-100).

Required range: 1 <= x <= 100
before
string<date-time>

Only return messages received before this ISO-8601 timestamp (e.g. 2026-07-31T12:00:00Z). Combine with the last item's receivedAt to page backwards. Non-ISO-8601 values are rejected with a 400 invalid_request.

address
string

Filter to messages received on this address's public id.

Response

A page of received-message summaries.

messages
object[]
required