Environment Activation

Before you can submit data through the API, you need to provision an environment. PacSpace supports two environments:

• Sandbox (testnet) — For development and testing. No real costs.
• Production (mainnet) — For live data. Credits are consumed per verified delta.

All routes require a valid JWT in the Authorization header:

-H "Authorization: Bearer YOUR_JWT_TOKEN"

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

Provision an Environment#

Activate sandbox or production infrastructure for your tenant. This sets up the necessary backend resources to start processing verifications.

curl -X POST https://balance-api.pacspace.io/dashboard/contracts/provision \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "environment": "testnet"
  }'

Valid values for environment: testnet (sandbox) or mainnet (production).

Response 201 Created

{
  "statusCode": 201,
  "data": {
    "tenantId": "tnt_xyz789",
    "environment": "testnet",
    "status": "provisioning",
    "message": "Environment is being provisioned. This usually takes a few seconds."
  }
}

Provisioning is typically fast (under 30 seconds). Use the status endpoint below to confirm when it's ready.

Check Environment Status#

Check whether a specific environment has been provisioned and is ready to use.

curl https://balance-api.pacspace.io/dashboard/contracts/tnt_xyz789/status \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Response 200 OK

{
  "statusCode": 200,
  "data": {
    "tenantId": "tnt_xyz789",
    "environments": [
      {
        "environment": "testnet",
        "status": "active",
        "provisionedAt": "2025-06-01T12:00:05.000Z"
      },
      {
        "environment": "mainnet",
        "status": "not_provisioned"
      }
    ]
  }
}

Status Values#

List Environments#

Retrieve all provisioned environments for your tenant.

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

Response 200 OK

{
  "statusCode": 200,
  "data": [
    {
      "id": "ctr_abc123",
      "tenantId": "tnt_xyz789",
      "environment": "testnet",
      "status": "active",
      "provisionedAt": "2025-06-01T12:00:05.000Z"
    },
    {
      "id": "ctr_def456",
      "tenantId": "tnt_xyz789",
      "environment": "mainnet",
      "status": "active",
      "provisionedAt": "2025-06-15T09:00:10.000Z"
    }
  ]
}

Recommended Setup Flow#

1. Register an account and verify your email
2. Provision sandbox — POST /dashboard/contracts/provision with "environment": "testnet"
3. Create an API key — POST /dashboard/api-keys with "environment": "test"
4. Start building — use the sandbox API key to test writes and reads
5. Provision production — when ready, provision "environment": "mainnet"
6. Create a production API key — POST /dashboard/api-keys with "environment": "live"
7. Go live — switch your application to the production key

Endpoints Summary#