KYC Sources
List KYC Sources
The verifiers your instance accepts sealed KYC records from
GET
/
customers
/
api
/
kyc-sources
curl "https://api.trusset.org/customers/api/kyc-sources" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch('https://api.trusset.org/customers/api/kyc-sources', {
headers: { 'X-API-Key': 'trusset_your_key_here' }
});
const { data } = await res.json();
const active = data.sources.filter((source) => source.status === 'ACTIVE');
{
"success": true,
"data": {
"sources": [
{
"id": "cmhw2a6r10003l80c9d4h1n8v",
"name": "Hanse Haftungsdach GmbH",
"signingKey": "c201dc3ced8549ad4e07400a868d9fd043a8d316e7141989c33e8f2f5f844fd6",
"signingKeyFingerprint": "4b37 6734 b088 268b 89d3 cf6d 1a88 0a1c",
"profileKey": "PROFESSIONAL",
"accessLists": [
{
"id": "cmv2k8q1d0004l70a3n6p2w9e",
"name": "Depositors Q4",
"address": "0x7d31e6b09a4c25f8e1b73d0a6c94e2f58b1a0c37"
}
],
"status": "ACTIVE",
"tokenHint": "Qml8",
"tokenIssuedAt": "2026-11-09T08:31:02.118Z",
"lastDeliveryAt": "2026-11-12T09:14:09.204Z",
"createdAt": "2026-11-09T08:31:02.118Z",
"counts": { "received": 3, "opened": 1, "approved": 12 }
}
],
"recipientKey": {
"keyId": "b9619d9be69ed903",
"publicKey": "d523432543eb506e3fbe5538bc2409ab97d016a8a8823ef0a7d416ac60967033",
"fingerprint": "b961 9d9b e69e d903 c31c 6f1a f3c6 a7d2"
}
},
"error": null,
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2026-11-12T09:20:00.000Z"
}
}
Returns the KYC sources of your instance, newest first, with the record key they seal to. A KYC source is a verifier you designate, for example the liability umbrella that verified an investor at the time of investment. It delivers the KYC file of a wallet as a sealed envelope through its inbox. See Sealed KYC records.
Up to 200 sources are returned, removed ones included.
status | Meaning |
|---|---|
ACTIVE | The source can deliver and revoke records |
PAUSED | Deliveries are refused with 403 SOURCE_PAUSED. The source can still read its inbox and delivery status, and revoke records |
REVOKED | Removed with Remove KYC Source. Its token no longer works. Final |
Response Fields
Show child attributes
Show child attributes
Show child attributes
Show child attributes
The verification profile the source verifies for. A delivery under another profile key is refused.
The whitelists bound to the source, each
{ id, name, address }. Approve KYC Record returns the listing transaction for each of them. Empty when none is bound.The last 4 characters of the source’s current token, or
---- for a removed source. The token itself is shown only inside the invite.curl "https://api.trusset.org/customers/api/kyc-sources" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch('https://api.trusset.org/customers/api/kyc-sources', {
headers: { 'X-API-Key': 'trusset_your_key_here' }
});
const { data } = await res.json();
const active = data.sources.filter((source) => source.status === 'ACTIVE');
{
"success": true,
"data": {
"sources": [
{
"id": "cmhw2a6r10003l80c9d4h1n8v",
"name": "Hanse Haftungsdach GmbH",
"signingKey": "c201dc3ced8549ad4e07400a868d9fd043a8d316e7141989c33e8f2f5f844fd6",
"signingKeyFingerprint": "4b37 6734 b088 268b 89d3 cf6d 1a88 0a1c",
"profileKey": "PROFESSIONAL",
"accessLists": [
{
"id": "cmv2k8q1d0004l70a3n6p2w9e",
"name": "Depositors Q4",
"address": "0x7d31e6b09a4c25f8e1b73d0a6c94e2f58b1a0c37"
}
],
"status": "ACTIVE",
"tokenHint": "Qml8",
"tokenIssuedAt": "2026-11-09T08:31:02.118Z",
"lastDeliveryAt": "2026-11-12T09:14:09.204Z",
"createdAt": "2026-11-09T08:31:02.118Z",
"counts": { "received": 3, "opened": 1, "approved": 12 }
}
],
"recipientKey": {
"keyId": "b9619d9be69ed903",
"publicKey": "d523432543eb506e3fbe5538bc2409ab97d016a8a8823ef0a7d416ac60967033",
"fingerprint": "b961 9d9b e69e d903 c31c 6f1a f3c6 a7d2"
}
},
"error": null,
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2026-11-12T09:20:00.000Z"
}
}
Error Codes
| Code | HTTP | Cause |
|---|---|---|
RATE_LIMIT_EXCEEDED | 429 | Your instance went over its budget of 120 KYC source reads per minute. See Rate limits |
LIST_KYC_SOURCES_FAILED | 500 | The sources could not be read |
⌘I
curl "https://api.trusset.org/customers/api/kyc-sources" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch('https://api.trusset.org/customers/api/kyc-sources', {
headers: { 'X-API-Key': 'trusset_your_key_here' }
});
const { data } = await res.json();
const active = data.sources.filter((source) => source.status === 'ACTIVE');
{
"success": true,
"data": {
"sources": [
{
"id": "cmhw2a6r10003l80c9d4h1n8v",
"name": "Hanse Haftungsdach GmbH",
"signingKey": "c201dc3ced8549ad4e07400a868d9fd043a8d316e7141989c33e8f2f5f844fd6",
"signingKeyFingerprint": "4b37 6734 b088 268b 89d3 cf6d 1a88 0a1c",
"profileKey": "PROFESSIONAL",
"accessLists": [
{
"id": "cmv2k8q1d0004l70a3n6p2w9e",
"name": "Depositors Q4",
"address": "0x7d31e6b09a4c25f8e1b73d0a6c94e2f58b1a0c37"
}
],
"status": "ACTIVE",
"tokenHint": "Qml8",
"tokenIssuedAt": "2026-11-09T08:31:02.118Z",
"lastDeliveryAt": "2026-11-12T09:14:09.204Z",
"createdAt": "2026-11-09T08:31:02.118Z",
"counts": { "received": 3, "opened": 1, "approved": 12 }
}
],
"recipientKey": {
"keyId": "b9619d9be69ed903",
"publicKey": "d523432543eb506e3fbe5538bc2409ab97d016a8a8823ef0a7d416ac60967033",
"fingerprint": "b961 9d9b e69e d903 c31c 6f1a f3c6 a7d2"
}
},
"error": null,
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2026-11-12T09:20:00.000Z"
}
}
