Cross-Border Restricted Party Evidence

Review-oriented party-name evidence from the official U.S. International Trade Administration (ITA) Consolidated Screening List (CSL). The Actor accepts up to 50 party queries, compares each name against published primary names and aliases, and returns reproducible evidence rows with source identity, source fetch time, match score, published addresses and identifiers, and SHA-256 receipts.

This product is useful to U.S. teams and to India- and China-facing suppliers, sourcing teams, marketplaces, and compliance operations that participate in U.S.-regulated transactions. Its coverage is the U.S. ITA CSL. It does not claim to cover every U.S., Indian, Chinese, or international restriction, and it never issues legal clearance.

Evidence decisions

• POTENTIAL_MATCH_REVIEW_REQUIRED: an exact or threshold-meeting fuzzy primary-name or alias candidate exists. Every candidate requires human due diligence against the cited official list.
• NO_CSL_NAME_MATCH: no name or alias in the completely downloaded source snapshot met the configured rule. This is not clearance or proof that the party is unrestricted.
• SOURCE_UNAVAILABLE: the official source could not be fetched or could not be validated as a complete CSL payload. This is deliberately distinct from a no-match.

Optional country and address values are consistency checks only. They never increase a candidate's name score or suppress a name match. A country or address conflict is evidence for review, not a reason to silently discard a candidate.

Input

{
  "queries": [
    {
      "reference": "supplier-1042",
      "name": "China Telecom Corporation Limited",
      "country": "CN",
      "address": "Beijing"
    }
  ],
  "matchMode": "fuzzy",
  "minimumScore": 92,
  "maxCandidatesPerQuery": 5
}

• queries: 1-50 objects. name is required. reference, ISO alpha-2 country, and address are optional.
• matchMode: exact or fuzzy (default fuzzy). Exact mode uses normalized full-name/alias equality.
• minimumScore: integer 85-100 (default 92).
• maxCandidatesPerQuery: integer 1-10 (default 5).

The deterministic fuzzy score is this Actor's candidate-retrieval score. It is not an ITA risk rating, recommendation, endorsement, or legal conclusion.

Output evidence

Each row includes the query, decision and reasons; matched name, basis, score, and rank; published CSL record ID, entity number, party name, aliases, addresses, identifiers, programs, remarks, and source-list links; source URL, fetch time, snapshot SHA-256 and record count; a stable matched-record fingerprint; and a decision receipt hash. legal_clearance is always false.

Responsible use

Use this Actor as a screening aid and audit trail, not as an autonomous approval, denial, onboarding, credit, employment, housing, or other consequential-decision engine. Resolve potential matches using the official Federal Register and the responsible agency's current list. Apply appropriate human review, legal advice, privacy controls, and retention limits. Do not treat a score as identity proof, wrongdoing, or an instruction to transact or refuse to transact.

ITA's own CSL guidance says the tool is an aid to electronic screening, possible matches require additional due diligence, and users should check the Federal Register and official agency lists before taking action.

Official source

• CSL information and responsible-use guidance: https://www.trade.gov/consolidated-screening-list
• Official downloadable JSON: https://data.trade.gov/downloadable_consolidated_screening_list/v1/consolidated.json
• ITA developer terms: https://developer.trade.gov/terms-of-service

See SOURCE-POLICY.md for the fail-closed source contract.

Tests

npm test
npm run test:live

The unit suite uses fixtures and failure injection. The bounded live suite performs three queries against one current, completely downloaded official snapshot: exact, fuzzy typo, and a synthetic no-match. It makes no account, publication, pricing, or outreach mutations.