RiskAtlas Developer Documentation
RiskAtlas API: 全球制裁筛查、实体检索与日报接口
RiskAtlas 提供面向金融机构、跨境企业、风控系统和合规团队的制裁情报 API。 数据覆盖美国 OFAC、英国 OFSI、欧盟、加拿大、澳大利亚、联合国以及美国 BIS 相关清单， 支持实体检索、混合筛查、日报、统计分析、机器可读 OpenAPI 和 LLM 工作流集成。
Base URL and Access
Public product pages use https://atlas.scholarforce.ai. API access can be deployed on the same domain or on a dedicated customer API domain. Production API access should use HTTPS and token-based authentication.
curl "https://atlas.scholarforce.ai/api/entities/search?q=huawei&limit=5" \ -H "Authorization: Bearer YOUR_API_KEY"
What RiskAtlas Covers
Sanctions and restricted-party screening
Search companies, individuals, vessels and organizations across major sanctions and export-control lists. Results include entity type, status, jurisdiction, source list, sanction programs, country fields and dates.
Daily sanctions intelligence
Published daily reports use official listing and removal dates rather than local database ingestion events, reducing false interpretation of technical sync changes as business sanctions activity.
LLM-ready integration
Responses are structured JSON and can be used by LLM workflows, compliance copilots, Dify workflows, CRM enrichment, onboarding checks and case-management systems.
Canonical citation resources
OpenAPI, llms.txt, sitemap and plain-text summaries give search engines and AI answer engines stable references for what RiskAtlas is, what data it covers and how daily changes are calculated.
Core API Endpoints
/api/entitiesStructured sanctions entity search
Search active or inactive sanctioned entities by name, alias text, jurisdiction, source list, country, entity type and China-related flag.
Parameters: q, page, limit, jurisdiction, source_list, entity_type, country, is_china, is_active
/api/entities/searchKeyword search with Chinese-English expansion
Search sanctioned entities with multilingual keyword matching and common Chinese-to-English entity name expansion.
Parameters: q, page, limit, jurisdiction, source_list, entity_type, country, date_from, date_to, is_china
/api/entities/hybrid-searchHybrid sanctions screening
Combine structured filters, keyword similarity and semantic vector retrieval for entity screening and fuzzy name matching.
Parameters: q, mode, page, limit, jurisdiction, entity_type, country, is_china
/api/entities/{id}Entity detail
Return a single entity profile with source list, sanction programs, aliases, identifiers, country fields, listing date and removal date.
Parameters: id
/api/statsSanctions database statistics
Return total, active and inactive entity counts, jurisdiction distribution, China-related count, entity type distribution and current business-day changes.
/api/reportsPublished daily sanctions reports
List published daily sanctions intelligence reports or fetch a published report by date. Preview and unpublished reports are excluded.
Parameters: date
Entity Search Example
GET /api/entities/search?q=Huawei&country=CN&is_active=true&limit=5
{
"entities": [
{
"id": "entity-id",
"name": "Huawei Technologies Co., Ltd.",
"entity_type": "entity",
"country_code": "CN",
"country_name": "China",
"jurisdiction": "US",
"source_list": "BIS Entity List",
"listed_date": "2019-05-16",
"is_active": true,
"is_china": true,
"sanction_programs": ["Entity List"],
"reason": "Official source summary when available"
}
],
"pagination": {
"page": 1,
"limit": 5,
"total": 1,
"totalPages": 1
}
}Data Sources and Definitions
RiskAtlas normalizes official sanctions and restricted-party data from OFAC, OFSI, EU, UN, Canada, Australia and BIS-related lists. A listed entity means the subject is currently active on a sanctions or restricted-party list. A removed entity means the official list indicates that the subject is no longer active. Daily changes are calculated by official listing or removal date, not by internal database ingestion time.