Screen an address for AML
Superseded by POST /apiv2/screening. This operation keeps working and will not be withdrawn without notice, but new integrations should use the version 2 contract: one response shape for every provider and every state of the order, decimal numbers as strings, and a single error format.
Submits an address for AML screening and returns the risk score, risk level and exposure analysis.
All timestamps in the response are UTC. The string format is unchanged.
It works in two modes. With wait: true the response waits for the result for up to 15 seconds. Without it the response returns immediately with status pending and a client_order_id, and the result is fetched through GET /aml/{order_id}. A typical check takes 2–10 seconds, and polling is not charged extra.
The Elliptic score runs from 0 to 10, where 0 means no risk. A null value means no triggers were detected.
Authorizations
API key from the dashboard. Some Host Mode endpoints also accept the key as an api_key field in the request body — this is stated in the schema of the particular operation.
Request Body
Responses
The check was accepted (pending) or completed (completed) — read data.status. application/json: schema: { $ref: '#/components/schemas/AmlCheckResponse' } examples: pending: summary: 'Accepted, fetch the result by polling' value: success: true data: client_order_id: A4C666ABE24BD4A status: pending address: TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE provider: elliptic price_usdt: 0.98 price_trx: 4.136286 currency: TRX message: AML check order accepted. Use GET /apiv2/aml/A4C666ABE24BD4A to check status. timestamp: '2026-03-10 09:56:31' completed: summary: 'Completed' value: success: true data: client_order_id: A019540900E55CA status: completed address: TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE provider: elliptic report_language: en risk_score: 0.802904 risk_level: low is_sanctioned: true created_at: '2026-03-10 15:56:28' completed_at: '2026-03-10 15:56:28' timestamp: '2026-03-10 15:56:31'