Developer portal
GET /admin/tenants
Paginated tenant directory with usage signals for ops search and export.
GET /admin/tenantsAuth: admin
Summary
Paginated tenant directory with usage signals for ops search and export.
Pagination: limit and offset
Example
Response
{
"status": "success",
"total": 2,
"limit": 50,
"offset": 0,
"tenants": [
{
"tenantId": "acme-bank",
"name": "Acme Bank",
"tier": "monitor",
"memberCount": 5,
"scansThisMonth": 12,
"scheduleCount": 1,
"assessPaid": false,
"orgType": "customer",
"lastScanAt": "2026-06-18T14:22:00Z",
"createdAt": "2026-05-01T09:00:00Z"
}
]
}Try it live
Paste your tenant API key to call the live API with your credentials. Leave blank to use the public sandbox key when configured, or click “Show example response” for the static fixture below.
Query parameters
| Field | Type | Required | Description |
|---|---|---|---|
| search | string | No | Filter by tenant ID or name. |
| tier | string | No | Filter by subscription tier. |
| limit | number | No (50) | Page size (1–200). |
| offset | number | No (0) | Pagination offset. |
Errors
| Code | Meaning | Typical cause | Suggested fix |
|---|---|---|---|
| 404 | Not found | Scan, schedule, share link, or resource id does not exist or expired. | Verify id and tenant scope; share links expire per expiresHours. |
| 422 | Unprocessable entity | Invalid payload shape, unsupported scenario, or infeasible constraints. | Fix field errors in response detail; relax constraints and retry. |
| 429 | Too many requests | Per-key rate limit exceeded (default 300 requests per minute) or public endpoint limit. | Backoff with jitter; cache results; request higher limit for production. |
| 500 | Internal server error | Unexpected backend failure; includes requestId in response. | Retry with exponential backoff; contact support with requestId if persistent. |
See the full errors reference.
Found an issue? Report documentation feedback