Overview
The Bulk ABC Sanction List Solution enables corporate clients to screen multiple customer identities against the ABC Sanction List in a single request. This service supports high-volume compliance checks, ensuring efficient and secure validation of customer identities against sanctioned entities.
Prerequisites
To use the ABC Listing Inquiry service, you need to do the following:
- Register/Login to the anb Developer Portal.
- Create an app.
- You should now have a client id and secret associated with your app.
- Get an access token from our auth service using your client id and secret.
Acceptance Criteria
To use the ABC Listing Inquiry service, you need to do the following:
- Customers can submit bulk inquiries to check sanction status.
- Each request supports up to 99 identity records.
Request Body Structure
| Field for Mapping | Field in ExtABCListInqRq | Type | Length | Required |
|---|---|---|---|---|
| POI Number | /Body/POINum | String | 50 | Yes |
| poiType | /Body/POIType | String | 35 | Yes |
Sample as below:
| PoiNumber | PoiType |
|---|---|
| 1002231742 | National ID |
| 2050174478 | Commercial Registration Number |
| 7009357117 | Unified ID |
| 2552530053 | IQAMA |
POI Number refers to any valid customer ID such as National, Iqama,Family ID, Passport, or CR.
| Field in ExtABCListInqRs | Description | Type |
|---|---|---|
| /Body/POINum | Echoed proof of identity number | String |
| /Body/POIType | Identity type description from MB service | String |
| /Body/IsSanctioned | 'Y' if sanctioned, 'N' if not | String |
| /Body/IdDesc | ID description from MB service | String |
| Code | Message | Description |
|---|---|---|
| 400 | Invalid file format | File is not in accepted CSV format |
| 400 | Too many records | File contains more than 99 records |
| 401 | Unauthorized | Missing or invalid bearer token |
| 404 | Request ID not found | No results found for the provided request ID |
| 500 | Internal Server Error | Unexpected error during processing |
| Code | Description |
|---|---|
| E6500082 | Bulk ABC List inquiry file with id doesn't exist. |
| E6500083 | Records limit exceeded: Max 99 records allowed. |