SEON user docs logoSEON user docs logoSEON user docs logo
Search input icon

AML Entity API

SEON's entity search allows you to run queries for organizations through the AML API to check if they are listed on any Sanctions or Watchlists so that you can be sure you’re not doing business with a dodgy entity. Learn more about entity search in our Knowledge Base.

Good to know:

  • Entity search is an API-only feature only available through the AML Entity API endpoint.
  • If you'd like to enable automatic monitoring for a name set monitoring_required to true in your request.
  • To receive notifications of any changes to an entity's status during AML monitoring, set up a webhook. Find out more about webhook notifications here.
  • AML screening is not fully automated, we recommend reviewing potential matches manually.
  • All SEON API requests are case-sensitive. Please follow the formatting below to avoid errors.

Request

 

Attributes

TypeRequired
config 
objectno
entity_id
stringno
entity_name
stringyes
entity_country
stringno

 

HTTP Endpoint

POST

https://api.seon.io/SeonRestService/aml-api/entity/v1
PHP
Generic
Generic

Response

JSON attributes

  
has_watchlist_match
boolean 
has_sanction_match
boolean 
result_payload
object 
Response
{
 "success": true,
 "error": {},
 "data": {
  "has_watchlist_match": false,
  "has_sanction_match": true,
  "result_payload": {
   "searched_at": "2022-10-28T12:51:15.170Z",
   "sanctionlist_sources": [
    {
     "source_name": "ofac-consolidated",
     "source_full_name": "Office of Foreign Assets Control",
     "source_version": "2022-06-21"
    }
   ],
   "watchlist_entries": [],
   "sanctionlist_entries": [
    {
     "found": "exact",
     "scores": {
      "relevancy_score": 0.585
     },
     "id": 24177,
     "name": "GAZPROM TRANSGAZ KRASNODAR, OOO",
     "addresses": [],
     "akas": [
      {
       "name": "GAZPROM TRANSGAZ KRASNODAR",
       "original": "",
       "type": "default"
      }
     ],
     "nationality": "",
     "country": "",
     "program": "UKRAINE-EO13662",
     "source": {
      "source_name": "bis",
      "source_full_name": "Sectoral Sanctions Identifications List (SSI) - Treasury Department",
      "source_version": "2022-10-27"
     },
     "attributes": [
      {
       "key": "remarks",
       "value": "For more information on directives, please visit the following link: http://www.treasury.gov/resource-center/sanctions/Programs/Pages/ukraine.aspx#directives; (Linked To: PUBLIC JOINT STOCK COMPANY GAZPROM)"
      },
      {
       "key": "id-Tax ID No",
       "value": "2308128945"
      }
     ],
     "birth_precision": "exact",
     "birth_date": "0",
     "birth_place": "",
     "mother_name": "",
     "id_number": "",
     "id_type": "",
     "first_seen": "2021-01-10T09:47:37.000Z",
     "last_seen": "2021-01-10T09:47:37.000Z"
    }
   ]
  }
 }
}