KYC Sources
Reissue Source Invite
Issue a new invite for a source and end the old one
POST
/
customers
/
api
/
kyc-sources
/
{sourceId}
/
invite
curl -X POST "https://api.trusset.org/customers/api/kyc-sources/cmhw2a6r10003l80c9d4h1n8v/invite" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
`https://api.trusset.org/customers/api/kyc-sources/${sourceId}/invite`,
{ method: 'POST', 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": "ACTIVE",
"tokenHint": "x7Pw",
"tokenIssuedAt": "2026-11-14T13:05:48.662Z",
"lastDeliveryAt": "2026-11-12T09:14:09.204Z",
"createdAt": "2026-11-09T08:31:02.118Z",
"counts": { "received": 3, "opened": 1, "approved": 12 }
},
"invite": "trusset-kyc-invite:v1:eyJ2IjoxLCJhcGkiOiJodHRwczovL2FwaS50cnVzc2V0Lm9yZyIsInNvdXJjZUlkIjoi..."
},
"error": null,
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2026-11-14T13:05:48.690Z"
}
}
Issues a new invite for a KYC source. The new invite carries a new token, your current record key and the source’s current profile key. The request has no body.
Issue a new invite when:
The old token stops working at once. Until the verifier stores the new invite, its calls to the inbox answer
401 UNAUTHORIZED. Hand the new invite over through a confidential channel, as with the first one.- you replaced the record key with Set Record Key. The verifier’s tool pins the key from its invite and refuses to send while the inbox reports another one.
- you changed the source’s
profileKeywith Update KYC Source. - the invite may have reached someone other than the verifier.
trusset-kyc invite add --replace --fingerprint "<fingerprint>", with the fingerprint you read out from trusset-kyc key show over a separate channel.
Path Parameters
The source
id from List KYC Sources.Response Fields
Show child attributes
Show child attributes
The new invite. See The invite for its fields.
The response is sent with
Cache-Control: no-store. The call is written to the customer audit log as KYC_SOURCE_INVITE_ISSUED.curl -X POST "https://api.trusset.org/customers/api/kyc-sources/cmhw2a6r10003l80c9d4h1n8v/invite" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
`https://api.trusset.org/customers/api/kyc-sources/${sourceId}/invite`,
{ method: 'POST', 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": "ACTIVE",
"tokenHint": "x7Pw",
"tokenIssuedAt": "2026-11-14T13:05:48.662Z",
"lastDeliveryAt": "2026-11-12T09:14:09.204Z",
"createdAt": "2026-11-09T08:31:02.118Z",
"counts": { "received": 3, "opened": 1, "approved": 12 }
},
"invite": "trusset-kyc-invite:v1:eyJ2IjoxLCJhcGkiOiJodHRwczovL2FwaS50cnVzc2V0Lm9yZyIsInNvdXJjZUlkIjoi..."
},
"error": null,
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2026-11-14T13:05:48.690Z"
}
}
Error Codes
| Code | HTTP | Cause |
|---|---|---|
SOURCE_NOT_FOUND | 404 | No KYC source with this ID belongs to your instance |
INSTANCE_NOT_FOUND | 404 | The instance behind your key is archived or no longer exists |
SOURCE_REVOKED | 409 | The source was removed. Add a new source instead |
SEALED_KYC_NOT_ENABLED | 409 | Your instance is a production instance and sealed KYC records are not enabled for your organisation. See Availability |
RECIPIENT_KEY_NOT_SET | 409 | Your instance has no record key |
RATE_LIMIT_EXCEEDED | 429 | Your instance went over its budget of 20 KYC source writes per minute |
ISSUE_KYC_INVITE_FAILED | 500 | The invite could not be issued |
⌘I
curl -X POST "https://api.trusset.org/customers/api/kyc-sources/cmhw2a6r10003l80c9d4h1n8v/invite" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
`https://api.trusset.org/customers/api/kyc-sources/${sourceId}/invite`,
{ method: 'POST', 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": "ACTIVE",
"tokenHint": "x7Pw",
"tokenIssuedAt": "2026-11-14T13:05:48.662Z",
"lastDeliveryAt": "2026-11-12T09:14:09.204Z",
"createdAt": "2026-11-09T08:31:02.118Z",
"counts": { "received": 3, "opened": 1, "approved": 12 }
},
"invite": "trusset-kyc-invite:v1:eyJ2IjoxLCJhcGkiOiJodHRwczovL2FwaS50cnVzc2V0Lm9yZyIsInNvdXJjZUlkIjoi..."
},
"error": null,
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2026-11-14T13:05:48.690Z"
}
}
