Interface ListFilters

One contact's conversation: items exchanged with this number (E.164), in both directions, across every line on the account.

Prefer this to listing everything and filtering yourself. An unfiltered list returns the newest 100 items ACROSS every conversation, so one thread's history is capped by how busy the others are and an older conversation can be missing from it entirely.

Group messages are never included — a group message is addressed to the group, and matching it against the participant who sent it would file their whole group into a private thread. Use groupId for those.

Restrict to one group conversation. Combines with the other filters; a group id that isn't on your account yields an empty list rather than an error.

Ignored by listCalls — only messages belong to a group.

Restrict to a single owned phone number.

Case-insensitive substring match on the message body.

Searched over your whole history, which then yields the 100 most recent matches — not a filter over the 100 an unfiltered call would have returned. Substring rather than full-text: no stemming and no word boundaries, so voice matches "invoiced".

Ignored by listCalls — a call has no body to match.

ISO-8601 timestamp; only items created strictly after this are returned.