Sealed KYC Records
Get KYC Record
One sealed KYC record with its state and whitelists
GET
/
customers
/
api
/
kyc-records
/
{recordId}
curl "https://api.trusset.org/customers/api/kyc-records/cmhw3k9t20007l80c5q2x7m4d" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
`https://api.trusset.org/customers/api/kyc-records/${recordId}`,
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
if (data.record.action === 'APPROVE') {
// The file is in your records folder. Review it, then approve or reject.
}
{
"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
}
},
"error": null,
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2026-11-12T10:21:44.000Z"
}
}
Returns one sealed KYC record: its clear header fields, its status, the whitelists bound to its source and the next step that is yours. The KYC file itself is not returned. While the record is
RECEIVED, Download Envelope returns its ciphertext.
Path Parameters
The record
id from List KYC Records, or the recordId of a customer.kyc_record_received event.Response Fields
Show child attributes
Show child attributes
The record, with the fields described on List KYC Records.
curl "https://api.trusset.org/customers/api/kyc-records/cmhw3k9t20007l80c5q2x7m4d" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
`https://api.trusset.org/customers/api/kyc-records/${recordId}`,
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
if (data.record.action === 'APPROVE') {
// The file is in your records folder. Review it, then approve or reject.
}
{
"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
}
},
"error": null,
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2026-11-12T10:21:44.000Z"
}
}
Error Codes
| Code | HTTP | Cause |
|---|---|---|
RECORD_NOT_FOUND | 404 | No KYC record with this ID belongs to your instance |
RATE_LIMIT_EXCEEDED | 429 | Your instance went over its budget of 240 KYC record reads per minute |
GET_KYC_RECORD_FAILED | 500 | The record could not be read |
⌘I
curl "https://api.trusset.org/customers/api/kyc-records/cmhw3k9t20007l80c5q2x7m4d" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
`https://api.trusset.org/customers/api/kyc-records/${recordId}`,
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
if (data.record.action === 'APPROVE') {
// The file is in your records folder. Review it, then approve or reject.
}
{
"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
}
},
"error": null,
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2026-11-12T10:21:44.000Z"
}
}
