---
title: "Consolidated Screening List Search"
method: POST
path: "/us/csl/parties-search/v1"
tags: ["United States", "Consolidated Screening List"]
---

# Consolidated Screening List Search

`POST /us/csl/parties-search/v1`

## Request

- Base URL: `https://api.croma.run`
- URL: `https://api.croma.run/us/csl/parties-search/v1`
- Auth: HTTP bearer

Screen a name against every US export and sanctions screening list at once: OFAC's, the Entity List, the Denied Persons List and the other Commerce and State Department lists. Filter by name or alias, list, agency, program, country, identifying number or listing date. An identifying number (tax, registration, passport, SWIFT, digital currency address) matches ignoring spaces and punctuation. By name, pages of up to 50. Served by Croma (`as_of` says how current the data is), brought up to date daily.

**Dataset endpoint**: answers from the whole source in milliseconds and carries `as_of`.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `query` string: Palabras a buscar en los nombres (opcional).
  - `list` '' | 'sdn' | 'ssi' | 'plc' | 'ns_mbs' | 'cmic' | 'cap' | 'fse' | 'el' | 'dpl' | 'uvl' | 'meu' | 'isn' | 'dtc': Lista: `sdn`, `ssi`, `plc`, `ns_mbs`, `cmic`, `cap`, `fse` (Tesoro, OFAC), `el`, `dpl`, `uvl`, `meu` (Comercio, BIS), `isn`, `dtc` (Departamento de Estado) (opcional).
  - `agency` '' | 'treasury' | 'commerce' | 'state': Agencia que publica la lista: `treasury` (OFAC), `commerce` (Bureau of Industry and Security) o `state` (Departamento de Estado) (opcional).
  - `party_type` '' | 'individual' | 'entity' | 'vessel' | 'aircraft': Tipo de parte: `individual`, `entity` (empresa u organización), `vessel` o `aircraft` (opcional).
  - `program` string: Programa de sanciones o ley tal como lo escribe la lista, p. ej. `SDGT`, `CMIC-EO13959` (opcional).
  - `country` string: Código de país de dos letras de alguna dirección de la parte, p. ej. `CN`, `VE` (opcional).
  - `identifier` string: Número de identificación (tributario, de registro, pasaporte, SWIFT, dirección de criptomoneda…); se compara sin espacios ni signos (opcional).
  - `from_date` string, date: Optional date filter in yyyy-mm-dd format.
  - `to_date` string, date: Optional date filter in yyyy-mm-dd format.
  - `page` integer: 1-based page number for paginated results.
  - `per_page` integer: Resultados por página (1-50).

## Response `200`

Successful response

