Count received messages
Counts received messages matching the same query and filters as List received messages, including messages that aren't ready to read yet.
Request
- Base URL: https://cherami.to
- URL: https://cherami.to/v1/inboxes/{inbox_id}/messages/count
- Auth: HTTP bearer
Path parameters
Cherami resource ID returned by the API.
Query parameters
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.
Response
Success.
Changes
No recorded changes to this operation across all 1 revision of this API.