Skip to main content
GET
/
api
/
public
/
subscriptions
/
status
curl "https://app.crovver.com/api/public/subscriptions/status?publicKey=pk_live_...&tenantId=workspace_123"

{
  "success": true,
  "data": {
    "active": true,
    "status": "active",
    "tenant": { "id": "workspace_123", "name": "Acme Corp", "isActive": true },
    "subscription": {
      "id": "sub_uuid",
      "status": "active",
      "trialEndsAt": null,
      "currentPeriodStart": "2026-05-01T00:00:00Z",
      "currentPeriodEnd": "2026-06-01T00:00:00Z",
      "capacityUnits": 10,
      "usedCapacity": 7
    },
    "plan": {
      "id": "plan_uuid",
      "name": "Growth",
      "productId": "prod_uuid",
      "productName": "Product A",
      "productSlug": "product-a",
      "billingInterval": "monthly",
      "features": ["feature_x", "feature_y"],
      "limits": { "api_calls": 10000 }
    }
  }
}
Returns the active subscription, plan details, and tenant info for the given tenant.

​
Authentication

Pass your public key as a query parameter (?publicKey=pk_live_...). No bearer token required or accepted.

​
Request

​
publicKey
string
required
Your public key (pk_live_... or pk_test_...)
​
tenantId
string
required
The external tenant ID from your application
​
productSlug
string
Scope the lookup to a specific product (e.g. product-a, product-b). Required for multi-product orgs where a tenant holds one subscription per product. Omit for single-product orgs — returns the most recently created active subscription.

​
Response

​
success
boolean
​
data
object
curl "https://app.crovver.com/api/public/subscriptions/status?publicKey=pk_live_...&tenantId=workspace_123"

{
  "success": true,
  "data": {
    "active": true,
    "status": "active",
    "tenant": { "id": "workspace_123", "name": "Acme Corp", "isActive": true },
    "subscription": {
      "id": "sub_uuid",
      "status": "active",
      "trialEndsAt": null,
      "currentPeriodStart": "2026-05-01T00:00:00Z",
      "currentPeriodEnd": "2026-06-01T00:00:00Z",
      "capacityUnits": 10,
      "usedCapacity": 7
    },
    "plan": {
      "id": "plan_uuid",
      "name": "Growth",
      "productId": "prod_uuid",
      "productName": "Product A",
      "productSlug": "product-a",
      "billingInterval": "monthly",
      "features": ["feature_x", "feature_y"],
      "limits": { "api_calls": 10000 }
    }
  }
}