Sealed KYC Records
Confirm Record Admission
Record the mined transaction that listed a record wallet on a whitelist
POST
/
customers
/
api
/
kyc-records
/
{recordId}
/
admission
/
confirm
curl -X POST "https://api.trusset.org/customers/api/kyc-records/cmhw3k9t20007l80c5q2x7m4d/admission/confirm" \
-H "X-API-Key: trusset_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"listId": "cmv2k8q1d0004l70a3n6p2w9e",
"txHash": "0x4c1f8a6e2d9b07c35e8a1f4d6b2c90e7a3d5f18c6b4e2a09d7c1f3e5b8a6d204"
}'
const res = await fetch(
`https://api.trusset.org/customers/api/kyc-records/${recordId}/admission/confirm`,
{
method: 'POST',
headers: { 'X-API-Key': 'trusset_your_key_here', 'Content-Type': 'application/json' },
body: JSON.stringify({ listId: admission.listId, txHash: tx.hash })
}
);
const { success, data, error } = await res.json();
if (!success && error.code === 'TX_NOT_FOUND') {
// Not mined yet. Wait for one confirmation and confirm again.
}
{
"success": true,
"data": {
"record": {
"id": "cmhw3k9t20007l80c5q2x7m4d",
"envelopeId": "75aa6ca04ca5ab4223136c3bea128de0",
"sourceId": "cmhw2a6r10003l80c9d4h1n8v",
"sourceName": "Hanse Haftungsdach GmbH",
"walletAddress": "0x8ba1f109551bD432803012645Ac136ddd64DBA72",
"profileKey": "PROFESSIONAL",
"status": "APPROVED",
"recordDigest": "565dd632e69c3630319efbd08052d5fd1dfbdd5b1123b31e227502261fae5b9d",
"recipientKeyId": "b9619d9be69ed903",
"verifiedAt": "2026-11-10T00:00:00.000Z",
"validUntil": "2027-11-10T23:59:59.999Z",
"issuedAt": "2026-11-12T09:14:07.512Z",
"receivedAt": "2026-11-12T09:14:09.204Z",
"openedAt": "2026-11-12T09:40:31.870Z",
"approvedAt": "2026-11-12T10:15:02.336Z",
"rejectedAt": null,
"rejectReason": null,
"revokedAt": null,
"revokeReason": null,
"expiredAt": null,
"customerId": "cmhw3m2p40009l80c1r6t8y3b",
"sealedBytes": 240964,
"held": false,
"lists": [
{
"listId": "cmv2k8q1d0004l70a3n6p2w9e",
"name": "Depositors Q4",
"address": "0x7d31e6b09a4c25f8e1b73d0a6c94e2f58b1a0c37",
"listed": true
}
],
"action": null
},
"confirmation": {
"list": {
"id": "cmv2k8q1d0004l70a3n6p2w9e",
"name": "Depositors Q4",
"purpose": "DEPOSITOR",
"address": "0x7d31e6b09a4c25f8e1b73d0a6c94e2f58b1a0c37",
"ownerWallet": "0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52",
"pendingOwnerWallet": null,
"managers": [],
"memberCount": 148,
"archived": false,
"createdTxHash": "0x3f6c0e7a91d24b58c06e1f9a7b3d25e48c17a0f9d63e2b51a84c7f0e9d16b23a",
"createdBlock": 9384120,
"syncedBlock": 9611408,
"createdAt": "2026-10-08T14:02:11.000Z",
"updatedAt": "2026-11-12T10:19:27.000Z",
"own": true
},
"applied": 1,
"skipped": 0,
"events": 1,
"listedCount": 1,
"removedCount": 0,
"txHash": "0x4c1f8a6e2d9b07c35e8a1f4d6b2c90e7a3d5f18c6b4e2a09d7c1f3e5b8a6d204",
"signedBy": "0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52"
}
},
"error": null,
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2026-11-12T10:19:27.305Z"
}
}
Verifies the mined
The confirm call can also return any transaction verification error.
setListed transaction that Approve KYC Record returned for one whitelist, and records that the record’s wallet is listed. Confirm once per whitelist, each with its own transaction hash.
What the confirm reads
The record must beAPPROVED, and listId must be a whitelist bound to the record’s source. The transaction is then verified the same way Confirm Whitelist Members verifies it: it must be mined and successful, and every wallet it listed or removed is read from the list’s AccountListed events and written to the whitelist’s record.
After that the whitelist’s record must hold this record’s wallet as listed. When it does not, because the transaction listed other wallets only, the call is refused with TX_DID_NOT_LIST_WALLET. What the transaction did change on the list stays recorded.
The wallet passes every gate the list serves from the moment the transaction mines, whether or not it is confirmed here. The confirm keeps the record’s lists[].listed and action in step with the chain.
Path Parameters
The record
id from List KYC Records.Body Parameters
The whitelist the transaction was sent to:
admissions[].listId from Approve KYC Record.Response Fields
Show child attributes
Show child attributes
What the transaction changed on the list, with the fields of Confirm Whitelist Members:
list, applied, skipped, events, listedCount, removedCount, txHash and signedBy.The admission is written to the customer audit log as
KYC_RECORD_ADMITTED, with the whitelist, the transaction and the wallet that signed it.curl -X POST "https://api.trusset.org/customers/api/kyc-records/cmhw3k9t20007l80c5q2x7m4d/admission/confirm" \
-H "X-API-Key: trusset_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"listId": "cmv2k8q1d0004l70a3n6p2w9e",
"txHash": "0x4c1f8a6e2d9b07c35e8a1f4d6b2c90e7a3d5f18c6b4e2a09d7c1f3e5b8a6d204"
}'
const res = await fetch(
`https://api.trusset.org/customers/api/kyc-records/${recordId}/admission/confirm`,
{
method: 'POST',
headers: { 'X-API-Key': 'trusset_your_key_here', 'Content-Type': 'application/json' },
body: JSON.stringify({ listId: admission.listId, txHash: tx.hash })
}
);
const { success, data, error } = await res.json();
if (!success && error.code === 'TX_NOT_FOUND') {
// Not mined yet. Wait for one confirmation and confirm again.
}
{
"success": true,
"data": {
"record": {
"id": "cmhw3k9t20007l80c5q2x7m4d",
"envelopeId": "75aa6ca04ca5ab4223136c3bea128de0",
"sourceId": "cmhw2a6r10003l80c9d4h1n8v",
"sourceName": "Hanse Haftungsdach GmbH",
"walletAddress": "0x8ba1f109551bD432803012645Ac136ddd64DBA72",
"profileKey": "PROFESSIONAL",
"status": "APPROVED",
"recordDigest": "565dd632e69c3630319efbd08052d5fd1dfbdd5b1123b31e227502261fae5b9d",
"recipientKeyId": "b9619d9be69ed903",
"verifiedAt": "2026-11-10T00:00:00.000Z",
"validUntil": "2027-11-10T23:59:59.999Z",
"issuedAt": "2026-11-12T09:14:07.512Z",
"receivedAt": "2026-11-12T09:14:09.204Z",
"openedAt": "2026-11-12T09:40:31.870Z",
"approvedAt": "2026-11-12T10:15:02.336Z",
"rejectedAt": null,
"rejectReason": null,
"revokedAt": null,
"revokeReason": null,
"expiredAt": null,
"customerId": "cmhw3m2p40009l80c1r6t8y3b",
"sealedBytes": 240964,
"held": false,
"lists": [
{
"listId": "cmv2k8q1d0004l70a3n6p2w9e",
"name": "Depositors Q4",
"address": "0x7d31e6b09a4c25f8e1b73d0a6c94e2f58b1a0c37",
"listed": true
}
],
"action": null
},
"confirmation": {
"list": {
"id": "cmv2k8q1d0004l70a3n6p2w9e",
"name": "Depositors Q4",
"purpose": "DEPOSITOR",
"address": "0x7d31e6b09a4c25f8e1b73d0a6c94e2f58b1a0c37",
"ownerWallet": "0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52",
"pendingOwnerWallet": null,
"managers": [],
"memberCount": 148,
"archived": false,
"createdTxHash": "0x3f6c0e7a91d24b58c06e1f9a7b3d25e48c17a0f9d63e2b51a84c7f0e9d16b23a",
"createdBlock": 9384120,
"syncedBlock": 9611408,
"createdAt": "2026-10-08T14:02:11.000Z",
"updatedAt": "2026-11-12T10:19:27.000Z",
"own": true
},
"applied": 1,
"skipped": 0,
"events": 1,
"listedCount": 1,
"removedCount": 0,
"txHash": "0x4c1f8a6e2d9b07c35e8a1f4d6b2c90e7a3d5f18c6b4e2a09d7c1f3e5b8a6d204",
"signedBy": "0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52"
}
},
"error": null,
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2026-11-12T10:19:27.305Z"
}
}
Error Codes
| Code | HTTP | Cause |
|---|---|---|
ACCESS_LIST_NOT_BOUND | 400 | listId is missing or is not a whitelist bound to the record’s source. details.field is listId |
INVALID_TX | 400 | txHash is missing or is not 0x followed by 64 hex characters |
TX_REVERTED | 400 | The transaction was mined but reverted |
TX_WRONG_TARGET | 400 | The transaction neither called this whitelist nor emitted an AccountListed event from it |
TX_WRONG_FUNCTION | 400 | The transaction called this whitelist with a function other than setListed |
TX_NOT_VERIFIED | 400 | The transaction listed or removed no wallet on this whitelist |
TX_DID_NOT_LIST_WALLET | 400 | The transaction did not list this record’s wallet on the whitelist. details.txHash is the transaction |
TX_NOT_FOUND | 404 | No receipt yet. The transaction is unmined, dropped, or on another network. Wait for one confirmation and confirm again |
RECORD_NOT_FOUND | 404 | No KYC record with this ID belongs to your instance |
INSTANCE_NOT_FOUND | 404 | The instance behind your key is archived or no longer exists |
ACCESS_LIST_NOT_FOUND | 404 | The whitelist is no longer kept or managed by your instance on this network |
RECORD_NOT_APPROVED | 409 | The record is not APPROVED. details.status is its status |
RATE_LIMIT_EXCEEDED | 429 | Your instance went over its budget of 120 KYC record writes per minute |
CONFIRM_KYC_ADMISSION_FAILED | 500 | The admission could not be recorded |
ACCESS_LISTS_NOT_CONFIGURED | 501 | The whitelist factory is not deployed on your instance’s network |
ACCESS_LIST_UNREADABLE | 503 | The list belongs to another instance and whether your wallets still manage it could not be read. Retry shortly |
⌘I
curl -X POST "https://api.trusset.org/customers/api/kyc-records/cmhw3k9t20007l80c5q2x7m4d/admission/confirm" \
-H "X-API-Key: trusset_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"listId": "cmv2k8q1d0004l70a3n6p2w9e",
"txHash": "0x4c1f8a6e2d9b07c35e8a1f4d6b2c90e7a3d5f18c6b4e2a09d7c1f3e5b8a6d204"
}'
const res = await fetch(
`https://api.trusset.org/customers/api/kyc-records/${recordId}/admission/confirm`,
{
method: 'POST',
headers: { 'X-API-Key': 'trusset_your_key_here', 'Content-Type': 'application/json' },
body: JSON.stringify({ listId: admission.listId, txHash: tx.hash })
}
);
const { success, data, error } = await res.json();
if (!success && error.code === 'TX_NOT_FOUND') {
// Not mined yet. Wait for one confirmation and confirm again.
}
{
"success": true,
"data": {
"record": {
"id": "cmhw3k9t20007l80c5q2x7m4d",
"envelopeId": "75aa6ca04ca5ab4223136c3bea128de0",
"sourceId": "cmhw2a6r10003l80c9d4h1n8v",
"sourceName": "Hanse Haftungsdach GmbH",
"walletAddress": "0x8ba1f109551bD432803012645Ac136ddd64DBA72",
"profileKey": "PROFESSIONAL",
"status": "APPROVED",
"recordDigest": "565dd632e69c3630319efbd08052d5fd1dfbdd5b1123b31e227502261fae5b9d",
"recipientKeyId": "b9619d9be69ed903",
"verifiedAt": "2026-11-10T00:00:00.000Z",
"validUntil": "2027-11-10T23:59:59.999Z",
"issuedAt": "2026-11-12T09:14:07.512Z",
"receivedAt": "2026-11-12T09:14:09.204Z",
"openedAt": "2026-11-12T09:40:31.870Z",
"approvedAt": "2026-11-12T10:15:02.336Z",
"rejectedAt": null,
"rejectReason": null,
"revokedAt": null,
"revokeReason": null,
"expiredAt": null,
"customerId": "cmhw3m2p40009l80c1r6t8y3b",
"sealedBytes": 240964,
"held": false,
"lists": [
{
"listId": "cmv2k8q1d0004l70a3n6p2w9e",
"name": "Depositors Q4",
"address": "0x7d31e6b09a4c25f8e1b73d0a6c94e2f58b1a0c37",
"listed": true
}
],
"action": null
},
"confirmation": {
"list": {
"id": "cmv2k8q1d0004l70a3n6p2w9e",
"name": "Depositors Q4",
"purpose": "DEPOSITOR",
"address": "0x7d31e6b09a4c25f8e1b73d0a6c94e2f58b1a0c37",
"ownerWallet": "0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52",
"pendingOwnerWallet": null,
"managers": [],
"memberCount": 148,
"archived": false,
"createdTxHash": "0x3f6c0e7a91d24b58c06e1f9a7b3d25e48c17a0f9d63e2b51a84c7f0e9d16b23a",
"createdBlock": 9384120,
"syncedBlock": 9611408,
"createdAt": "2026-10-08T14:02:11.000Z",
"updatedAt": "2026-11-12T10:19:27.000Z",
"own": true
},
"applied": 1,
"skipped": 0,
"events": 1,
"listedCount": 1,
"removedCount": 0,
"txHash": "0x4c1f8a6e2d9b07c35e8a1f4d6b2c90e7a3d5f18c6b4e2a09d7c1f3e5b8a6d204",
"signedBy": "0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52"
}
},
"error": null,
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2026-11-12T10:19:27.305Z"
}
}
