Billing & Credits

Egret uses a credit-based billing model. Credits are consumed per query based on your plan's model tier. Subscriptions are managed from the Egret dashboard — these endpoints let you fetch plan details and monitor usage programmatically.

List available plans

Public endpoint — no authentication required.

GET https://api.getegret.com/v1/billings/plans/

[
  {
    "slug": "free",
    "name": "Free",
    "description": "Free access to public knowledge base with standard models.",
    "tier": "free",
    "price_monthly_usd": "0.00",
    "monthly_credits": 50,
    "model_tier": "standard",
    "max_api_keys": 0,
    "max_storage_gb": "0.00",
    "has_api_access": false,
    "has_streaming": true,
    "has_export": false,
    "has_cross_category_compare": false,
    "has_custom_documents": false
  },
  {
    "slug": "starter",
    "name": "Starter",
    "description": "For individuals and small teams getting started with BC advisory.",
    "tier": "starter",
    "price_monthly_usd": "49.00",
    "monthly_credits": 5000,
    "model_tier": "standard",
    "max_api_keys": 1,
    "max_storage_gb": "1.00",
    "has_api_access": true,
    "has_streaming": true,
    "has_export": false,
    "has_cross_category_compare": false,
    "has_custom_documents": true
  },
  {
    "slug": "professional",
    "name": "Professional",
    "description": "For compliance teams needing multi-region coverage and advanced features.",
    "tier": "professional",
    "price_monthly_usd": "149.00",
    "monthly_credits": 20000,
    "model_tier": "premium",
    "max_api_keys": 1,
    "max_storage_gb": "5.00",
    "has_api_access": true,
    "has_streaming": true,
    "has_export": true,
    "has_cross_category_compare": true,
    "has_custom_documents": true
  },
  {
    "slug": "enterprise",
    "name": "Enterprise",
    "description": "Unlimited usage, all models, dedicated support, and custom domains.",
    "tier": "enterprise",
    "price_monthly_usd": "0.00",
    "monthly_credits": 0,
    "model_tier": "enterprise",
    "max_api_keys": 5,
    "max_storage_gb": "0.00",
    "has_api_access": true,
    "has_streaming": true,
    "has_export": true,
    "has_cross_category_compare": true,
    "has_custom_documents": true
  }
]

Plan comparison

Feature	Free	Starter	Professional
Price	Free	$49/mo	$149/mo
Credits/month	50	5,000	20,000
Model tier	Standard	Standard	Premium
Storage	—	1 GB	5 GB
API keys	—	1	1
Streaming	✓	✓	✓
API access	—	✓	✓
Export	—	—	✓
Cross-category compare	—	—	✓
Custom documents	—	✓	✓
Organization support	—	✓	✓

For Enterprise pricing and custom arrangements, contact our team.

Every new account starts on the Free plan automatically — no credit card required. Upgrade anytime from the dashboard.

Get current subscription & quota

GET https://api.getegret.com/v1/billings/subscription/
Authorization: Bearer egret_...

Returns your active plan and real-time credit usage for the current billing period.

{
  "id": "d714f22f-b1f5-4b74-b9d2-97ee4d348bc2",
  "plan": {
    "slug": "free",
    "name": "Free",
    "monthly_credits": 50,
    "model_tier": "standard",
    ...
  },
  "status": "active",
  "is_active": true,
  "current_period_start": "2026-04-17T16:53:01.408065Z",
  "current_period_end": "2026-05-17T16:53:01.408065Z",
  "trial_end": null,
  "canceled_at": null,
  "current_quota": {
    "period_start": "2026-04-17T16:53:01.408065Z",
    "period_end": "2026-05-17T16:53:01.408065Z",
    "credits_used": 6,
    "credits_limit": 50,
    "credits_remaining": 44,
    "is_exhausted": false,
    "queries_used": 6,
    "total_cost_usd": "0.0160586"
  }
}

Quota fields

Field	Description
`credits_used`	Credits consumed in the current billing period
`credits_remaining`	Credits left before the period resets
`is_exhausted`	`true` when no credits remain — queries will be blocked until the period resets or the plan is upgraded
`queries_used`	Total number of queries made this period
`total_cost_usd`	Estimated cost in USD for this period's usage

Subscription status values

Status	Meaning
`active`	Subscription in good standing (includes Free plan)
`canceled`	Subscription canceled — access continues until `current_period_end`, then downgrades to Free
`past_due`	Payment failed — resolve from the billing dashboard
`paused`	Subscription paused — contact support to resume

Managing your plan

Subscribing, upgrading, downgrading, and canceling are handled from the Egret dashboard. Canceling a paid plan downgrades you to the Free plan at the end of your billing period. For Enterprise pricing and custom arrangements, contact our team.