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"
}

Documentation Index

Fetch the complete documentation index at: https://docs.chowder.dev/llms.txt

Use this file to discover all available pages before exploring further.

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"
}