Batch

POSThttps://api.sanctionslookup.com/v1/screen/batch

POST /v1/screen/batch checks many subjects in one call. Each entry is the same object as a single screen. The response puts one object per subject in results. Lists and the score threshold are on Request.

{
  "subjects": [
    { "name": "Kim Yong Un", "subject_ref": "customer_123", "type": "INDIVIDUAL" },
    { "name": "Rosneft", "subject_ref": "vendor_456", "type": "ENTITY" }
  ],
  "options": {
    "min_score": 80,
    "max_results": 10,
    "sources": ["ofac_sdn", "uk_sanc"]
  }
}

Fields

FieldTypeRequirementDescription
subjectsarray of objectsrequired1 to 50 subjects. Each entry is validated at /subjects/0, /subjects/1, and so on. Mix types in one call.
optionsobjectoptionalSame object as a single screen. One options applies to every subject in the call.