{"openapi":"3.1.0","info":{"title":"Screen100 API","version":"1.0.0","description":"Screen people and companies against the OFAC SDN, OFAC Consolidated and UN Security Council sanctions lists.","contact":{"name":"Screen100","url":"https://screen100.com"}},"servers":[{"url":"https://screen100.com/api"}],"security":[{"ApiKeyAuth":[]}],"paths":{"/v1/screen":{"post":{"summary":"Screen a name","description":"Screen a single person or company name against all sanctions lists. Billable: 1 screen.","operationId":"screenEntity","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScreenRequest"},"example":{"name":"Ramzan Kadyrov","type":"individual"}}}},"responses":{"200":{"description":"Screening result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScreenResponse"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Quota or rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/batch":{"post":{"summary":"Batch screen (Pro)","description":"Screen up to 100 names in one request. Requires the Pro plan.","operationId":"batchScreen","security":[{"ApiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["names"],"properties":{"names":{"type":"array","items":{"type":"string"},"maxItems":100},"type":{"$ref":"#/components/schemas/EntityType"}}},"example":{"names":["Ramzan Kadyrov","Acme Trading LLC"]}}}},"responses":{"200":{"description":"Batch results"},"402":{"description":"Pro plan required"}}}},"/v1/entities/{slug}":{"get":{"summary":"Get an entity","description":"Fetch the full record for one listed entity. Public — no API key required.","operationId":"getEntity","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Entity record"},"404":{"description":"Not found"}}}},"/v1/watchlists":{"get":{"summary":"List watchlists","description":"The lists Screen100 searches, with counts and provenance. Public.","operationId":"listWatchlists","security":[],"responses":{"200":{"description":"Watchlists"}}}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"http","scheme":"bearer","description":"API key: `Authorization: Bearer sk_live_...`"}},"schemas":{"EntityType":{"type":"string","enum":["individual","entity","vessel","aircraft","any"]},"ScreenRequest":{"type":"object","required":["name"],"properties":{"name":{"type":"string","minLength":2,"maxLength":200},"type":{"$ref":"#/components/schemas/EntityType"},"min_score":{"type":"number","minimum":0.5,"maximum":1,"description":"Minimum match score to include (default 0.72)."},"limit":{"type":"integer","minimum":1,"maximum":100}}},"ScreenHit":{"type":"object","properties":{"entity_id":{"type":"string"},"matched_name":{"type":"string"},"name_type":{"type":"string"},"score":{"type":"number"},"entity_type":{"type":"string"},"primary_name":{"type":"string"},"programs":{"type":"array","items":{"type":"string"}},"source":{"type":"string"},"source_entry_id":{"type":"string"},"slug":{"type":"string"}}},"ScreenResponse":{"type":"object","properties":{"query":{"type":"string"},"type":{"$ref":"#/components/schemas/EntityType"},"result":{"type":"string","enum":["clear","possible_match","match"]},"hit_count":{"type":"integer"},"top_score":{"type":["number","null"]},"hits":{"type":"array","items":{"$ref":"#/components/schemas/ScreenHit"}},"lists_searched":{"type":"array","items":{"type":"string"}},"screened_at":{"type":"string","format":"date-time"},"request_id":{"type":"string"}}},"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs":{"type":"string"},"request_id":{"type":"string"}}}}}}}}