Disclosure Requests
List Disclosure Requests
List the disclosure requests your instance has made
GET
/
customers
/
api
/
disclosure-requests
curl "https://api.trusset.org/customers/api/disclosure-requests?status=APPROVED&limit=20" \
-H "X-API-Key: trusset_your_key_here"
const params = new URLSearchParams({ status: 'APPROVED', limit: '20' });
const response = await fetch(
`https://api.trusset.org/customers/api/disclosure-requests?${params}`,
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await response.json();
const { items, pagination } = data;
{
"success": true,
"data": {
"items": [
{
"id": "cmg7q3v2k0004lq08h2z9x6de",
"walletAddress": "0x801D3b83882B1047fb2CeB6C097C3ae806D8D028",
"scope": "COUNTRY",
"scopeLabel": "Reveal country",
"referenceUrl": "https://acme-capital.example/onboarding/4711",
"message": "Please confirm your country of residence for your account opening",
"status": "APPROVED",
"environment": "DEV",
"createdAt": "2026-09-30T09:30:00.000Z",
"expiresAt": "2026-10-14T09:30:00.000Z",
"respondedAt": "2026-10-01T14:05:12.000Z",
"proofLevel": "ON_CHAIN_CLAIM"
}
],
"pagination": {
"total": 1,
"limit": 20,
"offset": 0
}
},
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2026-10-01T15:00:00.000Z"
}
}
Returns the disclosure requests your instance has made, newest first. Requests made in the Issuer Portal are included.
Before the list is read, every open request of your instance past its
expiresAt is marked EXPIRED, so the statuses are current. The items carry no consent or disclosure. Fetch an approved request with Get Disclosure Request to read them.
Query Parameters
Only requests to this wallet, matched in any case. Send it lowercase or correctly checksummed.
Requests per page, from 1 to 100. A missing, zero or non-numeric value gives 50, and a larger one is capped at 100.
Response Fields
Show child attributes
Show child attributes
The requests, each with the fields of Create Disclosure Request:
id, walletAddress, scope, scopeLabel, referenceUrl, message, status, environment, createdAt, expiresAt, respondedAt and proofLevel.Pagination sits inside
data here, unlike the lists under /manage and /id-links, which put total in metadata.curl "https://api.trusset.org/customers/api/disclosure-requests?status=APPROVED&limit=20" \
-H "X-API-Key: trusset_your_key_here"
const params = new URLSearchParams({ status: 'APPROVED', limit: '20' });
const response = await fetch(
`https://api.trusset.org/customers/api/disclosure-requests?${params}`,
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await response.json();
const { items, pagination } = data;
{
"success": true,
"data": {
"items": [
{
"id": "cmg7q3v2k0004lq08h2z9x6de",
"walletAddress": "0x801D3b83882B1047fb2CeB6C097C3ae806D8D028",
"scope": "COUNTRY",
"scopeLabel": "Reveal country",
"referenceUrl": "https://acme-capital.example/onboarding/4711",
"message": "Please confirm your country of residence for your account opening",
"status": "APPROVED",
"environment": "DEV",
"createdAt": "2026-09-30T09:30:00.000Z",
"expiresAt": "2026-10-14T09:30:00.000Z",
"respondedAt": "2026-10-01T14:05:12.000Z",
"proofLevel": "ON_CHAIN_CLAIM"
}
],
"pagination": {
"total": 1,
"limit": 20,
"offset": 0
}
},
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2026-10-01T15:00:00.000Z"
}
}
Error Codes
| Code | HTTP | Cause |
|---|---|---|
VALIDATION_ERROR | 400 | status is not one of the five states |
INVALID_ADDRESS | 400 | walletAddress is not 0x and 40 hex characters |
LIST_DISCLOSURE_REQUESTS_FAILED | 500 | The requests could not be read. A mixed-case walletAddress with a wrong checksum also ends here |
⌘I
curl "https://api.trusset.org/customers/api/disclosure-requests?status=APPROVED&limit=20" \
-H "X-API-Key: trusset_your_key_here"
const params = new URLSearchParams({ status: 'APPROVED', limit: '20' });
const response = await fetch(
`https://api.trusset.org/customers/api/disclosure-requests?${params}`,
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await response.json();
const { items, pagination } = data;
{
"success": true,
"data": {
"items": [
{
"id": "cmg7q3v2k0004lq08h2z9x6de",
"walletAddress": "0x801D3b83882B1047fb2CeB6C097C3ae806D8D028",
"scope": "COUNTRY",
"scopeLabel": "Reveal country",
"referenceUrl": "https://acme-capital.example/onboarding/4711",
"message": "Please confirm your country of residence for your account opening",
"status": "APPROVED",
"environment": "DEV",
"createdAt": "2026-09-30T09:30:00.000Z",
"expiresAt": "2026-10-14T09:30:00.000Z",
"respondedAt": "2026-10-01T14:05:12.000Z",
"proofLevel": "ON_CHAIN_CLAIM"
}
],
"pagination": {
"total": 1,
"limit": 20,
"offset": 0
}
},
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2026-10-01T15:00:00.000Z"
}
}
