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

# Consolidated Screening List Party

`POST /us/csl/party/v1`

## Request

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

Resolve one party on the US export and sanctions screening lists by its id and return the full record: names and aliases, addresses, programs, identifying numbers, the Federal Register notice, the dates and license terms of the listing. `found: false` when no list carries that id. 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
  - `id` string, required: Id de la parte en la Consolidated Screening List, p. ej. `sdn-36`, como lo devuelve la búsqueda.

## Response `200`

Successful response

- CslPartyResponse
  - `data` CslPartyData, required
    - `found` boolean, required
    - `id` string, required
    - `as_of` string, nullable, required: How current the data in this response is.
    - `party` object, nullable, 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)