- CslPartiesSearchResponse
  - `data` CslPartiesSearchData, required
    - `as_of` string, nullable, required: How current the data in this response is.
    - `query` string, required
    - `list` string, nullable, required
    - `agency` string, nullable, required
    - `party_type` string, nullable, required
    - `program` string, nullable, required
    - `country` string, nullable, required
    - `identifier` string, nullable, required
    - `from_date` string, nullable, required
    - `to_date` string, nullable, required
    - `total` number, required: Parties matching the filters, across every page, counted up to 1000.
    - `total_is_exact` boolean, required: False when more than 1000 match: `total` is then 1000, and the pages go on.
    - `page` number, required
    - `per_page` number, required
    - `total_pages` number, required: Pages over `total`; there are more when `total_is_exact` is false.
    - `count` number, required
    - `parties` object[], required
      - `id` string, required: The list and the entry's number joined by a hyphen: OFAC's entity number on a Treasury list (`sdn-36`), the entry's own id on a Commerce or State list (`el-…`). The key.
      - `list` 'sdn' | 'ssi' | 'plc' | 'ns_mbs' | 'cmic' | 'cap' | 'fse' | 'el' | 'dpl' | 'uvl' | 'meu' | 'isn' | 'dtc', required: The list, by its abbreviation: `sdn`, `ssi`, `plc`, `ns_mbs`, `cmic`, `cap`, `fse` (Treasury), `el`, `dpl`, `uvl`, `meu` (Commerce), `isn`, `dtc` (State).
      - `list_name` string, required: The list's full name, e.g. `Entity List (EL)`.
      - `agency` 'treasury' | 'commerce' | 'state', required: Who publishes the list: `treasury` (OFAC), `commerce` (the Bureau of Industry and Security) or `state` (the State Department).
      - `entity_number` integer, nullable, required: OFAC's own number for the party, on a Treasury list; null on the others.
      - `name` string, required: The party's name as the list writes it.
      - `alt_names` string[], required: Every other name the list records for the party.
      - `party_type` 'individual' | 'entity' | 'vessel' | 'aircraft', nullable, required: `individual`, `entity`, `vessel` or `aircraft` on a Treasury list; null on the Commerce and State lists, which do not say.
      - `programs` string[], required: The sanctions programs or statutes the listing is under, as the list writes them, e.g. `SDGT`, `CMIC-EO13959`, `Chemical and Biological Weapons Act`.
      - `title` string, nullable, required: The person's title or role, when recorded.
      - `remarks` string, nullable, required: The list's own note.
      - `addresses` object[], required: Every address the list records for the party.
        - `address` string, nullable, required
        - `city` string, nullable, required
        - `state` string, nullable, required
        - `postal_code` string, nullable, required
        - `country` string, nullable, required: A two-letter country code for most addresses; a few carry a region as the list writes it.
      - `countries` string[], required: The distinct countries of the party's addresses (and, on the nonproliferation list, of the party itself), mostly as two-letter codes.
      - `identifiers` object[], required: The identifying numbers and facts the list records: tax and registration numbers, passports, national ids, SWIFT codes, vessel IMO numbers, digital currency addresses, websites, and OFAC's own notes such as gender or secondary sanctions risk.
        - `type` string, required: What the number is, as the list names it, e.g. `Tax ID No.`, `Passport`, `NIT #`, `Unified Social Credit Code (USCC)`, `SWIFT/BIC`.
        - `number` string, nullable, required
        - `country` string, nullable, required: The two-letter code of the country that issued it, when recorded.
        - `issue_date` string, nullable, required: As the list writes it, e.g. `18 Jan 1984`.
        - `expiration_date` string, nullable, required: As the list writes it.
      - `identifier_numbers` string[], required: The identifying numbers alone, upper-cased without spaces or punctuation, for matching.
      - `dates_of_birth` string[], required: As the list writes them: a date, a year, `circa 1960`, or a range.
      - `places_of_birth` string[], required
      - `nationalities` string[], required: Two-letter country codes.
      - `citizenships` string[], required: Two-letter country codes.
      - `federal_register_notice` string, nullable, required: The Federal Register notice or notices that published the listing, e.g. `85 FR 34495`.
      - `start_date` string, nullable, required: When the listing took effect (yyyy-mm-dd), on the lists that record it: the Entity List, the Denied Persons List, the Military End User List and the nonproliferation sanctions.
      - `end_date` string, nullable, required: When a denial order ends (yyyy-mm-dd), when recorded.
      - `standard_order` boolean, nullable, required: On the Denied Persons List: whether the denial is a standard order.
      - `license_requirement` string, nullable, required: On the Commerce lists: which items need a license to export to the party.
      - `license_policy` string, nullable, required: On the Commerce lists: how a license application is reviewed, e.g. `Presumption of denial`.
      - `vessel` object, nullable, required: Set only for a vessel.
        - `call_sign` string, nullable, required
        - `type` string, nullable, required
        - `gross_tonnage` string, nullable, required
        - `gross_registered_tonnage` string, nullable, required
        - `flag` string, nullable, required
        - `owner` string, nullable, required
      - `source_list_url` string, nullable, required: The agency's page for the list.
      - `source_information_url` string, nullable, required: The agency's guidance on the list.

## Other responses

- `400`: Invalid request body
- `401`: Missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream source returned an error

---

[API](https://skmtc.dev/usecroma/apis/croma-marketplace-api.md) · [All operations](https://skmtc.dev/usecroma/apis/croma-marketplace-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usecroma/apis/croma-marketplace-api/revisions/df016cdb29d7?raw)