Retrieve KYW history
List saved wallet classifications and retrieve an existing check by ID.
Every completed KYW check is stored as an AML search-history record. Save the fresh response's id or auditLogId; both identify the same saved check. Use history when you need the evidence behind an earlier decision.
List saved checks
curl --get 'https://api-dev.cryptoswift.eu/kyw/history' \ --header "X-Api-Key: $API_KEY" \ --data-urlencode 'offset=0' \ --data-urlencode 'limit=10'
{
"items": [
{
"id": "0f59b0db-3c42-4f2f-9a1f-35c6ccbc4f46",
"tenantId": 123,
"objectType": "wallet",
"checkType": "kyw",
"objectId": "0x742d35cc6634c0532925a3b844bc454e4438f44e",
"blockchain": "Ethereum",
"queryData": {
"address": "0x742d35cc6634c0532925a3b844bc454e4438f44e",
"blockchain": "Ethereum"
},
"walletType": "CUSTODIAL",
"confidenceScore": "HIGH",
"isVerified": true,
"attributionReason": "Blockchain analytics identified the wallet owner as Example Exchange.",
"riskScore": 18,
"riskScorePayload": 18,
"matchResultData": {
"walletType": "CUSTODIAL",
"confidenceScore": 75,
"confidence": "HIGH",
"isVerified": true,
"attributionReasonCode": "DETECTED_VIA_BLOCKCHAIN_ANALYTICS",
"attributionReason": "Blockchain analytics identified the wallet owner as Example Exchange.",
"entityId": "14f4fb9d-4c69-5843-8b18-dbb77540182b",
"entityName": "Example Exchange",
"entityType": "exchange",
"agenticBehaviour": {
"detected": true,
"confidenceScore": 35,
"confidence": "MEDIUM",
"isVerified": false,
"attributionReason": "Wallet shows automated behaviour including high transaction frequency.",
"attributionReasonCode": "DETECTED_VIA_BEHAVIORAL_ANALYSIS"
},
"agenticAnalysis": null
},
"vaspEntityId": "14f4fb9d-4c69-5843-8b18-dbb77540182b",
"walletId": null,
"walletVerificationId": null,
"createdAt": "2026-11-11T09:00:00.000Z",
"provider": null,
"vaspName": "Example Exchange",
"vaspType": "exchange",
"amount": null,
"asset": null
}
],
"total": 1
}
The list response is an object with items and total, not a bare array. It lists the authenticated tenant's latest saved entry for each wallet/blockchain combination, newest first. Retrieve an older saved check directly by its ID. offset defaults to 0 and limit defaults to 10. Advance the offset by your page size to request the next page. These endpoints use offset and limit, unlike the Transactions API's _start and _end controls.
Retrieve one saved check
curl --location 'https://api-dev.cryptoswift.eu/kyw/history/{historyId}' \
--header "X-Api-Key: $API_KEY"
{
"id": "0f59b0db-3c42-4f2f-9a1f-35c6ccbc4f46",
"tenantId": 123,
"objectType": "wallet",
"checkType": "kyw",
"objectId": "0x742d35cc6634c0532925a3b844bc454e4438f44e",
"blockchain": "Ethereum",
"queryData": {
"address": "0x742d35cc6634c0532925a3b844bc454e4438f44e",
"blockchain": "Ethereum"
},
"walletType": "CUSTODIAL",
"confidenceScore": "HIGH",
"isVerified": true,
"attributionReason": "Blockchain analytics identified the wallet owner as Example Exchange.",
"riskScore": 18,
"riskScorePayload": 18,
"matchResultData": {
"walletType": "CUSTODIAL",
"confidenceScore": 75,
"confidence": "HIGH",
"isVerified": true,
"attributionReasonCode": "DETECTED_VIA_BLOCKCHAIN_ANALYTICS",
"attributionReason": "Blockchain analytics identified the wallet owner as Example Exchange.",
"entityId": "14f4fb9d-4c69-5843-8b18-dbb77540182b",
"entityName": "Example Exchange",
"entityType": "exchange",
"agenticBehaviour": {
"detected": true,
"confidenceScore": 35,
"confidence": "MEDIUM",
"isVerified": false,
"attributionReason": "Wallet shows automated behaviour including high transaction frequency.",
"attributionReasonCode": "DETECTED_VIA_BEHAVIORAL_ANALYSIS"
},
"agenticAnalysis": null
},
"vaspEntityId": "14f4fb9d-4c69-5843-8b18-dbb77540182b",
"walletId": null,
"walletVerificationId": null,
"createdAt": "2026-11-11T09:00:00.000Z",
"provider": null,
"vaspName": "Example Exchange",
"vaspType": "exchange",
"amount": null,
"asset": null
}
The endpoint returns 404 if that history record does not exist for the authenticated tenant. History reads return stored evidence and do not perform a fresh wallet check or contact an external provider.
The response is a history record, not the same response shape as a fresh GET /kyw/{blockchain}/{address} request. It contains fields such as id, checkType, objectId, blockchain, createdAt, and saved result data such as matchResultData. Consult the Get KYW history record endpoint (Sandbox) for the full schema.
If your policy requires a current classification, run a new KYW check and store its new ID. A saved historical result should not be presented as a new check.