Skip to main content
GET
/
v1
/
subscription
curl https://api.chowder.dev/v1/subscription \
  -H "Authorization: Bearer chd_sk_your_org_key"

{
  "tier": "lobster",
  "instance_limit": 25,
  "instance_count": 12,
  "stripe_customer_id": "cus_abc123",
  "stripe_subscription_id": "sub_def456"
}
Check what plan your organization is on and how many instances you’re using. Useful for building billing dashboards or enforcing limits in your own application logic.

​
Authorization

Requires an organization-level API key in the Authorization header.

​
Response

​
tier
string
Your current subscription tier. One of shrimp, crab, lobster, or whale.
​
instance_limit
number | null
The maximum number of instances allowed on this tier. null means unlimited (whale tier — you’re living large).
​
instance_count
number
How many instances your organization currently has.
​
stripe_customer_id
string | null
Your Stripe customer ID, if a billing relationship exists.
​
stripe_subscription_id
string | null
Your Stripe subscription ID, if you’re on a paid plan.
curl https://api.chowder.dev/v1/subscription \
  -H "Authorization: Bearer chd_sk_your_org_key"

{
  "tier": "lobster",
  "instance_limit": 25,
  "instance_count": 12,
  "stripe_customer_id": "cus_abc123",
  "stripe_subscription_id": "sub_def456"
}