Billing & Usage

PacSpace uses a monthly subscription model. Each plan includes a set number of billable delta units per month. Use these endpoints to monitor your usage and plan details.

Protected routes require a valid dashboard session cookie (-b pacspace-dashboard-cookies.txt).

Base URL: https://app.pacspace.io

GET https://app.pacspace.io/dashboard/billing/plan

Get Plan#

Retrieve your current subscription plan details.

curl https://app.pacspace.io/dashboard/billing/plan \
  -b pacspace-dashboard-cookies.txt

Response 200 OK

{
  "statusCode": 200,
  "data": {
    "tier": "starter",
    "monthlyAllotment": 100000,
    "planPriceUsd": 3000,
    "overagePriceUsd": 0.012,
    "stripeSubscriptionId": "sub_1R...",
    "cancelAtPeriodEnd": false,
    "stripeCurrentPeriodEnd": "2026-03-13T00:00:00.000Z"
  }
}

Plan Fields#

Get Usage#

Retrieve your monthly usage and overage status for the current or a specified period.

curl https://app.pacspace.io/dashboard/billing/usage \
  -b pacspace-dashboard-cookies.txt

Optionally specify a period:

curl "https://app.pacspace.io/dashboard/billing/usage?period=2026-01" \
  -b pacspace-dashboard-cookies.txt

Query Parameters#

Response 200 OK

{
  "statusCode": 200,
  "data": {
    "period": "2026-02",
    "consumedDeltas": 1042,
    "overageCount": 0,
    "overageChargesUsd": 0,
    "remainingDeltas": 98958
  }
}

Usage Fields#

Monitoring Usage#

Via Webhooks#

Each delta.verified webhook event includes usage data when available:

{
  "event": "delta.verified",
  "data": {
    "usage": {
      "plan": "growth",
      "periodId": "2026-02",
      "includedDeltas": 500000,
      "consumedDeltas": 1042,
      "remainingDeltas": 498958,
      "overageRate": "$0.010/delta"
    }
  }
}

Set up a webhook endpoint to track consumption in real time.

Via Dashboard#

View your usage, billing history, and plan details at app.pacspace.io.

Subscribe to a Plan#

Start a new subscription for a self-serve tier (Pilot, Starter, Growth, or Scale). Returns a Stripe Checkout URL - redirect the user to complete payment.

curl -X POST https://app.pacspace.io/dashboard/stripe/create-subscription-session \
  -b pacspace-dashboard-cookies.txt \
  -H "Content-Type: application/json" \
  -d '{ "tier": "starter" }'

Request Body

Response 201 Created

{
  "statusCode": 201,
  "data": {
    "url": "https://checkout.stripe.com/c/pay/..."
  }
}

Redirect the user to url. After successful payment, Stripe redirects back to the dashboard Billing page. The plan is activated immediately via webhook.

Change Plan#

Upgrade or downgrade an existing subscription. The change takes effect immediately with proration. Usage does not reset mid-cycle.

curl -X POST https://app.pacspace.io/dashboard/stripe/change-plan \
  -b pacspace-dashboard-cookies.txt \
  -H "Content-Type: application/json" \
  -d '{ "tier": "growth" }'

Request Body

Response 200 OK

{
  "statusCode": 200,
  "data": {
    "subscriptionId": "sub_1R...",
    "status": "active"
  }
}

Requires an active subscription. If the tenant has no subscription, use the Subscribe endpoint first.

Open Customer Portal#

Create a Stripe Customer Portal session for managing payment methods, viewing invoices, and downloading receipts.

curl -X POST https://app.pacspace.io/dashboard/stripe/create-portal-session \
  -b pacspace-dashboard-cookies.txt

Response 201 Created

{
  "statusCode": 201,
  "data": {
    "url": "https://billing.stripe.com/p/session/..."
  }
}

Redirect the user to url. The portal returns them to the dashboard Billing page when done.

Cancel Subscription#

Schedule the subscription for cancellation at the end of the current period. Access continues until that date, then the account reverts to the Free tier.

curl -X POST https://app.pacspace.io/dashboard/stripe/cancel-subscription \
  -b pacspace-dashboard-cookies.txt

Response 200 OK

{
  "statusCode": 200,
  "data": {
    "subscriptionId": "sub_1R...",
    "cancelAtPeriodEnd": true,
    "currentPeriodEnd": "2026-03-13T00:00:00.000Z"
  }
}

Usage Limits#

Free Plan#

The Free plan is hard-capped at 100 verified deltas per UTC month. Once exhausted for the current month, write operations return 402 Payment Required. Upgrade to a paid plan to continue immediately.

Paid Plans#

Paid plans allow overage beyond the included allotment. Overages are billed at your plan's per-delta rate at the end of each period.

Endpoints Summary#