Skip to content

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": "monthly",
    "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
billingModestringBilling mode: monthly
environments.sandboxstringSandbox environment status
environments.productionstringProduction environment status
createdAtstringISO 8601 timestamp of account creation
updatedAtstringISO 8601 timestamp of last update

Delete Account

Permanently deactivate your account. This disables all API keys, webhooks, and integrations. Verification data (receipts, fingerprints, timestamps) is preserved permanently and cannot be deleted.

Requires typing your exact organization name to confirm.

bash
curl -X DELETE https://balance-api.pacspace.io/dashboard/tenant \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "confirmation": "Acme Inc"
  }'

Response 200 OK

json
{
  "statusCode": 200,
  "data": {
    "message": "Your account has been deleted. All API keys, webhooks, and integrations have been deactivated. Verification data is preserved permanently for audit purposes."
  }
}

What happens:

  • All users are deactivated
  • All API keys are disabled
  • All webhooks are disabled
  • All integrations are deactivated
  • Your billing plan is cancelled
  • Verification data remains permanently accessible

This action cannot be undone. If you need to restore a deleted account, contact support@pacspace.io.


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 — plan usage is tracked per tenant
  • Webhooks — events are delivered per tenant

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