API reference
Watchlist API
Add the companies and people you want monitored, review the court cases discovered for them, and manage the cases being tracked.
13 endpoints
- POSTAdd entity to watchlist
/watchlist/entitiesAdds a company or person to the account's watchlist. - POSTSearch watchlist entities
/watchlist/entities/searchSearches the watchlist entities you can see: those in your account and those shared with you. - GETGet a watchlist entity
/watchlist/entities/{id}Returns a single watchlist entity by its id, including risk fields computed from its active cases. - PUTUpdate a watchlist entity
/watchlist/entities/{id}Updates the details of a watchlist entity. - DELETEStop monitoring an entity
/watchlist/entities/{id}Stops monitoring an entity. - POSTSearch discovered case candidates for an entity
/watchlist/entities/{id}/candidates/searchCustomer's own view of court-case candidates found against this company. - POSTAdd a candidate to the watchlist
/watchlist/candidates/{id}/promoteConfirms a discovered case candidate as a tracked case. - POSTDecline a candidate
/watchlist/candidates/{id}/declineDeclines a discovered case candidate: your "no" to it. - POSTAdd a case to the watchlist
/watchlist/casesAdds a case to the watchlist, either manually or by confirming a match from a case search (pass its result as snapshot). - POSTSearch watchlist cases
/watchlist/cases/searchRequires case.read. Only cases visible to the caller (own + shared) are returned; archived cases are excluded. Also how the "Monitored" tab of a company's case list is populated (filter by watchlistEntityIds). - GETGet a watchlist case
/watchlist/cases/{id}Returns a single tracked case by its id, including its case identifier, status, risk level and the entities it is linked to. - PUTUpdate a watchlist case
/watchlist/cases/{id}Changes a case's riskLevel and/or status. - DELETEStop monitoring a case
/watchlist/cases/{id}Stops monitoring a case.
About this API
Companies/persons being monitored, the cases discovered/tracked against them, and the review queue candidates sit in before becoming a real tracked case.
All requests use your API key. See Authentication, and Rate limits & errors for how calls are counted.
Last updated 14 October 2026