Watchlists

Resolve watchlists

Resolve watchlists by name. For each name, returns the organization's private watchlist if one exists, otherwise falls back to the matching public watchlist.

get/v1/api/watchlists/resolve

Request

  • Base URL: https://api.perigon.io
  • URL: https://api.perigon.io/v1/api/watchlists/resolve
  • Auth: HTTP bearer

Query parameters

namestring[]

Watchlist names to resolve (max 100)

Response

200 - Success

Example response

{
  "data": [
    {
      "id": 42,
      "createdAt": "2025-06-01T09:00:00.000Z",
      "updatedAt": "2025-08-01T16:30:00.000Z",
      "name": "ai-executives",
      "displayName": "AI Executives",
      "description": "Leadership at major AI companies.",
      "people": [],
      "companies": [],
      "organizationId": 1001,
      "visible": true
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.