---
title: "Search Multiple Watchlists"
method: GET
path: "/watchlists"
tags: ["Watchlists"]
---

# Search Multiple Watchlists

`GET /watchlists`

Search a name across one or more watchlists, grouped by source.

## Query parameters

- `q` string, required — The name to search for across the watchlists.
- `watchlists` WatchlistSearchSource[], required — Watchlists to search. Repeat the param to search several (e.g. ?watchlists=OFAC&watchlists=PEP). At least one required; one billable order is written per requested watchlist.
- `similarity_threshold` number — Minimum similarity for a match (0.0–1.0).
- `limit` integer — Maximum matches to return per watchlist.

## Response `200`

Successful Response

- V1WatchlistSearchResponse — Response for a multi-watchlist name search, grouped by source. Includes one ``WatchlistSourceResult`` per requested source — including sources with zero matches — so callers can confirm which lists were searched.
  - `results` V1WatchlistSourceResult[], required — Per-source results, one entry per requested watchlist.
    - `source` 'OFAC' | 'PEP' | 'CSL' | 'FBI' | 'CNS' | 'OIG', required — Watchlists that can be searched by name via the GET /watchlists route.
    - `matches` V1WatchlistSearchMatch[] — Matches found in this watchlist, highest similarity first.
      - `name` string, required — The matched entity's primary name.
      - `similarity_score` number, required — Similarity of the match to the query name (0.0–1.0).
      - `details` object — Provider-specific fields for the match. Shape varies by watchlist source.
    - `count` integer, required — The number of matches returned for this watchlist (capped by the request's `limit`).
  - `total_matches` integer, required — Total matches returned across all searched watchlists.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/baselayer/apis/baselayer-api-service.md) · [All operations](https://skmtc.net/baselayer/apis/baselayer-api-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/baselayer/baselayer-api-service/versions/0cc89938bc26/schema)