{"openapi":"3.1.0","info":{"title":"RiskAtlas API","version":"1.0.0","description":"Global sanctions intelligence API for entity search, restricted-party screening, daily sanctions reports and structured compliance data integration."},"servers":[{"url":"https://atlas.scholarforce.ai"}],"tags":[{"name":"Entities","description":"Sanctions entity search and detail endpoints"},{"name":"Analytics","description":"Sanctions statistics, trends and jurisdiction analysis endpoints"},{"name":"Reports","description":"Published daily sanctions intelligence reports"}],"paths":{"/api/entities":{"get":{"tags":["Entities"],"summary":"Search sanctions entities with structured filters","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"Search term for name, aliases, reason, country or jurisdiction"},{"name":"page","in":"query","required":false,"schema":{"type":"integer"},"description":"Page number"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"},"description":"Page size, max 100"},{"name":"jurisdiction","in":"query","required":false,"schema":{"type":"string"},"description":"Jurisdiction filter such as US, UK, EU or UN"},{"name":"source_list","in":"query","required":false,"schema":{"type":"string"},"description":"Official source list filter"},{"name":"entity_type","in":"query","required":false,"schema":{"type":"string"},"description":"Entity type filter"},{"name":"country","in":"query","required":false,"schema":{"type":"string"},"description":"Country code or country name"},{"name":"is_china","in":"query","required":false,"schema":{"type":"boolean"},"description":"Return China-related entities only when true"},{"name":"is_active","in":"query","required":false,"schema":{"type":"boolean"},"description":"Filter by current active status"}],"responses":{"200":{"description":"Entity search response","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/entities/search":{"get":{"tags":["Entities"],"summary":"Keyword sanctions search with multilingual expansion","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"Search term"},{"name":"page","in":"query","required":false,"schema":{"type":"integer"},"description":"Page number"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"},"description":"Page size, max 100"},{"name":"date_from","in":"query","required":false,"schema":{"type":"string"},"description":"Listed date lower bound, YYYY-MM-DD"},{"name":"date_to","in":"query","required":false,"schema":{"type":"string"},"description":"Listed date upper bound, YYYY-MM-DD"},{"name":"country","in":"query","required":false,"schema":{"type":"string"},"description":"Country filter"},{"name":"is_china","in":"query","required":false,"schema":{"type":"boolean"},"description":"China-related filter"}],"responses":{"200":{"description":"Keyword search response","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/entities/hybrid-search":{"get":{"tags":["Entities"],"summary":"Hybrid keyword and semantic sanctions screening","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"},"description":"Screening query, minimum 2 characters"},{"name":"mode","in":"query","required":false,"schema":{"type":"string"},"description":"hybrid, keyword or semantic"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"},"description":"Page size, max 100"},{"name":"jurisdiction","in":"query","required":false,"schema":{"type":"string"},"description":"Jurisdiction filter"},{"name":"country","in":"query","required":false,"schema":{"type":"string"},"description":"Country filter"},{"name":"is_china","in":"query","required":false,"schema":{"type":"boolean"},"description":"China-related filter"}],"responses":{"200":{"description":"Hybrid search response","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/entities/{id}":{"get":{"tags":["Entities"],"summary":"Get sanctions entity detail","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Entity identifier"}],"responses":{"200":{"description":"Entity detail response","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/stats":{"get":{"tags":["Analytics"],"summary":"Get sanctions database statistics","responses":{"200":{"description":"Statistics response","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/reports":{"get":{"tags":["Reports"],"summary":"List or fetch published daily sanctions reports","parameters":[{"name":"date","in":"query","required":false,"schema":{"type":"string"},"description":"Optional report date, YYYY-MM-DD"}],"responses":{"200":{"description":"Report list or report content response","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}