Usage & Limits API

Two endpoints report where the active org stands against its plan. Both are allowlisted past the card wall, so they remain readable even before a card is verified.

• GET /v1/limits — plan, allowances, and current resource counts (powers upgrade prompts).
• GET /v1/usage — this month’s metered usage, from meter-sync rollups.

A value of -1 in any numeric limit field means unlimited.

Concept guides: Plans & limits, Instance tiers, Usage & metering.

Both routes require authentication and are available to any member.

---

Plan limits & current counts

GET /v1/limits

The active org’s plan, its allowances, and current usage counts.

Auth: any member (card-gate allowlisted). Response (OrgLimits):

Field	Type	Notes
plan	free | pro | premium | enterprise
limits	PlanLimits	The allowance matrix (below).
usage	ResourceCounts	Current counts (below).

ResourceCounts (used for both limits.counts and usage):

Field	Type
containers	number
static	number
databases	number
functions	number
cronjobs	number

PlanLimits:

Field	Type	Notes
counts	ResourceCounts	Max allowed of each resource (-1 = unlimited).
buildMinutesPerMonth	number
bandwidthGbPerMonth	number
deploymentHistoryDays	number
dbBackupRetentionDays	number
dbConnectionLimit	number
teamMembers	number
teams	number
features	object	{ customDomain, analytics, autoscaling, functions, cronjobs } (booleans).

curl https://api.pandastack.io/v1/limits \
  -H "Authorization: Bearer $PANDASTACK_TOKEN"

{
  "success": true,
  "data": {
    "plan": "pro",
    "limits": {
      "counts": { "containers": -1, "static": -1, "databases": 10, "functions": 20, "cronjobs": 10 },
      "buildMinutesPerMonth": 2000,
      "bandwidthGbPerMonth": 500,
      "deploymentHistoryDays": 90,
      "dbBackupRetentionDays": 7,
      "dbConnectionLimit": 100,
      "teamMembers": 25,
      "teams": 10,
      "features": { "customDomain": true, "analytics": true, "autoscaling": true, "functions": true, "cronjobs": true }
    },
    "usage": { "containers": 4, "static": 12, "databases": 2, "functions": 3, "cronjobs": 1 }
  }
}

---

Metered usage

GET /v1/usage

The active org’s metered usage for the current month, aggregated from meter-sync rollups.

Auth: any member (card-gate allowlisted). Response (OrgUsage):

Field	Type	Notes
period	string	YYYY-MM (UTC).
enabled	boolean
containerHours	number
databaseHours	number
buildMinutes	number
bandwidthMb	number
analyticsEvents	number
fnInvocations	number
cronjobRuns	number
bandwidthExceeded	boolean	Default false; true once the monthly bandwidth quota is hit.

curl https://api.pandastack.io/v1/usage \
  -H "Authorization: Bearer $PANDASTACK_TOKEN"

{
  "success": true,
  "data": {
    "period": "2026-07",
    "enabled": true,
    "containerHours": 320.5,
    "databaseHours": 744,
    "buildMinutes": 128,
    "bandwidthMb": 45210,
    "analyticsEvents": 91200,
    "fnInvocations": 8400,
    "cronjobRuns": 210,
    "bandwidthExceeded": false
  }
}

Related

• Billing API — upgrade the plan to raise these limits.
• Organizations & teams — overview — resource counts and deployment rollups.