Identity Verification
Identity Status
Query both on-chain and off-chain identity status for a wallet
GET
/
customers
/
api
/
identity
/
status
/
{walletAddress}
curl "https://api.trusset.org/customers/api/identity/status/0xAbC123dEf456789012345678901234567890AbCd" \
-H "X-API-Key: trusset_abc123xy_secret..."
const address = '0xAbC123dEf456789012345678901234567890AbCd';
const response = await fetch(
`https://api.trusset.org/customers/api/identity/status/${address}`,
{ headers: { 'X-API-Key': 'trusset_abc123xy_secret...' } }
);
const { data } = await response.json();
if (data.onChain && !data.offChain) {
console.warn('On-chain record exists but no off-chain customer found');
}
{
"success": true,
"data": {
"walletAddress": "0xAbC123dEf456789012345678901234567890AbCd",
"onChain": {
"verified": true,
"kycHash": "0xdeadbeef...",
"investorType": 1,
"softExpiry": 1750000000,
"hardExpiry": 1780000000
},
"offChain": {
"status": "verified",
"country": "DE",
"investorType": "PROFESSIONAL",
"verifiedAt": "2025-03-01T10:00:00.000Z"
}
},
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2025-06-15T12:00:00.000Z"
}
}
{
"success": true,
"data": {
"walletAddress": "0x1234567890abcdef1234567890abcdef12345678",
"onChain": null,
"offChain": null
},
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2025-06-15T12:00:00.000Z"
}
}
Returns the current identity state from two sources: the on-chain identity registry and the off-chain customer database. This dual view lets you detect discrepancies between chain state and your records.
Path Parameters
string
required
Ethereum wallet address to query.
Response Fields
boolean
Request status
object
Show child attributes
Show child attributes
string
Checksummed address
object
Identity data read directly from the on-chain registry contract. Structure depends on the contract implementation. Returns
null if no on-chain record exists.curl "https://api.trusset.org/customers/api/identity/status/0xAbC123dEf456789012345678901234567890AbCd" \
-H "X-API-Key: trusset_abc123xy_secret..."
const address = '0xAbC123dEf456789012345678901234567890AbCd';
const response = await fetch(
`https://api.trusset.org/customers/api/identity/status/${address}`,
{ headers: { 'X-API-Key': 'trusset_abc123xy_secret...' } }
);
const { data } = await response.json();
if (data.onChain && !data.offChain) {
console.warn('On-chain record exists but no off-chain customer found');
}
{
"success": true,
"data": {
"walletAddress": "0xAbC123dEf456789012345678901234567890AbCd",
"onChain": {
"verified": true,
"kycHash": "0xdeadbeef...",
"investorType": 1,
"softExpiry": 1750000000,
"hardExpiry": 1780000000
},
"offChain": {
"status": "verified",
"country": "DE",
"investorType": "PROFESSIONAL",
"verifiedAt": "2025-03-01T10:00:00.000Z"
}
},
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2025-06-15T12:00:00.000Z"
}
}
{
"success": true,
"data": {
"walletAddress": "0x1234567890abcdef1234567890abcdef12345678",
"onChain": null,
"offChain": null
},
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2025-06-15T12:00:00.000Z"
}
}
⌘I
curl "https://api.trusset.org/customers/api/identity/status/0xAbC123dEf456789012345678901234567890AbCd" \
-H "X-API-Key: trusset_abc123xy_secret..."
const address = '0xAbC123dEf456789012345678901234567890AbCd';
const response = await fetch(
`https://api.trusset.org/customers/api/identity/status/${address}`,
{ headers: { 'X-API-Key': 'trusset_abc123xy_secret...' } }
);
const { data } = await response.json();
if (data.onChain && !data.offChain) {
console.warn('On-chain record exists but no off-chain customer found');
}
{
"success": true,
"data": {
"walletAddress": "0xAbC123dEf456789012345678901234567890AbCd",
"onChain": {
"verified": true,
"kycHash": "0xdeadbeef...",
"investorType": 1,
"softExpiry": 1750000000,
"hardExpiry": 1780000000
},
"offChain": {
"status": "verified",
"country": "DE",
"investorType": "PROFESSIONAL",
"verifiedAt": "2025-03-01T10:00:00.000Z"
}
},
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2025-06-15T12:00:00.000Z"
}
}
{
"success": true,
"data": {
"walletAddress": "0x1234567890abcdef1234567890abcdef12345678",
"onChain": null,
"offChain": null
},
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2025-06-15T12:00:00.000Z"
}
}