iAML API Hub
One platform. One API. Full support for AML and Compliance processes.
iAML API Hub is an integration module providing access to AML, KYC, KYB, Compliance Intelligence and risk assessment services through a unified API interface.
iAML API Hub provides access to proprietary PEP and RCA databases, over 75 sanction lists and other lists, as well as data from national and international sources through one consistent API.
iAML API Hub provides access to proprietary PEP and RCA databases, over 75 sanction lists and other lists, as well as data from national and international sources through one consistent API.
1. Available Services
Record Check (PDF)
Verification of a person or entity against a selected list, including PDF report generation.
Sanction Screening
Verification of persons and entities against sanction lists (75+).
PEP Screening
Identification of politically exposed persons (PEP) and their close associates (RCA).
Regulatory & Warning Lists
Verification of persons and entities against warning lists and other risk sources (KNF Warning List, EURO-BOZON, Virtual Currency Register, Gambling Domains Register, ERUP).
Beneficial Ownership Verification
Identification and analysis of ultimate beneficial owners and ownership structures (CRBR).
KYB Verification
Verification of company registration data, legal status, management and ownership structure (GUS BIR, CRBR, KRS, VAT White List, VIES).
Risk Intelligence
(Risk Matrix & Risk Score)
(Risk Matrix & Risk Score)
Support for risk assessment processes through automated risk analysis and scoring.
Ongoing Monitoring
Continuous monitoring of changes in sanctions, PEP status and other risk events.
2. Data Sources & Integrations
iAML API Hub integrates data from national public registers, compliance databases, sanction lists and proprietary sources.
2.1 Public Registers
GUS BIR – REGON Database
Access to business registration data, including:
- REGON
- NIP
- entity name
- legal form
- business address
- entity status
National Court Register (KRS)
Access to up-to-date data on entities registered in the National Court Register, including registration data, legal form, status, address, rules of representation and related persons.
Central Register of Beneficial Owners (CRBR)
Access to information on:
- beneficial owners,
- ownership structures,
- persons exercising control over the entity.
VAT White List
Verification of VAT taxpayer status and bank accounts reported to the tax administration.
VIES VAT Information Exchange System
Verification of EU VAT numbers within the European Commission system.
2.2 Compliance & AML Databases
PEP
Database of Politically Exposed Persons.
RCA
Database of Close Associates of PEPs.
Sanctions
Access to over 75 national and international sanction lists. Sources include, among others:
A detailed list of sanction lists is available in dedicated documentation.
- the European Union (EU)
- the United Nations (UN)
- OFAC (USA)
- the United Kingdom (UK)
- the Polish Sanction List
- other national and international sanction sources
A detailed list of sanction lists is available in dedicated documentation.
KNF Warning List
The official list of public warnings maintained by the Polish Financial Supervision Authority (KNF).
EURO-BOZON
European Database of Foreign Supervisory Authorities' Warnings. A source aggregating warnings published by foreign financial supervision authorities and regulatory institutions from multiple jurisdictions.
ERUP
The Electronic Register of Payment Services maintained by the Polish Financial Supervision Authority (KNF). It enables verification of entities authorised to provide payment services.
2.3 Risk Sources & Specialist Lists
High-Risk Countries
A proprietary database of high-risk countries and jurisdictions developed on the basis of FATF, European Commission and Ministry of Finance guidelines, as well as other regulatory sources. The database supports automated geographic risk assessment in AML and KYC processes.
High-Risk Industries
A proprietary database of business activities with elevated AML risk. The classification is based on the national AML/CFT risk assessment, the provisions of the AML Act and the guidelines of national and European regulators.
Virtual Currency Register
Register of entities conducting virtual currency activities, including crypto-asset exchange and custody of virtual currency wallets.
Gambling Domains Register
The official register of internet domains used to offer or promote gambling in breach of applicable regulations.
MiCA Register
A public database grouping crypto market entities and documents in line with the EU regulation. It allows checking whether an exchange or a crypto exchange office holds a CASP licence.
2.4 iAML Services
Record Check
An API for quickly checking any record (e.g. a person, organisation, domain, crypto wallet or other object) against selected iAML data sources.
Data Lookup
The service automatically retrieves and aggregates data on a person or entity based on a provided identifier, such as NIP, REGON, KRS, EU VAT or other input data. The information is enriched from available public registers and reference sources, creating a complete profile used in further verification processes.
Compliance Screening
The service performs comprehensive verification of a person or entity against the compliance databases available on the iAML platform. The analysis may cover PEP, RCA and sanction lists, warning lists, regulatory registers and proprietary risk sources. The result is a list of hits with detailed information about the sources.
Risk Engine
A configurable risk assessment engine that automatically calculates a risk level based on screening results and the risk matrix defined by the organisation. The result can be returned as a score, a risk level, a classification or a logical answer (YES/NO), in line with the adopted business rules.
Monitoring
The service provides continuous monitoring of persons and entities for changes in the compliance databases and data sources used by the iAML platform. When new hits or status changes are detected, the system can automatically generate notifications and alerts, and update the risk assessment.
3. Authentication
All API calls require authorisation.
Supported methods
API Key – HTTP header
Recommended. The key is passed in the X-Api-Key header.
API Key – query parameter
Alternatively, the key can be passed in the api_key query parameter.
4. Environments
Environment
Address
Production
https://api.aml.pl/v1
Sandbox
in preparation
5. Response Format
All responses are returned in JSON format. Data is returned under a key matching the resource (e.g. peps, rcas, sanctions, records), and error responses contain a message field with an optional errors list.
Example success response (200 OK) – GET /v1/risk?name=...:
{
"risk": {
"pl": "niskie",
"lvl": 0
}
}
Copy
Example error response (412 Precondition Failed):
{
"message": "Precondition Failed",
"errors": [
"Zapytanie nie moze być puste."
]
}
Copy
6. HTTP Response Codes
The API returns standard HTTP response codes.
Code
Description
200
Operation completed successfully
202
Request accepted – the resource is being prepared, retry the request (e.g. a PDF report)
400
Invalid input data
401
Missing authorisation (invalid API key)
403
Insufficient permissions or request limit exceeded
404
Resource not found
410
The resource has expired and is no longer available (e.g. a PDF report)
412
Parameter validation failed (message field with an errors list)
500
Server error
7. Security
iAML API Hub has been designed in accordance with security and data protection principles.
Key mechanisms include
TLS communication encryption
Secure API authentication
Access control
Operation logging
Security monitoring
Minimisation of processed data
8. Support
Technical support
Sales contact
Working hours
Mon–Fri, 8:00–16:00 CET
9. Platform Development
As part of further platform development, additional API modules are planned.
Ready
Analytics API
API for managing AML analyses, screening, monitoring and risk assessment of persons, entities and other objects.
In preparation
Data Hub API
API for sharing and downloading reference data, files and iAML data packages in various formats.
In preparation
Case Management API
API for creating, updating and managing cases, alerts and their handling process.
In preparation
Notification API
API for sending and managing system notifications, alerts and user communication.
Planned
Workflow Automation API
API for automating business processes, approvals, tasks and workflows in the iAML platform.
Planned
AI Compliance Services
A set of AI services supporting data analysis, risk assessment, recommendation generation and compliance process automation.
10. Legal Information
The functionalities, services and roadmap items described in this documentation may change as the iAML platform continues to evolve. The availability of individual services may depend on the licence scope, the purchased package and the terms of cooperation.