List matches
list_matchesList matches: conflicting domain registrations, trademark filings, app listings or search ads found by the monitors. Results are filtered to exactly one status (default inbox) and ordered by verdict, worst first (violation, warning, low, inconclusive, clear: a match whose assessment failed or is still open ranks with inconclusive), newest first within a verdict. status combines with verdict for questions like "watched matches that need review". update_matches triages the results by their ids or the same filters.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_matches"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | Match kind: domain, trademark, app or search_ad. | |
| page | No | Page number, 1-based. Page size is 50. | |
| since | No | ISO 8601 date or datetime; only matches detected or with activity on/after this time. E.g. "2026-04-20" or a full timestamp for "this week". | |
| status | No | Triage bucket: inbox (needs review), watching (no action needed now, record refreshes on schedule; never search ads), in_takedown (an open takedown is in progress; record refreshes on schedule except for search ads), resolved, dismissed. Defaults to inbox. | |
| subject | No | Substring match on the subject (the conflicting domain, mark or app name, or a search ad's title), and for search ads also the host the ad leads to, within the chosen status only; finding a subject in any status takes one call per status. At least 3 characters. | |
| verdict | No | Only matches whose shown assessment reached this verdict: violation (likely violation), warning (needs review), low (low risk), clear or inconclusive. Matches without a completed assessment are excluded. | |
| monitor_id | No | Limits results to one monitor. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | Yes | ||
| total | Yes | ||
| matches | Yes | ||
| page_size | Yes |