Identity Verification
Revoke Identity
Revoke an on-chain identity verification
POST
/
customers
/
api
/
identity
/
revoke
curl -X POST "https://api.trusset.org/customers/api/identity/revoke" \
-H "Content-Type: application/json" \
-H "X-API-Key: trusset_abc123xy_secret..." \
-d '{ "walletAddress": "0xAbC123dEf456789012345678901234567890AbCd" }'
const response = await fetch(
'https://api.trusset.org/customers/api/identity/revoke',
{
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': 'trusset_abc123xy_secret...'
},
body: JSON.stringify({
walletAddress: '0xAbC123dEf456789012345678901234567890AbCd'
})
}
);
const { data } = await response.json();
{
"success": true,
"data": {
"action": "SIGN_TRANSACTION",
"transaction": {
"to": "0x5B3c9D1e7F2a4B6c8D0e2F4a6B8c0D2e4F6a8B0c",
"data": "0x7b1e9c40..."
},
"functionName": "revokeIdentity",
"description": "Revoke 0xabc123def456789012345678901234567890abcd on the identity registry",
"walletAddress": "0xabc123def456789012345678901234567890abcd",
"confirmWith": {
"endpoint": "POST /customers/api/identity/revoke",
"field": "txHash"
}
},
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2025-06-15T12:00:00.000Z"
}
}
{
"success": true,
"data": {
"walletAddress": "0xabc123def456789012345678901234567890abcd",
"status": "revoked",
"txHash": "0xabc123def456789012345678901234567890abc123def456789012345678901234",
"gasUsed": "42150"
},
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2025-06-15T12:00:00.000Z"
}
}
Revokes a previously verified identity on-chain and marks the off-chain customer record
revoked. Use this when a customer fails ongoing compliance checks or when their verification must be invalidated.
Call it once without txHash to get the calldata, and again with txHash once you have broadcast it. The record is updated on the second call.
Request Body
string
required
Ethereum wallet address to revoke.
string
Hash of the transaction you broadcast. Send it to confirm the revocation and update the record. Omit it to receive the calldata.
Response Fields
object
Show child attributes
Show child attributes
string
SIGN_TRANSACTION. Returned when txHash is omitted.object
to (the identity registry) and data. Returned when txHash is omitted.string
Always
revokeIdentity. Returned when txHash is omitted.object
Where to send the hash once broadcast, as
endpoint and field. Returned when txHash is omitted.string
Checksummed address.
string
Always
revoked. Returned when confirming with txHash.string
The confirmed transaction hash. Returned when confirming with
txHash.string
Gas consumed. Returned when confirming with
txHash.Confirmation checks that the transaction called
revokeIdentity on the address you named. A receipt that revokes a different address is rejected and no record changes.curl -X POST "https://api.trusset.org/customers/api/identity/revoke" \
-H "Content-Type: application/json" \
-H "X-API-Key: trusset_abc123xy_secret..." \
-d '{ "walletAddress": "0xAbC123dEf456789012345678901234567890AbCd" }'
const response = await fetch(
'https://api.trusset.org/customers/api/identity/revoke',
{
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': 'trusset_abc123xy_secret...'
},
body: JSON.stringify({
walletAddress: '0xAbC123dEf456789012345678901234567890AbCd'
})
}
);
const { data } = await response.json();
{
"success": true,
"data": {
"action": "SIGN_TRANSACTION",
"transaction": {
"to": "0x5B3c9D1e7F2a4B6c8D0e2F4a6B8c0D2e4F6a8B0c",
"data": "0x7b1e9c40..."
},
"functionName": "revokeIdentity",
"description": "Revoke 0xabc123def456789012345678901234567890abcd on the identity registry",
"walletAddress": "0xabc123def456789012345678901234567890abcd",
"confirmWith": {
"endpoint": "POST /customers/api/identity/revoke",
"field": "txHash"
}
},
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2025-06-15T12:00:00.000Z"
}
}
{
"success": true,
"data": {
"walletAddress": "0xabc123def456789012345678901234567890abcd",
"status": "revoked",
"txHash": "0xabc123def456789012345678901234567890abc123def456789012345678901234",
"gasUsed": "42150"
},
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2025-06-15T12:00:00.000Z"
}
}
⌘I
curl -X POST "https://api.trusset.org/customers/api/identity/revoke" \
-H "Content-Type: application/json" \
-H "X-API-Key: trusset_abc123xy_secret..." \
-d '{ "walletAddress": "0xAbC123dEf456789012345678901234567890AbCd" }'
const response = await fetch(
'https://api.trusset.org/customers/api/identity/revoke',
{
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': 'trusset_abc123xy_secret...'
},
body: JSON.stringify({
walletAddress: '0xAbC123dEf456789012345678901234567890AbCd'
})
}
);
const { data } = await response.json();
{
"success": true,
"data": {
"action": "SIGN_TRANSACTION",
"transaction": {
"to": "0x5B3c9D1e7F2a4B6c8D0e2F4a6B8c0D2e4F6a8B0c",
"data": "0x7b1e9c40..."
},
"functionName": "revokeIdentity",
"description": "Revoke 0xabc123def456789012345678901234567890abcd on the identity registry",
"walletAddress": "0xabc123def456789012345678901234567890abcd",
"confirmWith": {
"endpoint": "POST /customers/api/identity/revoke",
"field": "txHash"
}
},
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2025-06-15T12:00:00.000Z"
}
}
{
"success": true,
"data": {
"walletAddress": "0xabc123def456789012345678901234567890abcd",
"status": "revoked",
"txHash": "0xabc123def456789012345678901234567890abc123def456789012345678901234",
"gasUsed": "42150"
},
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2025-06-15T12:00:00.000Z"
}
}