pods > threads

List Threads

Changed on Oct 16, 2026

Lists threads in the pod, most recent first. Pass senders, recipients, or subject to filter by substring. Filtered requests are served by search, which caps limit at 100. For relevance-ranked full-text search, use Search Threads.

CLI:

agentmail pods threads list --pod-id <pod_id>

get/v0/pods/{pod_id}/threads

Request

Base URL
https://api.agentmail.to
URL
https://api.agentmail.to/v0/pods/{pod_id}/threads
Auth
HTTP bearer

Path parameters

pod_idstring required

ID of pod.

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.

sendersstring[]

Filter to threads whose senders contain this value (substring match). Repeatable; all values must match.

recipientsstring[]

Filter to threads whose recipients contain this value (substring match). Repeatable; all values must match.

subjectstring[]

Filter to threads 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