List conversations
Lists the inbox's conversations, most recent activity first. A conversation holds ready received messages and every send attempt, rejected and unknown included, and its counts include them.
The search, filters and ordering of message listings apply; a conversation matches when one of its messages meets every condition. Filtered results add matching_message_ids (up to 100, newest first) and matching_message_count.
subject is the earliest message's. latest_message is the newest message, whichever messages matched: its id, direction, counterpart (the From of received mail, or the first To of sent mail) and preview.
Labels belong to messages, not conversations. Reply using a message's id, not the thread ID.
Request
- Base URL: https://cherami.to
- URL: https://cherami.to/v1/inboxes/{inbox_id}/threads
- Auth: HTTP bearer
Path parameters
Cherami resource ID returned by the API.
Query parameters
Results per page.
next_cursor from the previous page. Keep the URL, filters and order unchanged.
Words or "quoted phrases" to find in the subject and body; every term must match. At most 16 terms and 512 UTF-16 code units. OR, NOT and wildcards have no special meaning, and attachments aren't searched. See Find mail.
Bare sender address from the message headers, matched exactly without regard to case; not the SMTP envelope. At most 320 UTF-16 code units.
Bare recipient address from the message headers, matched exactly without regard to case; not the SMTP envelope. At most 320 UTF-16 code units.
Text the subject contains, matched literally without regard to case. At most 998 UTF-16 code units.
Earliest (inclusive) receipt or send time, as an ISO 8601 instant with a timezone, such as 2026-10-01T00:00:00Z. after must be earlier than before. URL-encode it, including any + in an offset.
Latest (exclusive) receipt or send time, as an ISO 8601 instant with a timezone, such as 2026-10-01T00:00:00Z. after must be earlier than before. URL-encode it, including any + in an offset.
Messages carrying every listed label. Repeat the parameter for each label rather than separating with commas. The three label groups combine with AND.
Messages carrying at least one listed label. Repeat the parameter for each label rather than separating with commas. The three label groups combine with AND.
Messages carrying none of the listed labels, unlabeled ones included. Repeat the parameter for each label rather than separating with commas. The three label groups combine with AND.
relevance requires query.
Response
Success.
Changes
No recorded changes to this operation across all 1 revision of this API.