U.S. Export Transaction Restricted-Party Screening API

A small B2B API that screens every named party in an export transaction against the official U.S. Consolidated Screening List (CSL) and returns explainable candidate matches for human review.

Core rule

The API never returns LEGAL, ILLEGAL, APPROVED, DENIED, or CLEAR.

It returns only:

• NO_LIST_MATCH — no actionable candidate match was found in the synchronized CSL data.
• REVIEW — evidence is sufficiently similar to require human review.
• POTENTIAL_MATCH — strong evidence of a possible CSL identity match; human review is required.

V1 endpoints

• POST /v1/party/screen
• POST /v1/transaction/screen — primary commercial endpoint
• POST /v1/transaction/batch
• GET /v1/lists/status
• GET /health

Example request

{
  "transaction_id": "TX-9472",
  "destination_country": "AE",
  "parties": [
    {
      "name": "Example Industrial Trading LLC",
      "role": "consignee",
      "country": "AE",
      "address": "12 Example Road",
      "city": "Dubai"
    }
  ]
}

The engine separates primary-name similarity, alias similarity, address similarity, country consistency, identifier matches, and entity-type consistency. The API exposes these signals rather than hiding them inside a single opaque risk score.

Dataset synchronization

scripts/sync_csl.py downloads the official machine-readable CSL feed and creates a compact local dataset. A GitHub Actions workflow refreshes it daily. The API therefore has near-zero marginal data cost per screening and does not depend on an LLM.

Official source: https://www.trade.gov/consolidated-screening-list

Important limitations

This is a restricted-party screening aid, not legal advice or a transaction authorization system. NO_LIST_MATCH is not a compliance clearance. V1 does not evaluate beneficial ownership or OFAC's 50 Percent Rule, ECCN/classification, end-use, licensing, or non-U.S. sanctions lists. Potential matches require additional due diligence against authoritative source lists and applicable regulations.

Required ITA attribution

This product uses the International Trade Administration’s Data API but is not endorsed or certified by the International Trade Administration.

Local development

python -m venv .venv
source .venv/bin/activate
pip install -r requirements-dev.txt
python scripts/sync_csl.py
uvicorn app.main:app --reload

Run tests:

pytest -q