Management
List Customers
Retrieve customers for the authenticated instance
GET
/
customers
/
api
/
manage
curl "https://api.trusset.org/customers/api/manage?limit=20&search=acme" \
-H "X-API-Key: trusset_abc123xy_secret..."
const params = new URLSearchParams({ limit: '20', search: 'acme' });
const response = await fetch(
`https://api.trusset.org/customers/api/manage?${params}`,
{ headers: { 'X-API-Key': 'trusset_abc123xy_secret...' } }
);
const { data: customers, metadata } = await response.json();
{
"success": true,
"data": [
{
"id": "cmt0k3b9x0004cghxw7r2d5ya",
"instanceId": "cmrz4d1v20000cghx8k6p3m7t",
"issuerId": "cmrz3a8q10000cghxf5w2n9k4",
"walletAddress": "0xaBc123DEf456789012345678901234567890aBCD",
"externalId": "acme-001",
"name": "Acme Corp",
"country": "DEU",
"investorType": "PROFESSIONAL",
"customerType": "COMPANY",
"companyUrl": "https://acme.example/",
"companyId": null,
"status": "verified",
"frozen": false,
"kycHash": "0x5f1c2e8a9b7d4c3e2f1a0b9c8d7e6f5a4b3c2d1e0f9a8b7c6d5e4f3a2b1c0d9e",
"onChainTxHash": "0x8e2d41c7a9f03b56d1e8c4a27f90b3d65e1c8a4f27b90d3e6c1a85f42d97b0e3",
"sumsubApplicantId": null,
"idLinkId": null,
"referenceKey": null,
"contactChannels": [],
"metadata": null,
"archived": false,
"archivedAt": null,
"verifiedAt": "2026-09-01T10:00:00.000Z",
"revokedAt": null,
"onChainSyncedAt": null,
"createdAt": "2026-08-15T08:00:00.000Z",
"updatedAt": "2026-09-01T10:00:00.000Z",
"sumsubApplicant": null,
"company": null
}
],
"metadata": {
"total": 1,
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2026-09-30T12:00:00.000Z"
}
}
Returns a page of the customer records on your instance, newest first. By default, archived customers are excluded.
Query Parameters
string
Case-insensitive substring match on
walletAddress, name, externalId, referenceKey and companyUrl. Only primary wallets are searched. To find a customer by a linked wallet, use Get Customer.string
INDIVIDUAL or COMPANY to return only that type. Any other value is ignored.string
default:"false"
Set to
true to include archived customers in results.integer
default:"100"
Number of results per page. Values above 200 are capped at 200.
integer
default:"0"
Number of results to skip for pagination.
Response Fields
boolean
Request status
array
Customer records with the fields listed on Get Customer, without its linked wallets, members and audit entries. Each record adds two objects of its own.
object
curl "https://api.trusset.org/customers/api/manage?limit=20&search=acme" \
-H "X-API-Key: trusset_abc123xy_secret..."
const params = new URLSearchParams({ limit: '20', search: 'acme' });
const response = await fetch(
`https://api.trusset.org/customers/api/manage?${params}`,
{ headers: { 'X-API-Key': 'trusset_abc123xy_secret...' } }
);
const { data: customers, metadata } = await response.json();
{
"success": true,
"data": [
{
"id": "cmt0k3b9x0004cghxw7r2d5ya",
"instanceId": "cmrz4d1v20000cghx8k6p3m7t",
"issuerId": "cmrz3a8q10000cghxf5w2n9k4",
"walletAddress": "0xaBc123DEf456789012345678901234567890aBCD",
"externalId": "acme-001",
"name": "Acme Corp",
"country": "DEU",
"investorType": "PROFESSIONAL",
"customerType": "COMPANY",
"companyUrl": "https://acme.example/",
"companyId": null,
"status": "verified",
"frozen": false,
"kycHash": "0x5f1c2e8a9b7d4c3e2f1a0b9c8d7e6f5a4b3c2d1e0f9a8b7c6d5e4f3a2b1c0d9e",
"onChainTxHash": "0x8e2d41c7a9f03b56d1e8c4a27f90b3d65e1c8a4f27b90d3e6c1a85f42d97b0e3",
"sumsubApplicantId": null,
"idLinkId": null,
"referenceKey": null,
"contactChannels": [],
"metadata": null,
"archived": false,
"archivedAt": null,
"verifiedAt": "2026-09-01T10:00:00.000Z",
"revokedAt": null,
"onChainSyncedAt": null,
"createdAt": "2026-08-15T08:00:00.000Z",
"updatedAt": "2026-09-01T10:00:00.000Z",
"sumsubApplicant": null,
"company": null
}
],
"metadata": {
"total": 1,
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2026-09-30T12:00:00.000Z"
}
}
Error Codes
| Code | HTTP | Cause |
|---|---|---|
FETCH_FAILED | 500 | The records could not be read, including when limit or offset is not a number |
⌘I
curl "https://api.trusset.org/customers/api/manage?limit=20&search=acme" \
-H "X-API-Key: trusset_abc123xy_secret..."
const params = new URLSearchParams({ limit: '20', search: 'acme' });
const response = await fetch(
`https://api.trusset.org/customers/api/manage?${params}`,
{ headers: { 'X-API-Key': 'trusset_abc123xy_secret...' } }
);
const { data: customers, metadata } = await response.json();
{
"success": true,
"data": [
{
"id": "cmt0k3b9x0004cghxw7r2d5ya",
"instanceId": "cmrz4d1v20000cghx8k6p3m7t",
"issuerId": "cmrz3a8q10000cghxf5w2n9k4",
"walletAddress": "0xaBc123DEf456789012345678901234567890aBCD",
"externalId": "acme-001",
"name": "Acme Corp",
"country": "DEU",
"investorType": "PROFESSIONAL",
"customerType": "COMPANY",
"companyUrl": "https://acme.example/",
"companyId": null,
"status": "verified",
"frozen": false,
"kycHash": "0x5f1c2e8a9b7d4c3e2f1a0b9c8d7e6f5a4b3c2d1e0f9a8b7c6d5e4f3a2b1c0d9e",
"onChainTxHash": "0x8e2d41c7a9f03b56d1e8c4a27f90b3d65e1c8a4f27b90d3e6c1a85f42d97b0e3",
"sumsubApplicantId": null,
"idLinkId": null,
"referenceKey": null,
"contactChannels": [],
"metadata": null,
"archived": false,
"archivedAt": null,
"verifiedAt": "2026-09-01T10:00:00.000Z",
"revokedAt": null,
"onChainSyncedAt": null,
"createdAt": "2026-08-15T08:00:00.000Z",
"updatedAt": "2026-09-01T10:00:00.000Z",
"sumsubApplicant": null,
"company": null
}
],
"metadata": {
"total": 1,
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2026-09-30T12:00:00.000Z"
}
}