API Reference · scanction Sanctions Data System

Endpoint

GET http://sanctions.trustin.bond/api/v1/search

Public search endpoint, no authentication required. Returns the same results as the search page (hidden sources excluded), with cross-source related sanctions attached to each result.

Query Parameters

Parameter	Type	Default	Description
`q`	string	—	Keyword: name / alias / ID / program / nationality / address
`source_key`	string	—	Filter by data source key (e.g. us_ofac_sdn)
`schema_type`	string	—	Person / Organization / Vessel / Aircraft / Other
`active_only`	bool	false	Only active entities
`page`	int	1	Page number (1-based)
`page_size`	int	20	Items per page (max 200)
`with_related`	bool	true	Attach related sanctions to each result
`related_full`	bool	false	Include full entity fields in related (slower)

Example Request

curl "http://sanctions.trustin.bond/api/v1/search?q=huione&page_size=10"

Response

Returns a paginated result set. Each item is a full sanctioned entity; its related array lists the same entity found in other sanctions sources (for cross-reference).

{
  "total": 9,
  "page": 1,
  "page_size": 10,
  "pages": 1,
  "items": [
    {
      "id": 260846,
      "source_key": "us_fincen_311",
      "source_name": "US FinCEN Special Measures (311/9714)",
      "caption": "Huione Group",
      "schema_type": "Organization",
      "aliases": ["Huione Group Limited"],
      "nationalities": ["kh"],
      "addresses": [...],
      "identifiers": [...],
      "programs": [...],
      "listing_date": null,
      "is_active": true,
      "is_adjacent": false,
      "related_count": 1,
      "related": [
        {
          "id": 305112,
          "source_key": "gb_fcdo_sanctions",
          "source_name": "UK FCDO Sanctions List",
          "caption": "Huione Group",
          "listing_date": "2025-01-14",
          "match": "same_name",
          "is_active": true
        }
      ]
    }
  ]
}

Related Sanctions

match"shared_address" = matched by a shared crypto address (strongest); "same_name" = matched by an exact normalized name/alias.

listing_dateSanction listing date of the related record (null if the source does not provide one).

PrecisionOnly exact crypto-address or exact name/alias matches are returned — no fuzzy/substring matching, to avoid false links.

Notes

All responses are JSON (UTF-8).
Keyword search is substring (fuzzy) matching across multiple fields.
For large page sizes, pass with_related=false for faster responses.
Health check: GET http://sanctions.trustin.bond/api/health