Direct SECO sanctions screening for a UID

Screens the BUMIT-held registered company name directly against entity targets in the stored SECO consolidated sanctions dataset.

Scope is DIRECT_SECO_LIST_SCREENING: direct subjects only. SECO's list concerns directly sanctioned subjects and establishes no ownership or control relationships, so ownership_control_checked is always false.

A check_state of CLEAR means only that no direct candidate match was found in the dataset BUMIT checked. It does NOT mean the company is not sanctioned, that no sanctioned party owns or controls it, that other sanctions regimes are clear, or that it is safe to transact. This endpoint never asserts that a company is not sanctioned.

Matching is deterministic code with no similarity score, no threshold and no LLM. Candidate generation (exact normalized name, equal normalized token set, legal-form-reduced name) is separate from match classification. CONFIRMED_MATCH remains in the contract but is unreachable: SECO publishes no structured company identifier, so no authoritative identity rule exists that could confirm an entity match, and name evidence alone must never confirm.

Current listing state is DERIVED from structured modification history, never from a target's mere presence in the whole list; a de-listed target is still reported as a candidate with listing_state: DE_LISTED.

An unavailable, schema-unsupported or stale dataset, or a missing register name, yields UNKNOWN with SANCTIONS_CHECK_INCOMPLETE — never CLEAR. Live and scheduled SECO ingestion is disabled, so coverage is limited to the dataset already ingested.

get/api/v1/company/{uid}/sanctions

Request

  • Base URL: https://bumit.ai
  • URL: https://bumit.ai/api/v1/company/{uid}/sanctions
  • Auth: none required

Path parameters

uidstring required
Example:CHE-123.456.789

Swiss UID in canonical or compact form, e.g. CHE-123.456.789.

Response

Sanctions check state with scope, coverage, matching ruleset, candidate evidence, claims, freshness and provenance.

status'OK' required
uidstring required
uid_checksum_validboolean
capability'SANCTIONS_CHECK'
check_state'CLEAR' | 'POSSIBLE_MATCH' | 'CONFIRMED_MATCH' | 'UNKNOWN' required
reason_codesstring[]
screened_namestring nullable
normalized_screened_namestring nullable
candidate_countinteger
sourcesstring[]
provenanceobject nullable
attributionobject nullable
inference_usedunknown
ruleset_versionstring
legal_effectunknown
semantic_boundarystring
disclaimerobject

Changes

No recorded changes to this operation across all 1 revision of this API.