Skip to content

Dashboard API

Tenant Information

Retrieve your organization details, tenant ID, and account status.

Every PacSpace account belongs to a tenant — your organization. Use this endpoint to retrieve your tenant details, including your unique tenant ID, company information, and account status.

Requires a valid JWT in the Authorization header:

bash
-H "Authorization: Bearer YOUR_JWT_TOKEN"

Base URL: https://balance-api.pacspace.io


Get Tenant Details

Retrieve your organization's tenant information.

bash
curl https://balance-api.pacspace.io/dashboard/tenant \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Response 200 OK

json
{
  "statusCode": 200,
  "data": {
    "id": "tnt_xyz789",
    "companyName": "Acme Inc",
    "status": "active",
    "billingMode": "credits",
    "environments": {
      "sandbox": "provisioned",
      "production": "provisioned"
    },
    "createdAt": "2025-01-15T10:30:00.000Z",
    "updatedAt": "2025-06-01T12:00:00.000Z"
  }
}

Response Fields

FieldTypeDescription
idstringYour unique tenant identifier (used in API calls)
companyNamestringYour registered organization name
statusstringAccount status: active, suspended, or pending
billingModestringCurrent billing mode: credits or monthly
environments.sandboxstringSandbox environment status
environments.productionstringProduction environment status
createdAtstringISO 8601 timestamp of account creation
updatedAtstringISO 8601 timestamp of last update

Where You'll Use the Tenant ID

Your tenantId appears in several places:

  • Environment provisioning — checking contract status for your tenant
  • API key scoping — keys are automatically scoped to your tenant
  • Billing — credit balances and usage are tracked per tenant
  • Webhooks — events are delivered per tenant

You can also find your tenant ID in the PacSpace Dashboard under Settings.

Was this page helpful?

Last updated February 11, 2026