List messages
Retrieve a paginated list of sent messages with optional filters.
Use Cases:
- View message history
- Track delivery status
- Export message logs
- Audit messaging activity
GET
List messages
Retrieve a paginated list of sent messages with optional filters.
Use Cases:
- View message history
- Track delivery status
- Export message logs
- Audit messaging activity
Authorizations
Use your API key as a Bearer token. Format: Authorization: Bearer sk_live_xxxxx
Headers
API version in YYYY-MM-DD format. Using the latest version ensures access to newest features.
Pattern:
^\d{4}-\d{2}-\d{2}$Query Parameters
Number of messages to return (1-100)
Required range:
1 <= x <= 100Cursor for pagination (message ID)
Filter by message status
Available options:
queued, sent, delivered, failed, expired Filter by message route
Available options:
otp, transactional, promotional Filter messages created after this date (ISO 8601)
Filter messages created before this date (ISO 8601)