Get Subscription

GET

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

string

Your current subscription tier. One of shrimp, crab, lobster, or whale.

number | null

The maximum number of instances allowed on this tier. null means unlimited (whale tier — you’re living large).

number

How many instances your organization currently has.

string | null

Your Stripe customer ID, if a billing relationship exists.

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

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

Overview

Organization

Instances

Channels

Skills

Files

API Keys

Subscription

Get Subscription

Authorization

Response

​Authorization

​Response

Authorization

Response