Skip to content
Authrim

List tenants.

GET
/api/admin/tenants
Code sample: Shell / cURL 
curl --request GET \
  --url https://auth.example.com/api/admin/tenants \
  --header 'Authorization: Bearer <token>'

List tenants visible to the authenticated platform administrator or tenant inventory scope. This platform inventory endpoint does not use X-Tenant-Id because the tenant scope comes from the administrator authorization context.

Authorizations

Section titled “Authorizations ”

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Tenant inventory response.

Media type application/json
object
tenants
required
Array<object>

Tenant inventory row returned by list and detail endpoints, including provisioning metadata derived from the tenant D1 pool when that mode is enabled.

object
id
required
string
tenant_code
required
string
name
required
string
description
required
string | null
lifecycle_state
required
string
Allowed values: provisioning active suspended frozen migration_read_only deleting deleted restore_pending restore_validating
is_default
required
boolean
created_at
required

Unix timestamp in seconds.

integer format: int64
updated_at
required

Unix timestamp in seconds.

integer format: int64
provisioning_status
required
string
Allowed values: active inactive provisioning_failed
provisioning_error
required
string | null
provisioning_slot_id
required
string | null
provisioning_updated_at
required

Unix timestamp in seconds when provisioning metadata was last updated.

integer | null format: int64
key
additional properties
total
required
integer
tenant_d1_pool
required
object
enabled
required
boolean
capacity
integer
available_slots
integer
reserved_slots
integer
assigned_slots
integer
pending_binding_slots
integer
unavailable_slots
integer
reset_required_slots
integer
key
additional properties
single_tenant_mode
required
boolean
single_tenant_reason
required
string | null
key
additional properties
Example 
{
  "tenants": [
    {
      "id": "default",
      "tenant_code": "default",
      "name": "Default Tenant",
      "description": "Primary tenant.",
      "lifecycle_state": "active",
      "is_default": true,
      "created_at": 1770000000,
      "updated_at": 1770000000,
      "provisioning_status": "active",
      "provisioning_error": null,
      "provisioning_slot_id": null,
      "provisioning_updated_at": null
    },
    {
      "id": "acme",
      "tenant_code": "acme",
      "name": "Acme Corp",
      "description": "Production tenant for Acme Corp.",
      "lifecycle_state": "active",
      "is_default": false,
      "created_at": 1770003600,
      "updated_at": 1770003600,
      "provisioning_status": "active",
      "provisioning_error": null,
      "provisioning_slot_id": null,
      "provisioning_updated_at": null
    }
  ],
  "total": 2,
  "tenant_d1_pool": {
    "enabled": true,
    "capacity": 24,
    "available_slots": 8,
    "reserved_slots": 0,
    "assigned_slots": 16,
    "pending_binding_slots": 0,
    "unavailable_slots": 0,
    "reset_required_slots": 0
  },
  "single_tenant_mode": false,
  "single_tenant_reason": null
}