Search submissions across forms
search_submissionsRead-onlyIdempotent
Searches the 25 most recently active forms the connection can read and returns matches with the form each came from. Use it when you do not know which form holds what you are looking for; use list_submissions when you do, because that one pages through a single form completely. Takes the same filters. When the answer carries complete false, say the search was partial and narrow it with form_ids, team_id or a date range.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Any field contains this text, matched literally and without case. Use it first when you do not know which field holds the text. On some forms it covers only the fields recent submissions carry, so reach an older field by name with a field filter. | |
| read | No | ||
| field | No | Up to 5 filters keyed by field name, spelled the way the submissions spell it. Each is an object with one of eq, contains, starts_with, exists or in. Several filters combine with AND. Example: {"email": {"contains": "@example.com"}, "plan": {"in": ["pro", "team"]}}. | |
| limit | No | Matches in total across every form searched. There are no pages here, so ask for what you need in one call. | |
| fields | No | Only return these submitted fields, separated by commas, such as "email,name". Use it when you are scanning many submissions for one or two values, so the rest does not come back. | |
| status | No | inbox | |
| country | No | Two-letter uppercase country code. For several, separate them with commas, such as "DE,AT,CH". Max 20. | |
| team_id | No | Search this team only (from list_teams). Defaults to every team the connection covers. | |
| form_ids | No | Search only these forms, separated by commas (from list_forms). Forms the connection cannot read are left out whether or not you name them. Defaults to the 25 most recently active. | |
| created_after | No | RFC 3339 date or time, inclusive. | |
| created_before | No | RFC 3339 date or time, exclusive. | |
| has_attachments | No |