inboxes > messages

List Messages

Changed on Oct 16, 2026

Lists messages in the inbox, most recent first. Pass from, to, or subject to filter by substring. Filtered requests are served by search, which caps limit at 100. For relevance-ranked full-text search across sender, recipients, subject, and message body, use Search Messages.

CLI:

agentmail inboxes messages list --inbox-id <inbox_id>

get/v0/inboxes/{inbox_id}/messages

Request

Base URL
https://api.agentmail.to
URL
https://api.agentmail.to/v0/inboxes/{inbox_id}/messages
Auth
HTTP bearer

Path parameters

inbox_idstring required

The ID of the inbox.

Query parameters

limitinteger

Limit of number of items returned.

page_tokenstring

Page token for pagination.

labelsstring[]

Labels to filter by.

beforestring date-time

Timestamp before which to filter by.

afterstring date-time

Timestamp after which to filter by.

ascendingboolean

Sort in ascending temporal order.

include_spamboolean

Include spam in results.

include_blockedboolean

Include blocked in results.

include_unauthenticatedboolean

Include unauthenticated in results.

include_trashboolean

Include trash in results.

fromstring[]

Filter to messages whose sender contains this value (substring match). Repeatable; all values must match.

tostring[]

Filter to messages whose recipients (to, cc, or bcc) contain this value (substring match). Repeatable; all values must match.

subjectstring[]

Filter to messages whose subject contains this value (substring match). Repeatable; all values must match.

Response

Response with status 200

countinteger required

Number of items returned.

limitinteger

Limit of number of items returned.

next_page_tokenstring