Skip to main content
GET
This endpoint uses a standard project API key (AS_ prefix). Messages are scoped to the project the key belongs to. Blocked and unrouted messages are excluded unless includeBlocked=true is set.

Authorizations

string | header
required
Project API key header of the form Bearer as_<key>. You can also pass the key via the x-api-key header.

Query Parameters

string
Filter by sender email address (exact match, case-insensitive).Example: "[email protected]"
string
Filter by recipient email address (exact match, case-insensitive).Example: "[email protected]"
string
Filter to messages belonging to a specific conversation thread .Example: "60d5ec49f1b2c72d9c8b1234"
Case-insensitive substring search against the message subject.Maximum length: 200
string
Return only messages created on or after this timestamp (ISO 8601).Example: "2026-06-01T00:00:00.000Z"
string
Return only messages created on or before this timestamp (ISO 8601).Example: "2026-06-30T23:59:59.000Z"
integer
Page number (1-based). Defaults to 1.Minimum: 1
integer
Number of messages per page. Defaults to 50.Minimum: 1Maximum: 200

Response

Messages retrieved successfully
boolean
Indicates if the request was successfulExample: true
object

Error Responses

object
Returned when a query parameter fails validation (e.g. a malformed domainId, invalid email, or out-of-range limit).
object
Returned when the API key is missing or invalid.