Skip to main content
Every request includes X-Tenant-Id to identify which of your customers the request is for: 
X-Tenant-Id: <your_customer_id>
Tenants are created automatically on first request. No pre-registration needed. Billing happens at the integrator level (your organization), not per-tenant.

​
What tenants provide

  • Data isolation: Scores, criteria, and question sets scoped per tenant
  • Per-customer metrics: Usage, success rates, and costs broken down by customer
  • Queryability: Filter API responses and reports by tenant

​
Choosing a tenant ID

Use a stable, unique identifier that won’t change: your internal customer/account ID, a UUID, or their unique slug. Avoid: customer names, email addresses, or sequential integers.
Sandbox and production have separate tenant namespaces. The same tenant ID in sandbox vs production points to different isolated data stores.