Tenant management

The tenant management page gives platform administrators a central view of every tenant on the platform. You can search, filter, sort, and take action on tenants — including approving new signups, suspending accounts, and drilling into individual tenant details.

​

Tenant list

Navigate to Tenants in the platform sidebar. The page displays a paginated table of all tenants with the following columns:

​

Filtering and sorting

Use the toolbar above the table to narrow results:

• Search — filter by tenant name or ID.
• Status — filter by Active, Suspended, Pending, Trial, or Onboarding.
• Plan — filter by subscription tier.
• Region — filter by data residency region (US, EU, AF, AP).
• Created — filter by signup date range (last 7, 30, or 90 days).

Click any column header to sort ascending or descending.

​

Bulk actions

Select multiple tenants using the checkboxes and apply bulk status changes — for example, suspending or activating several tenants at once. You can also export the filtered list as a CSV file by clicking Export.

​

Creating a tenant

Click New Tenant to open the creation form. Provide:

• Name and slug — the tenant’s display name and URL-safe identifier.
• Type — Business, Government, or Individual.
• Country — primary jurisdiction for data residency.
• Plan — the subscription tier to assign.
• Contact email — the tenant’s primary contact.

The new tenant is created in Pending status and must be approved before it becomes active.

​

Tenant detail

Click any tenant row to open the detail page. The detail view has a tabbed layout with nine sections:

​

Overview

The overview tab shows the tenant’s core information:

• Status badge — current lifecycle status with a color indicator.
• Stat cards — counts for users, organizations, issuers, and API keys.
• Metadata — slug, type, contact email, region, jurisdiction, plan, and creation date.
• Data residency — current region with options to lock, unlock, or override the residency region.

Platform admins can edit tenant fields inline by clicking the edit icon. Editable fields include name, slug, type, country, jurisdiction, contact email, plan, region, and resource limits (max users, issuers, and API keys).

​

Tenant actions

A toolbar on the overview tab provides lifecycle actions:

​

Users

Lists all users in the tenant with their email, role, MFA status, and last login date. Use the search bar to find a specific user.

​

API keys

Shows all API keys issued to the tenant, including key prefix, scopes, status, creation date, and last usage timestamp.

​

Webhooks

Displays configured webhook endpoints with their target URL, subscribed event types, status, and creation date.

​

Activity

A reverse-chronological log of all actions performed within the tenant. Each entry shows the action type, actor, resource, and timestamp. Use the search field to filter activity by keyword.

​

Billing

Shows the tenant’s subscription details and financial health:

• Subscription status — current plan, billing period, and whether the subscription is active, past due, or canceled.
• Payment provider — which gateway processes the tenant’s payments (Stripe, Paystack, or Flutterwave).
• MRR contribution — the tenant’s monthly recurring revenue.
• Dunning state — whether the tenant is in a grace period due to a failed payment, and the current feature mode.
• Usage metrics — attestation mints, verifications, and API calls for the current billing period.

Billing administrators can override grace periods and adjust entitlements directly from this tab using the Override controls. This is useful when a tenant needs temporary access during a billing dispute or when onboarding under a custom agreement.

​

Notes

Internal notes attached to the tenant by platform staff. Notes have a type — internal, compliance, billing, or support — shown as a color-coded badge. You can add new notes, edit existing ones, pin important notes to the top of the list, and delete notes you no longer need.

​

Issuers

Lists all issuers belonging to the tenant with their name, status, trust tier, risk rating, and assurance level. Platform admins can suspend or reinstate individual issuers directly from this tab.

​

Compliance

Opens the compliance review panel for the tenant. You can request compliance documentation, review submitted evidence, and update the tenant’s compliance status.

​

Next steps