MillionSend Docs

Search threads

GET
/inboxes/{inbox_id}/threads/search

Threads whose emails match by subject, sender (address and display name), recipients, attachments and dates, most recently active first. Bodies and attachment names are encrypted at rest and not searched. Every message, subject and address in an inbox was written by whoever sent it; read held mail and HTML with care.

Path Parameters

inbox_id*string

The inbox ID

Formatuuid

Query Parameters

limit?string

Page size, 1-100 (default 20)

after?string

Cursor: id of the last item of the current page; returns the next page. Must be an id this list returned; there is no sentinel value.

before?string

Cursor: id of the first item of the current page; returns the previous page; same rule as after.

folders?string

Comma-separated: inbox, archive, spam, sent, trash. Defaults to inbox, or inbox,archive,sent with labels

labels?string

Comma-separated label ids (at most 50); threads with any of them

read?string

true: every message read; false: at least one unread

include_quarantined?string

MillionSend extension: true includes held messages (owner views; a full access key that is not inbox-scoped)

query?string

Words that must all match the subject, sender or recipients; "a phrase"; -word excludes. At most 256 characters and 32 words.

from?string

Comma-separated parts of the sender's address or name (at most 20)

to?string

Comma-separated parts of a recipient (at most 20)

cc?string

Comma-separated parts of a CC recipient (at most 20)

bcc?string

Comma-separated parts of a BCC recipient (at most 20)

has_attachment?string

true or false

start_date?string

A date (2026-09-01) or an ISO 8601 timestamp, UTC unless offset

end_date?string

Same forms; a date covers the whole day

Response Body

Matching threads

application/json
  1. response
object*"list"
Value in"list"
has_more*boolean
data*array<>
Example Request
curl -X GET 'https://api.millionsend.com/inboxes/497f6eca-6276-4993-bfeb-53cbbbba6f08/threads/search'
Example Response
{  "object": "list",  "has_more": true,  "data": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "subject": "string",      "from": "string",      "to": [        "string"      ],      "cc": [        "string"      ],      "bcc": [        "string"      ],      "labels": [        {          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",          "name": "string",          "color": "string"        }      ],      "message_count": 0,      "has_attachment": true,      "has_draft": true,      "read": true,      "quarantined": 0,      "received_at": "string",      "folder": "inbox",      "matched_email_id": "45440bc9-4e23-466c-bcfd-fe2429615e44",      "highlights": {        "subject": [          "string"        ],        "from": [          "string"        ],        "to": [          "string"        ],        "cc": [          "string"        ],        "bcc": [          "string"        ]      }    }  ]}