Watchlist Statistics

The Watchlist Statistics page provides a comprehensive dashboard of data related to all Watchlists created by the tenant in the TrustX system.

To access the Watchlist Statistics page, follow the steps outlined below:

1. Log in to the Backoffice application and select Watchlists from the left-side vertical menu.
2. From the Watchlists page, find the 'Statistics' button located on the top-right of the screen.

3. Clicking the 'Statistics' button will redirect to the Watchlists Statistics dashboard.

Watchlist Statistics Dashboard

This section will describe each data point available in the Backoffice dashboard per title.

Total Watchlists

Each tenant has a limit of 1000 Watchlists that they are able to create in TrustX. This statistic demonstrates how near the tenant is to reaching the established limit.

Used - The number of Watchlists created by the tenant in TrustX.

Remaining - The number of remaining Watchlists that can be created by the tenant.

Watchlist Types

Provides a breakdown of the number of Watchlists created per type.

Watchlists by Member Count

Highlights the ten most populated Watchlists, ranked by the number of members in each.

Selecting the name of a Watchlist under each entry in the bar chart will redirect to the configuration page of the selected Watchlist.

Watchlist Statistic via API

Watchlist statistics can be retrieved programatically via the TrustX API. Retrieving statistics from the TrustX API requires the necessary tenant permissions. To learn more about configuring tenant API permissions, see the (Link Removed) guide.

Get Watchlist Type Statistics

Retrieves usage statistics for watchlists including total count, remaining capacity, and breakdown by watchlist type. Useful for monitoring quota limits and current usage.

Endpoint: GET /api/watchlist-manager/watchlists/usage

API Permissions: TNT#{tenantid}#WatchlistManager:getWatchlistV2Usage

Example Request:

GET https://{{tenant}}.{{region}}.trustx.com/api/watchlist-manager/watchlists/usage

Content-Type: application/json

X-API-Key: {{apiKey}}

​

{}

Example Response:

{

    "maxAllowed": 1000,

    "total": 258,

    "remaining": 742,

    "watchlists": {

        "documentNumber": {

            "total": 11

        },

        "ipv4Address": {

            "total": 7

        },

        "facev6": {

            "total": 233

        },

        "visitorID": {

            "total": 7

        }

    }

}

Get Individual Watchlist Usage Statistics

Retrieves usage statistics for a specific watchlist including total entry count, remaining capacity, and maximum allowed entries.

Endpoint: GET /api/watchlist-manager/watchlists/{watchlistId}/usage

API Permissions: TNT#{tenantid}#WatchlistManager:getWatchlistUsage

Example Request:

GET https://{{tenant}}.{{region}}.trustx.com/api/watchlist-manager/watchlists/{watchlistId}/usage

Content-Type: application/json

X-API-Key: {{apiKey}}

​

{}

Example Response:

{

    "maxAllowedEntries": 10000,

    "totalEntries": 6,

    "remainingEntries": 9994

}

Get Largest Watchlist by Entry Count

Retrieves the top N Watchlists sorted by entry count (size) in descending order. Results are cached for 1 minute to improve performance. When multiple Watchlists have the same entry count, they are ordered by most recently updated to ensure deterministic ordering. Exactly limit results are returned (no ties beyond limit). The response includes cache metadata indicating when the statistics were collected and when the cache will be expired.

Endpoint: GET /api/watchlist-manager/watchlists/usage/largest

API Permissions: TNT#{tenantid}#WatchlistManager:getLargestWatchlists

Example Request:

GET https://{{tenant}}.{{region}}.trustx.com/api/watchlist-manager/watchlists/usage/largest

Content-Type: application/json

X-API-Key: {{apiKey}}

​

{}

Example Response:

{

    "watchlists": [...],

    "totalReturned": 10,

    "lastUpdatedAt": "2026-01-26T09:15:53.838Z"

}