Watchlist and alerts
Watch company names, import client lists, and read the alerts raised when a watched name appears in a decision.
#GET/v1/radar/watchlist
Response 200: { watches }.
#POST/v1/radar/watchlist
Watch one name. Recorded as radar.watch.added.
| Body field | Required | Description |
|---|---|---|
name | yes | At least 3 letters or digits; max 200. |
interest | yes | client, prospect, opponent or market. |
aliases | no | Up to 20 names of at least 3 letters or digits. |
note | no | Max 300. |
Response 201: the watch, with an id starting rwatch_.
#DELETE/v1/radar/watchlist/:id
Stop watching. Recorded as radar.watch.removed.
Response 200: { id, active: false }. Errors: 404 unknown watch.
#POST/v1/radar/watchlist/import
Preview or apply a bulk import of up to 1,000 rows (1 MB body limit).
| Body field | Required | Description |
|---|---|---|
listName | yes | Name of the list. |
importedBy | yes | Who imported it. |
csv or clients | yes | CSV text with a name column, or an array of { name, aliases?, externalId?, interest?, note? }. |
dryRun | yes | true to preview, false to apply. |
Re-imports merge by externalId, else by normalised name. Missing rows are not removed. Applying is recorded as radar.watchlist.imported. See Import a client watchlist.
#GET/v1/radar/alerts
Persistent matches of watched names in addressees, approved parties or published recitals.
| Query | Description |
|---|---|
from, to | Optional ISO dates, in order. |
watchId | Only one watch. |
limit, offset | Pagination. |
Response 200: alerts with their evidence path and source hash, total, watches, mode.