CryptoAmlAddressDetailsDto
Result type. Always WALLET for a wallet check.
Possible values: [WALLET, TRANSACTION]
WALLETIdentifier of the check (amlId). Use it to request the result again or to generate PDF reports.
Key of the client that owns the check.
Applicant the wallet is assigned to, if any.
Blockchain network of the wallet.
Possible values: [BTC, LTC, BSV, ETH, TRON, POLYGON, BNB, ARBITRUM, BASE, AVALANCHE, MOONBEAM, DOT, SOLANA, TON, CARDANO, WORLDCOIN]
Manual review decision for the wallet: UNKNOWN until a reviewer decides in Workplace, then APPROVED or REJECTED.
Possible values: [UNKNOWN, APPROVED, REJECTED]
State of the check. The result is ready when the state is FINISHED.
Possible values: [INITIAL, PROCESSING, FAILED, FINISHED]
Reason of the failure. Present only when state is FAILED.
The checked wallet address.
Risk score of the wallet, as returned by the AML provider.
Balance of the wallet at the time of the check, returned as a string to preserve precision.
uof object[]required
Uses of funds: where the funds of the wallet were sent. Items have forward: true.
Hash of the transaction through which the funds moved.
true for items of uof (funds sent onward from the checked wallet or transaction), false for items of sof (funds received from the source).
Name of the owner of the counterparty address, if identified (for example an exchange or a service).
Risk score of this source of funds or use of funds, as returned by the AML provider.
Category of the source or destination, for example the type of the entity that owns the counterparty address.
depth objectrequired
Number of hops between the checked wallet or transaction and this counterparty. Either a single number or a { minimum, maximum } range.
- number
- object
direct if the counterparty is one hop away, indirect if it is further, unclassified if the depth is unknown or is a range spanning both.
Possible values: [direct, indirect, unclassified]
Amount of funds attributed to this counterparty.
Counterparty address.
Share of the total funds attributed to this counterparty (percentage).
Number of transactions with this counterparty (if applicable).
true if the counterparty could not be identified (if applicable).
true if the counterparty is unknown to the AML provider (if applicable).
Amount expressed in the corresponding currency, as returned by the AML provider (if applicable).
Identifier of the address cluster the counterparty belongs to (if applicable).
Provider timestamp of the direct transaction with the counterparty (if applicable).
Timestamp of the funds movement (if applicable).
Category of the list the counterparty was matched against (if applicable).
Decimal representation of the amount (if applicable).
Hash of the direct transaction with the counterparty (if applicable).
Symbol of the asset the amount is expressed in (if applicable).
sof object[]required
Sources of funds: where the funds of the wallet came from. Items have forward: false.
Hash of the transaction through which the funds moved.
true for items of uof (funds sent onward from the checked wallet or transaction), false for items of sof (funds received from the source).
Name of the owner of the counterparty address, if identified (for example an exchange or a service).
Risk score of this source of funds or use of funds, as returned by the AML provider.
Category of the source or destination, for example the type of the entity that owns the counterparty address.
depth objectrequired
Number of hops between the checked wallet or transaction and this counterparty. Either a single number or a { minimum, maximum } range.
- number
- object
direct if the counterparty is one hop away, indirect if it is further, unclassified if the depth is unknown or is a range spanning both.
Possible values: [direct, indirect, unclassified]
Amount of funds attributed to this counterparty.
Counterparty address.
Share of the total funds attributed to this counterparty (percentage).
Number of transactions with this counterparty (if applicable).
true if the counterparty could not be identified (if applicable).
true if the counterparty is unknown to the AML provider (if applicable).
Amount expressed in the corresponding currency, as returned by the AML provider (if applicable).
Identifier of the address cluster the counterparty belongs to (if applicable).
Provider timestamp of the direct transaction with the counterparty (if applicable).
Timestamp of the funds movement (if applicable).
Category of the list the counterparty was matched against (if applicable).
Decimal representation of the amount (if applicable).
Hash of the direct transaction with the counterparty (if applicable).
Symbol of the asset the amount is expressed in (if applicable).
addressInfo objectrequired
Information about the address. The set of fields depends on the blockchain type: account-based, UTXO-based or EVM.
- CryptoAmlAccountAddressInfoDto
- CryptoAmlUtxoAddressInfoDto
- CryptoAmlEvmAddressInfoDto
The checked address.
Owner of the address, if identified.
Description of the address.
type objectrequired
Type of the address.
Identifier of the address type.
Name of the address type, for example the kind of service that owns the address.
Risk score associated with the address type.
Total number of transactions.
Number of received transactions.
Number of sent transactions.
Tags associated with the address.
balance objectrequired
Balance of the address.
Balance amount, returned as a string to preserve precision.
Price of the asset at the time of the check.
Timestamp when the price was recorded.
Symbol of the asset.
Timestamp when the address was first seen.
Timestamp when the address was last seen.
Number of parent addresses.
Number of native parent addresses.
Kind of the address: address for a regular account or contract for a smart contract.
Flag returned by the AML provider indicating conflicting data for this address.
Total number of native-coin transactions.
Total number of internal transactions.
Total number of token transactions.
assets object[]required
Assets held by the address.
Whether the asset is supported by the AML provider.
Name of the asset.
Symbol of the asset.
Icon URL or identifier of the asset.
entities object[]required
Entities related to the wallet, for example exchanges or mixers.
Identifier of the entity.
Risk score of the entity.
Name of the risk type the score belongs to.
Name of the entity, for example an exchange or a service.
Identifier of the risk type the score belongs to.
sharesByType objectrequired
Share of funds by risk type, keyed by type name.
riskByType objectnullable
Risk score by risk type, keyed by type name.
Whether the wallet is under continuous AML monitoring.
Time the result was last updated.
true when a monitoring update changed the score after the last full check, so the stored details may be stale.
Whether the AML provider returned a report for this check.
Time the check was created.
timelines object[]nullablerequired
History of events of the check. null if there are none.
Identifier of the event.
Identifier of the request that caused the event.
Type of the event.
Possible values: [CRYPTO_AML_STATUS_UPDATED, CRYPTO_AML_EXPORTED_DATA, CRYPTO_CREATED_AML_COMMENT, CRYPTO_AML_MONITORING_DISABLED, CRYPTO_AML_MONITORING_ENABLED, CRYPTO_AML_START_PROCESS, CRYPTO_RETRIEVED_AML_RESULT, CRYPTO_RETRIEVED_AML_RESULT_ERROR, CRYPTO_AML_ASSIGNED_TO_APPLICANT, CRYPTO_AML_REFRESH_PROCESS, CRYPTO_AML_SCORE_UPDATED, CRYPTO_AML_PDF_REPORT_REQUESTED, CRYPTO_AML_PDF_REPORT_GENERATED, CRYPTO_AML_PDF_REPORT_FAILED]
Applicant the event is related to, if any.
Key of the Application the event is related to, if any.
data objectnullablerequired
Additional event data. The content depends on the event type.
Additional event data. The content depends on the event type.
Identifier of the check the event belongs to.
Identifier of the user who caused the event.
Device details of the request that caused the event.
Geolocation details of the request that caused the event.
Time the event was created.
Time the event was last updated.
comments object[]nullablerequired
Comments left on the check by reviewers. null if there are none.
Identifier of the comment.
Text of the comment.
Identifier of the check the comment belongs to.
Identifier of the user who wrote the comment.
Identifier of the parent comment when this comment is a reply.
Full name of the user who wrote the comment.
Time the comment was last updated.
Time the comment was created.
pdfReports object[]
PDF reports generated for this check. Returned only by GET /api/public/crypto-aml/{amlId}/details, not in the webhook.
Identifier of the report request. It is generated by the client when the report is requested.
Identifier of the check the report belongs to.
Type of the check: WALLET or TRANSACTION.
Possible values: [WALLET, TRANSACTION]
Status of the report generation: PENDING, then GENERATED or FAILED.
Possible values: [PENDING, GENERATED, FAILED]
Path of the generated file. Present only when status is GENERATED. Download it with GET /api/public/file/{path}.
error object
Error details. Present only when status is FAILED.
Error code.
Human readable error message.
AML snapshot used to generate this PDF
Time the report status was last updated.
Time the check was last updated.
{
"type": "WALLET",
"id": "string",
"clientKey": "string",
"applicantId": "string",
"blockchain": "BTC",
"reviewStatus": "UNKNOWN",
"state": "INITIAL",
"errReason": "string",
"address": "string",
"score": 0,
"amount": "string",
"uof": [
{
"hash": "string",
"forward": true,
"owner": "string",
"score": 0,
"type": "string",
"depth": 0,
"exposureType": "direct",
"amount": 0,
"address": "string",
"share": 0,
"transactionCount": 0,
"unidentified": true,
"unknown": true,
"amountCur": 0,
"cluster": 0,
"directStamp": 0,
"timestamp": 0,
"listType": "string",
"amountDec": 0,
"directTx": "string",
"symbol": "string"
}
],
"sof": [
{
"hash": "string",
"forward": true,
"owner": "string",
"score": 0,
"type": "string",
"depth": 0,
"exposureType": "direct",
"amount": 0,
"address": "string",
"share": 0,
"transactionCount": 0,
"unidentified": true,
"unknown": true,
"amountCur": 0,
"cluster": 0,
"directStamp": 0,
"timestamp": 0,
"listType": "string",
"amountDec": 0,
"directTx": "string",
"symbol": "string"
}
],
"addressInfo": {
"address": "string",
"owner": "string",
"description": "string",
"type": {
"id": "string",
"name": "string",
"score": 0
},
"txCount": 0,
"txReceivedCount": 0,
"txSentCount": 0,
"tags": [
"string"
],
"balance": {
"amount": "string",
"price": 0,
"priceTimestamp": 0,
"symbol": "string"
},
"firstSeen": 0,
"lastSeen": 0,
"parentCount": 0,
"parentNativeCount": 0,
"addressType": "string",
"conflict": true,
"totalETHTxs": 0,
"totalInternalTxs": 0,
"totalTokensTxs": 0,
"assets": [
{
"supported": true,
"name": "string",
"symbol": "string",
"icon": "string"
}
]
},
"entities": [
{
"id": "string",
"score": 0,
"scoreType": "string",
"name": "string",
"scoreTypeId": "string"
}
],
"sharesByType": {},
"riskByType": {},
"isMonitoring": true,
"lastUpdateDate": "2024-07-29T15:51:28.071Z",
"outdated": true,
"isReportReceived": true,
"createdAt": "2024-07-29T15:51:28.071Z",
"timelines": [
{
"id": "string",
"requestUniqueId": "string",
"eventName": "CRYPTO_AML_STATUS_UPDATED",
"applicantId": "string",
"appKey": "string",
"data": {},
"amlId": "string",
"userId": 0,
"device": {},
"geo": {},
"createdAt": "2024-07-29T15:51:28.071Z",
"updatedAt": "2024-07-29T15:51:28.071Z"
}
],
"comments": [
{
"id": "string",
"content": "string",
"amlId": "string",
"authorId": 0,
"parentId": "string",
"authorName": "string",
"updatedAt": "2024-07-29T15:51:28.071Z",
"createdAt": "2024-07-29T15:51:28.071Z"
}
],
"pdfReports": [
{
"requestId": "string",
"amlId": "string",
"type": "WALLET",
"status": "PENDING",
"path": "string",
"error": {
"code": "string",
"message": "string"
},
"sourceUpdatedAt": "2024-07-29T15:51:28.071Z",
"createdAt": "2024-07-29T15:51:28.071Z",
"updatedAt": "2024-07-29T15:51:28.071Z"
}
],
"updatedAt": "2024-07-29T15:51:28.071Z"
}