KYC Sources
Remove KYC Source
End a source for good
DELETE
/
customers
/
api
/
kyc-sources
/
{sourceId}
curl -X DELETE "https://api.trusset.org/customers/api/kyc-sources/cmhw2a6r10003l80c9d4h1n8v" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
`https://api.trusset.org/customers/api/kyc-sources/${sourceId}`,
{ method: 'DELETE', headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
{
"success": true,
"data": {
"source": {
"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": "REVOKED",
"tokenHint": "----",
"tokenIssuedAt": "2026-11-09T08:31:02.118Z",
"lastDeliveryAt": "2026-11-12T09:14:09.204Z",
"createdAt": "2026-11-09T08:31:02.118Z",
"counts": { "received": 0, "opened": 1, "approved": 12 }
}
},
"error": null,
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2027-03-01T16:44:03.915Z"
}
}
Removes a KYC source. Its status becomes
The records the source delivered are kept. A removed source’s name and signing key are free to use for a new source. Removing a source that is already removed answers with the source unchanged.
REVOKED, its token stops working, and every call to its inbox answers 401 UNAUTHORIZED from then on. The source stays in List KYC Sources with its records.
Removal is final. A removed source cannot be changed, invited again or made active. To stop deliveries for a while, set
status: PAUSED with Update KYC Source instead.A removed source can no longer revoke the records it delivered, because its inbox is closed. Its whitelists also stop being bound to it: Set Whitelist Members no longer asks for a record on a list that only this source was bound to, unless the instance that keeps the list bound a source of its own. Its records no longer count on any whitelist: approving one of them is the decision only and builds no listing. Wallets already listed stay listed until you remove them.Path Parameters
The source
id from List KYC Sources.Response Fields
Show child attributes
Show child attributes
The removal is written to the customer audit log as
KYC_SOURCE_REVOKED.curl -X DELETE "https://api.trusset.org/customers/api/kyc-sources/cmhw2a6r10003l80c9d4h1n8v" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
`https://api.trusset.org/customers/api/kyc-sources/${sourceId}`,
{ method: 'DELETE', headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
{
"success": true,
"data": {
"source": {
"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": "REVOKED",
"tokenHint": "----",
"tokenIssuedAt": "2026-11-09T08:31:02.118Z",
"lastDeliveryAt": "2026-11-12T09:14:09.204Z",
"createdAt": "2026-11-09T08:31:02.118Z",
"counts": { "received": 0, "opened": 1, "approved": 12 }
}
},
"error": null,
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2027-03-01T16:44:03.915Z"
}
}
Error Codes
| Code | HTTP | Cause |
|---|---|---|
SOURCE_NOT_FOUND | 404 | No KYC source with this ID belongs to your instance |
RATE_LIMIT_EXCEEDED | 429 | Your instance went over its budget of 20 KYC source writes per minute |
REMOVE_KYC_SOURCE_FAILED | 500 | The source could not be removed |
⌘I
curl -X DELETE "https://api.trusset.org/customers/api/kyc-sources/cmhw2a6r10003l80c9d4h1n8v" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
`https://api.trusset.org/customers/api/kyc-sources/${sourceId}`,
{ method: 'DELETE', headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
{
"success": true,
"data": {
"source": {
"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": "REVOKED",
"tokenHint": "----",
"tokenIssuedAt": "2026-11-09T08:31:02.118Z",
"lastDeliveryAt": "2026-11-12T09:14:09.204Z",
"createdAt": "2026-11-09T08:31:02.118Z",
"counts": { "received": 0, "opened": 1, "approved": 12 }
}
},
"error": null,
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2027-03-01T16:44:03.915Z"
}
}
