Skip to main content
GET
/
v1
/
billing
/
plans
List plans
curl --request GET \
  --url https://api.example.com/v1/billing/plans

​
Overview

Returns all available CauseFlow subscription plans with their included quotas, pricing, and feature limits. Use this to display plan options in your own UI or to check what’s included in each tier. Authentication: Public endpoint — no JWT required.

​
Response

Returns 200 OK. 
{
  "plans": [
    {
      "planId": "plan_starter",
      "name": "Starter",
      "priceMonthlyUsd": 99,
      "features": {
        "investigationsPerMonth": 15,
        "eventsPerMonth": 500,
        "apiRateLimitPerMinute": 100,
        "customSkills": false,
        "relayAccess": false
      }
    },
    {
      "planId": "plan_pro",
      "name": "Pro",
      "priceMonthlyUsd": 349,
      "features": {
        "investigationsPerMonth": 60,
        "eventsPerMonth": 3000,
        "apiRateLimitPerMinute": 500,
        "customSkills": true,
        "relayAccess": true
      }
    },
    {
      "planId": "plan_business",
      "name": "Business",
      "priceMonthlyUsd": 899,
      "features": {
        "investigationsPerMonth": 200,
        "eventsPerMonth": 10000,
        "apiRateLimitPerMinute": 2000,
        "customSkills": true,
        "relayAccess": true
      }
    },
    {
      "planId": "plan_enterprise",
      "name": "Enterprise",
      "priceMonthlyUsd": null,
      "features": {
        "investigationsPerMonth": "custom",
        "eventsPerMonth": "custom",
        "apiRateLimitPerMinute": 2000,
        "customSkills": true,
        "relayAccess": true
      }
    }
  ]
}
FieldTypeDescription
planIdstringUnique plan identifier used for subscription calls
namestringHuman-readable plan name
priceMonthlyUsdnumber | nullMonthly price in USD. null for Enterprise (custom pricing, minimum $2,000/mo)
features.investigationsPerMonthinteger | "custom"Monthly AI investigation quota
features.eventsPerMonthinteger | "custom"Monthly ingested events quota
features.apiRateLimitPerMinuteintegerAPI rate limit
features.customSkillsbooleanCustom investigation skills available
features.relayAccessbooleanRelay deployment included

​
Error responses

StatusError codeDescription
429rate_limit_exceededToo many requests

​
Examples

curl https://api.causeflow.ai/v1/billing/plans

Subscription

View or change your active subscription

Purchase credits

Buy additional investigation credits