{
  "name": "Chargebee",
  "slug": "chargebee",
  "website_url": "https://www.chargebee.com",
  "vendor_description": "\"Billing & Monetization for SaaS and AI Companies.\"",
  "categories": [
    "billing"
  ],
  "summary": "Chargebee is a subscription and usage-based billing platform built for SaaS and AI companies, handling the full subscription lifecycle from creation and metering through dunning, revenue recognition (ASC 606/IFRS 15), and CPQ. It offers a free Starter tier up to $250K cumulative billing, with paid plans from $599/month and an enterprise tier priced on request. The REST API ships with SDKs for seven languages, supports webhooks and idempotency, and holds SOC 2 Type II, ISO 27001, PCI DSS, HIPAA, and GDPR certifications.",
  "capabilities": {
    "supported_actions": [
      "create_subscription",
      "update_subscription",
      "cancel_subscription",
      "pause_subscription",
      "resume_subscription",
      "schedule_subscription_changes",
      "usage_metering",
      "tiered_pricing",
      "flat_fee_pricing",
      "volume_pricing",
      "stairstep_pricing",
      "hybrid_pricing",
      "proration",
      "invoicing",
      "advance_invoicing",
      "consolidated_invoicing",
      "credit_notes",
      "dunning",
      "smart_payment_retry",
      "automatic_card_updater",
      "revenue_recognition",
      "deferred_revenue",
      "tax_calculation",
      "entitlements",
      "coupons",
      "trials",
      "customer_portal",
      "webhooks",
      "multicurrency",
      "multi_gateway_routing",
      "account_hierarchy",
      "contract_terms",
      "backdated_actions",
      "gift_subscriptions",
      "in_app_purchases",
      "cpq_quotes",
      "promotional_credits",
      "differential_pricing",
      "calendar_billing",
      "net_terms",
      "chargeback_management"
    ],
    "supported_regions": [
      "North America",
      "Europe",
      "Asia Pacific",
      "Global (100+ currencies)"
    ],
    "supported_languages": [
      "English",
      "French",
      "German",
      "Italian",
      "Portuguese",
      "Spanish"
    ],
    "input_types": [
      "subscription objects",
      "usage events",
      "customer records",
      "invoice line items",
      "payment sources",
      "product catalog items",
      "coupon codes",
      "quote objects",
      "metered usage records"
    ],
    "output_types": [
      "JSON",
      "invoices (PDF)",
      "webhook events",
      "revenue reports",
      "hosted checkout",
      "customer self-serve portal",
      "credit notes",
      "revenue recognition journal entries",
      "subscription analytics"
    ],
    "webhooks_supported": true,
    "sandbox_available": true,
    "sdk_languages": [
      "Node.js",
      "Python",
      "PHP",
      "Java",
      "Ruby",
      "Go",
      ".NET"
    ],
    "mcp_server_available": true
  },
  "integration": {
    "api_style": "rest",
    "base_url": "https://{site}.chargebee.com/api/v2/",
    "api_version": "v2",
    "versioning_scheme": "url",
    "stability": "ga",
    "deprecation_policy_url": "https://apidocs.chargebee.com/docs/api/versioning",
    "auth_methods": [
      "basic"
    ],
    "auth_docs_url": "https://apidocs.chargebee.com/docs/api?prod_cat_ver=2",
    "idempotency_supported": true,
    "error_format": "vendor-specific JSON with api_error_code, message, type, param fields",
    "webhook_signing": null,
    "webhook_events_url": "https://apidocs.chargebee.com/docs/api/events/event-types",
    "rate_limit_requests": 150,
    "rate_limit_window": "minute",
    "sdk_packages": [
      {
        "package": "chargebee",
        "language": "Node.js",
        "official": true,
        "repo_url": "https://github.com/chargebee/chargebee-node"
      },
      {
        "package": "chargebee",
        "language": "Python",
        "official": true,
        "repo_url": "https://github.com/chargebee/chargebee-python"
      },
      {
        "package": "chargebee/chargebee-php",
        "language": "PHP",
        "official": true,
        "repo_url": "https://github.com/chargebee/chargebee-php"
      },
      {
        "package": "com.chargebee:chargebee-java",
        "language": "Java",
        "official": true,
        "repo_url": "https://github.com/chargebee/chargebee-java"
      },
      {
        "package": "chargebee",
        "language": "Ruby",
        "official": true,
        "repo_url": "https://github.com/chargebee/chargebee-ruby"
      },
      {
        "package": "github.com/chargebee/chargebee-go/v3",
        "language": "Go",
        "official": true,
        "repo_url": "https://github.com/chargebee/chargebee-go"
      },
      {
        "package": "ChargeBee",
        "language": ".NET",
        "official": true,
        "repo_url": "https://github.com/chargebee/chargebee-dotnet"
      }
    ],
    "mcp_url": "https://www.chargebee.com/docs/billing/2.0/developer-resources/mcp",
    "quickstart_url": "https://apidocs.chargebee.com/docs/api/getting-started"
  },
  "pricing": {
    "pricing_model": "hybrid",
    "has_published_pricing": true,
    "starting_price_usd": "599.0000",
    "price_basis": "month",
    "free_tier_available": true,
    "free_tier_limit": "Free up to $250K cumulative billing (Starter plan); startup program free up to $1M cumulative billing for eligible startups",
    "free_tier_details": "Starter plan: free for the first $250K cumulative billing, then 0.75% per month on billing volume above that threshold. No time limit - this is a recurring production plan, not a trial.",
    "minimum_commitment": "Performance plan requires annual commitment at $7,188/year (billed monthly) for up to $100K billing/month.",
    "self_serve_signup": true,
    "requires_sales_call": false,
    "requires_verification": false,
    "enterprise_plan_available": true,
    "price_points": [
      {
        "plan": "Starter",
        "item": "Platform fee",
        "amount_usd": "0.0000",
        "amount_percent": null,
        "per": "month",
        "currency": "USD",
        "source_url": "https://www.chargebee.com/pricing/"
      },
      {
        "plan": "Starter",
        "item": "Overage above $250K cumulative billing",
        "amount_usd": null,
        "amount_percent": "0.7500",
        "per": "% of monthly billing volume",
        "currency": "USD",
        "source_url": "https://www.chargebee.com/pricing/"
      },
      {
        "plan": "Performance",
        "item": "Platform fee (annual commitment, billed monthly)",
        "amount_usd": "7188.0000",
        "amount_percent": null,
        "per": "year",
        "currency": "USD",
        "source_url": "https://www.chargebee.com/pricing/"
      },
      {
        "plan": "Enterprise",
        "item": "Platform fee",
        "amount_usd": null,
        "amount_percent": null,
        "per": null,
        "currency": "USD",
        "source_url": "https://www.chargebee.com/pricing/"
      }
    ]
  },
  "compliance": {
    "soc2": "type_2",
    "hipaa": true,
    "gdpr": true,
    "iso_27001": true,
    "pci_dss": true,
    "sla_published": true,
    "sla_url": "https://status.chargebee.com/uptime",
    "data_retention_policy_url": "https://www.chargebee.com/privacy/",
    "documented_rate_limits": "Starter: 150 API calls/minute; Performance: 1,000/minute; Enterprise (default): 3,500/minute; Enterprise (custom): no upper limit. Concurrency limits: 50 concurrent GET requests, 100 concurrent POST requests. Test sites: 150 calls/minute. Returns HTTP 429 when exceeded.",
    "known_restrictions": [
      "Performance plan requires annual commitment; no monthly billing option",
      "Revenue Recognition, CPQ (full), and Growth Enterprise products require Chargebee Billing subscription and separate pricing/contact-sales",
      "HIPAA support is scoped to core billing platform only; BAA must be executed before sharing ePHI; does not extend to Receivables, RevRec, Retention, or Reveal products",
      "Enterprise plan pricing is quote-only (contact sales)"
    ]
  },
  "developer": {
    "docs_url": "https://www.chargebee.com/docs",
    "api_reference_url": null,
    "openapi_spec_url": null,
    "postman_collection_url": null,
    "changelog_url": null,
    "status_page_url": "https://status.chargebee.com",
    "llms_txt_url": "https://www.chargebee.com/llms.txt",
    "markdown_docs_url": null,
    "rendering": "static"
  },
  "adoption": {
    "launched_at": "2011-01-01",
    "ga_date": null,
    "github_stars": null,
    "github_stars_at": null,
    "notable_customers": [
      "Zapier",
      "Typeform",
      "Pret A Manger",
      "Condé Nast",
      "LegalZoom",
      "Study.com",
      "Brevo",
      "A Cloud Guru"
    ]
  },
  "scores": {
    "agent_friendliness": 65,
    "pricing_transparency": 100,
    "setup_speed": 100,
    "docs_quality": 25,
    "procurement_friction": 100,
    "trust_readiness": 100,
    "best_for": [
      "Prototypes and side projects - free to start, no sales call",
      "Regulated or enterprise workloads - compliance attestations and an enterprise plan",
      "AI agents and automation - an agent-ready surface (MCP / llms.txt)"
    ],
    "avoid_if": []
  },
  "sources": [
    {
      "field": "vendor_description",
      "url": "https://www.chargebee.com/",
      "excerpt": "Chargebee: Billing & Monetization for SaaS and AI Companies",
      "confidence": "high"
    },
    {
      "field": "primary_use_cases",
      "url": "https://www.chargebee.com/",
      "excerpt": "Adopt new pricing models—tiered, usage-based, flat-fee, or any custom model, without outgrowing your billing system.",
      "confidence": "high"
    },
    {
      "field": "primary_use_cases",
      "url": "https://www.chargebee.com/features/",
      "excerpt": "ASC 606/IFRS 15 revenue recognition automation",
      "confidence": "high"
    },
    {
      "field": "supported_actions",
      "url": "https://www.chargebee.com/features/",
      "excerpt": "Complete lifecycle handling: creation, pausing, cancellation, reactivation, extension",
      "confidence": "high"
    },
    {
      "field": "supported_actions",
      "url": "https://apidocs.chargebee.com/docs/api/subscriptions",
      "excerpt": "The API supports managing: Subscription items and item prices, Coupons and discounts, Charges (one-time and event-based), Invoices (including advance invoicing schedules), Payment sources",
      "confidence": "high"
    },
    {
      "field": "webhooks_supported",
      "url": "https://apidocs.chargebee.com/docs/api/events/event-types",
      "excerpt": "invoice_generated, invoice_updated, invoice_deleted, payment_succeeded, payment_failed, payment_refunded, subscription_cancelled",
      "confidence": "high"
    },
    {
      "field": "sandbox_available",
      "url": "https://apidocs.chargebee.com/docs/api",
      "excerpt": "A dedicated test site is automatically created with account signup. API keys are environment-specific. Use the test site API key during development and switch to the live site API key for production use.",
      "confidence": "high"
    },
    {
      "field": "sdk_languages",
      "url": "https://apidocs.chargebee.com/docs/api",
      "excerpt": "Chargebee maintains official client libraries for Node, Python, PHP, Java, Go, Ruby, and .NET. Framework adapters are available for Laravel and Next.js.",
      "confidence": "high"
    },
    {
      "field": "mcp_server_available",
      "url": "https://www.chargebee.com/docs/billing/2.0/developer-resources/mcp",
      "excerpt": "The Chargebee MCP server lets AI agents (Claude, Cursor, Windsurf, and others) interact with the Chargebee API directly via the Model Context Protocol. npx -y @chargebee/mcp@latest",
      "confidence": "high"
    },
    {
      "field": "mcp_server_available",
      "url": "https://apidocs.chargebee.com/docs/api",
      "excerpt": "MCP Server enabling AI agent integration via the Model Context Protocol",
      "confidence": "high"
    },
    {
      "field": "pricing_model",
      "url": "https://www.chargebee.com/pricing/",
      "excerpt": "Free for the first USD 250K of cumulative billing, then 0.75% on billing",
      "confidence": "high"
    },
    {
      "field": "pricing_model",
      "url": "https://www.chargebee.com/pricing/",
      "excerpt": "Performance: USD 7,188/yr — Annual commitment / Billed monthly",
      "confidence": "high"
    },
    {
      "field": "has_published_pricing",
      "url": "https://www.chargebee.com/pricing/",
      "excerpt": "Starter: Free for first $250K cumulative billing, then 0.75% monthly on billing above threshold. Performance: $7,188/year (billed monthly) for up to $100K billing/month",
      "confidence": "high"
    },
    {
      "field": "free_tier_available",
      "url": "https://www.chargebee.com/pricing/",
      "excerpt": "Free for the first USD 250K of cumulative billing, then 0.75% on billing",
      "confidence": "high"
    },
    {
      "field": "free_tier_details",
      "url": "https://www.chargebee.com/pricing/",
      "excerpt": "Free for first $250K cumulative billing, then 0.75% monthly on billing above threshold. Includes: Flexible billing, checkout, usage metering, multi-region sales tax, 35+ payment gateways",
      "confidence": "high"
    },
    {
      "field": "minimum_commitment",
      "url": "https://www.chargebee.com/pricing/",
      "excerpt": "Performance: $7,188/year (billed monthly) for up to $100K billing/month. Annual commitment required.",
      "confidence": "high"
    },
    {
      "field": "enterprise_plan_available",
      "url": "https://www.chargebee.com/pricing/",
      "excerpt": "Enterprise: Custom quote required. Includes: Multi-entity support, account hierarchy, on-demand discounting, contract terms",
      "confidence": "high"
    },
    {
      "field": "soc2",
      "url": "https://www.chargebee.com/docs/billing/2.0/data-privacy-security/compliance-certificates",
      "excerpt": "SOC 2 Type II report provides an independent assessment of Chargebee's control environment relevant to system security, availability, and confidentiality.",
      "confidence": "high"
    },
    {
      "field": "soc2",
      "url": "https://www.chargebee.com/docs/billing/2.0/kb/billing/soc-1-soc-2-type-ii-reports",
      "excerpt": "SOC1 Type 2 and SOC2 Type 2 reports are available for download on your Chargebee Test site",
      "confidence": "high"
    },
    {
      "field": "hipaa",
      "url": "https://www.chargebee.com/docs/billing/2.0/data-privacy-security/hipaa-guidelines",
      "excerpt": "Chargebee supports HIPAA compliance within its billing and subscription management platform.",
      "confidence": "high"
    },
    {
      "field": "gdpr",
      "url": "https://www.chargebee.com/docs/billing/2.0/data-privacy-security/eu-gdpr",
      "excerpt": "Chargebee is in compliance with the new Standard Contractual Clauses (SCCs) issued by the EU Commission in June 2021",
      "confidence": "high"
    },
    {
      "field": "iso_27001",
      "url": "https://www.chargebee.com/docs/billing/2.0/data-privacy-security/compliance-certificates",
      "excerpt": "ISO/IEC 27001:2022 is the standards certificate for implementation, maintenance and continual improvement of the information security management system.",
      "confidence": "high"
    },
    {
      "field": "pci_dss",
      "url": "https://www.chargebee.com/docs/billing/2.0/data-privacy-security/compliance-certificates",
      "excerpt": "Chargebee is Level 1 PCI compliant. This standard ensures merchants meet minimum security requirements when handling cardholder data.",
      "confidence": "high"
    },
    {
      "field": "pci_dss",
      "url": "https://www.chargebee.com/security/pci-responsibility-matrix/",
      "excerpt": "Chargebee Billing is certified as compliant with the Payment Card Industry Data Security Standard (PCI DSS) version 4.0.",
      "confidence": "high"
    },
    {
      "field": "sla_published",
      "url": "https://www.chargebee.com/recurring-payments/checkout-experience/",
      "excerpt": "Chargebee's 99.9% Uptime Guarantee (SLA) ensures you can confidently rely on us for your global business operations.",
      "confidence": "high"
    },
    {
      "field": "sla_published",
      "url": "https://www.chargebee.com/billing/",
      "excerpt": "99.9% Uptime",
      "confidence": "high"
    },
    {
      "field": "documented_rate_limits",
      "url": "https://www.chargebee.com/docs/billing/2.0/kb/platform/what-are-the-chargebee-api-limits",
      "excerpt": "Starter: 150 API calls per minute. Performance: 1,000. Enterprise (default): 3,500. Enterprise (custom): No upper limit. Test sites: 150 API calls per minute.",
      "confidence": "high"
    },
    {
      "field": "documented_rate_limits",
      "url": "https://apidocs.chargebee.com/docs/api/error-handling",
      "excerpt": "50 concurrent GET requests, 100 concurrent POST requests. When limits are exceeded, users receive an HTTP 429 status code error.",
      "confidence": "high"
    },
    {
      "field": "known_restrictions",
      "url": "https://www.chargebee.com/docs/billing/2.0/data-privacy-security/hipaa-guidelines",
      "excerpt": "The BAA covers only the core billing and subscription platform. The agreement does not extend to third-party integrations, middleware, or other Chargebee products (Receivables, RevRec, Retention, Reveal)",
      "confidence": "high"
    },
    {
      "field": "known_restrictions",
      "url": "https://www.chargebee.com/pricing/",
      "excerpt": "Performance: $7,188/year (billed monthly) for up to $100K billing/month. Annual commitment required.",
      "confidence": "high"
    },
    {
      "field": "supported_regions",
      "url": "https://www.chargebee.com/integrations/",
      "excerpt": "Chargebee explicitly supports three geographic areas: North America, Europe, Asia Pacific",
      "confidence": "high"
    },
    {
      "field": "supported_regions",
      "url": "https://www.chargebee.com/recurring-payments/multicurrency/",
      "excerpt": "Chargebee supports 100+ currencies so you can accept payments from your customers in their preferred currency.",
      "confidence": "high"
    },
    {
      "field": "supported_languages",
      "url": "https://www.chargebee.com/docs/2.0/supported-locales.html",
      "excerpt": "Chargebee supports locales for the following languages in multiple regions around the world.",
      "confidence": "high"
    },
    {
      "field": "supported_languages",
      "url": "https://www.chargebee.com/docs/2.0/configure-multiple-languages.html",
      "excerpt": "Chargebee provides default translation for a set of languages: English, French, German, Italian, Portuguese, Spanish",
      "confidence": "high"
    },
    {
      "field": "auth_methods",
      "url": "https://apidocs.chargebee.com/docs/api?prod_cat_ver=2",
      "excerpt": "HTTP Basic Auth using API key as username with empty password. \"Send all requests over HTTPS. Do not expose API keys in client-side code or public repositories.\"",
      "confidence": "high"
    },
    {
      "field": "base_url",
      "url": "https://apidocs.chargebee.com/docs/api?prod_cat_ver=2",
      "excerpt": "https://{site}.chargebee.com/api/v2/ (replace {site} with your site name)",
      "confidence": "high"
    },
    {
      "field": "api_version",
      "url": "https://apidocs.chargebee.com/docs/api/versioning",
      "excerpt": "Chargebee maintains two major API versions: v1 and v2. Version 2 includes sub-versions related to Product Catalog changes.",
      "confidence": "high"
    },
    {
      "field": "versioning_scheme",
      "url": "https://apidocs.chargebee.com/docs/api/versioning",
      "excerpt": "v2 uses /api/v2 while v1 uses /api/v1",
      "confidence": "high"
    },
    {
      "field": "idempotency_supported",
      "url": "https://apidocs.chargebee.com/docs/api/idempotency",
      "excerpt": "Header Name: chargebee-idempotency-key. Supported Methods: POST requests only. Idempotency window: 30 minutes.",
      "confidence": "high"
    },
    {
      "field": "error_format",
      "url": "https://apidocs.chargebee.com/docs/api/error-handling",
      "excerpt": "Chargebee returns errors in JSON format with the following attributes: message, type, api_error_code, param, error_cause_id",
      "confidence": "high"
    },
    {
      "field": "rate_limit_requests",
      "url": "https://apidocs.chargebee.com/docs/api/error-handling",
      "excerpt": "Rate Limits (per minute): Starter: 150, Performance: 1,000, Enterprise (default): 3,500. Test sites: 150",
      "confidence": "high"
    },
    {
      "field": "rate_limit_requests",
      "url": "https://www.chargebee.com/docs/billing/2.0/kb/platform/what-are-the-chargebee-api-limits",
      "excerpt": "For test sites, it is 150 API calls per minute.",
      "confidence": "high"
    },
    {
      "field": "webhook_signing",
      "url": "https://www.chargebee.com/docs/billing/2.0/site-configuration/events_and_webhooks",
      "excerpt": "Currently, Chargebee's webhook setup only supports basic authentication. HMAC (Hash-based Message Authentication Code) signing for webhook authentication is not supported at this time.",
      "confidence": "high"
    },
    {
      "field": "webhook_events_url",
      "url": "https://apidocs.chargebee.com/docs/api/events/event-types",
      "excerpt": "Chargebee supports 300+ webhook event types organized by resource. All events follow a uniform pattern - <resource>_<event_name>.",
      "confidence": "high"
    },
    {
      "field": "sdk_packages",
      "url": "https://github.com/chargebee",
      "excerpt": "Official SDKs: chargebee-node (npm: chargebee), chargebee-python (pip: chargebee), chargebee-php (composer: chargebee/chargebee-php), chargebee-java (maven: com.chargebee:chargebee-java), chargebee-ruby (gem: chargebee), chargebee-go (go: github.com/chargebee/chargebee-go/v3), chargebee-dotnet (nuget: ChargeBee)",
      "confidence": "high"
    },
    {
      "field": "mcp_url",
      "url": "https://www.chargebee.com/docs/billing/2.0/developer-resources/mcp",
      "excerpt": "The Chargebee MCP server lets AI agents (Claude, Cursor, Windsurf, and others) interact with the Chargebee API directly via the Model Context Protocol. npx -y @chargebee/mcp@latest",
      "confidence": "high"
    },
    {
      "field": "mcp_url",
      "url": "https://github.com/chargebee/agentkit/tree/main/modelcontextprotocol",
      "excerpt": null,
      "confidence": "high"
    },
    {
      "field": "quickstart_url",
      "url": "https://apidocs.chargebee.com/docs/api/getting-started",
      "excerpt": "To get started with Chargebee's API, you'll need to obtain credentials from your account: Log into the Chargebee application, navigate to Settings > Configure Chargebee > API Keys and Webhooks.",
      "confidence": "high"
    },
    {
      "field": "starting_price_usd",
      "url": "https://www.chargebee.com/pricing/",
      "excerpt": "Performance: $7,188/year (billed monthly) for up to $100K billing/month",
      "confidence": "high"
    },
    {
      "field": "free_tier_limit",
      "url": "https://www.chargebee.com/pricing/",
      "excerpt": "Starter: Free for first $250K cumulative billing, then 0.75% overage",
      "confidence": "high"
    },
    {
      "field": "free_tier_limit",
      "url": "https://www.chargebee.com/launch/",
      "excerpt": "Bill your first $1Mn worth of usages and subscriptions for free",
      "confidence": "high"
    },
    {
      "field": "launched_at",
      "url": "https://www.chargebee.com/company/",
      "excerpt": "Chargebee was founded in June 2011 by Krish Subramanian, Rajaraman Santhanam, KP Saravanan, and Thiyagarajan Thiyagu.",
      "confidence": "high"
    },
    {
      "field": "notable_customers",
      "url": "https://www.chargebee.com/customers/",
      "excerpt": "Officially highlighted customers include: Zapier, LegalZoom, Typeform, Pret A Manger, Condé Nast, Study.com, Brevo, A Cloud Guru",
      "confidence": "high"
    },
    {
      "field": "data_retention_policy_url",
      "url": "https://www.chargebee.com/privacy/",
      "excerpt": "Chargebee erases all your personal information 120 days after your account with us has been cancelled. Your Chargebee website along with all the information of your customers stored with us is also deleted.",
      "confidence": "medium"
    },
    {
      "field": "deprecation_policy_url",
      "url": "https://apidocs.chargebee.com/docs/api/versioning",
      "excerpt": "Chargebee considers the following changes as backward compatible: Adding new API resources, adding new attributes to existing API resources, changing the order of attributes in existing API responses, adding new endpoints, and adding new optional input parameters to existing endpoints.",
      "confidence": "medium"
    }
  ],
  "fields_not_found": [
    "exact list of all 100+ supported currencies",
    "ga_date",
    "deprecation_policy_url (no formal sunset/timeline policy published)",
    "sla_url (no dedicated SLA doc found; status page only)",
    "webhook_signing (HMAC not supported; basic auth only)"
  ],
  "source_confidence": "high",
  "last_verified_at": "2026-06-21T00:00:00.000Z",
  "contribute": {
    "note": "This data is crowd-editable. Suggest corrections or leave a review via these endpoints - no auth required, requests are rate-limited, and every submission is reviewed before it goes live. For a field edit, {field} is any key in this response and a citation is required.",
    "endpoints": [
      {
        "action": "review",
        "label": "Leave a review or comment",
        "method": "POST",
        "url": "https://apio.sh/api/feedback/chargebee",
        "example_body": {
          "kind": "review",
          "rating": 5,
          "body": "Your experience with this API…"
        }
      },
      {
        "action": "field_edit",
        "label": "Suggest a correction to a field (cite a source)",
        "method": "POST",
        "url": "https://apio.sh/api/suggest/chargebee/{field}",
        "example_body": {
          "value": "corrected value",
          "citations": [
            {
              "url": "https://source.example/page",
              "excerpt": "supporting quote"
            }
          ],
          "note": "what changed and why"
        }
      },
      {
        "action": "new_api",
        "label": "Suggest a new API to add (only name is required - send as much as you can cite)",
        "method": "POST",
        "url": "https://apio.sh/api/suggest/api",
        "example_body": {
          "value": {
            "name": "Acme Email API",
            "website_url": "https://acme.example",
            "vendor_name": "Acme",
            "categories": [
              "email"
            ],
            "pricing_model": "usage_based",
            "has_published_pricing": true,
            "free_tier_available": true,
            "price_points": [
              {
                "plan": "Pay as you go",
                "item": "1,000 emails",
                "amount_usd": 1,
                "per": "1,000 emails",
                "source_url": "https://acme.example/pricing"
              }
            ],
            "soc2": "type_2",
            "docs_url": "https://docs.acme.example"
          },
          "citations": [
            {
              "url": "https://acme.example/pricing",
              "excerpt": "$1 per 1,000 emails"
            }
          ]
        },
        "value_schema": [
          {
            "field": "name",
            "type": "string",
            "label": "Product name (the only required field)"
          },
          {
            "field": "website_url",
            "type": "string",
            "label": "Marketing website URL"
          },
          {
            "field": "vendor_name",
            "type": "string",
            "label": "Company/vendor name behind the product"
          },
          {
            "field": "vendor_description",
            "type": "string",
            "label": "One-line description, quoted from the vendor"
          },
          {
            "field": "categories",
            "type": "string[]",
            "label": "Category/leaf slugs it belongs to, e.g. [\"email\",\"sms\"]"
          },
          {
            "field": "primary_use_cases",
            "type": "string[]",
            "label": "What it's used for"
          },
          {
            "field": "supported_actions",
            "type": "string[]",
            "label": "Concrete API actions/capabilities"
          },
          {
            "field": "supported_regions",
            "type": "string[]",
            "label": "Countries/regions/data-residency"
          },
          {
            "field": "supported_languages",
            "type": "string[]",
            "label": "Human/spoken languages supported"
          },
          {
            "field": "input_types",
            "type": "string[]",
            "label": "Accepted input types/formats"
          },
          {
            "field": "output_types",
            "type": "string[]",
            "label": "Produced output types/formats"
          },
          {
            "field": "webhooks_supported",
            "type": "bool",
            "label": "Supports webhooks?"
          },
          {
            "field": "sandbox_available",
            "type": "bool",
            "label": "Dedicated sandbox/test mode?"
          },
          {
            "field": "sdk_languages",
            "type": "string[]",
            "label": "Languages with an official SDK"
          },
          {
            "field": "mcp_server_available",
            "type": "bool",
            "label": "Official MCP server?"
          },
          {
            "field": "pricing_model",
            "type": "enum",
            "label": "Pricing model",
            "values": [
              "usage_based",
              "subscription",
              "seat_based",
              "hybrid",
              "contact_sales"
            ]
          },
          {
            "field": "has_published_pricing",
            "type": "bool",
            "label": "Concrete prices published publicly?"
          },
          {
            "field": "free_tier_available",
            "type": "bool",
            "label": "Recurring/perpetual free tier (not a trial)?"
          },
          {
            "field": "free_tier_details",
            "type": "string",
            "label": "What the free tier includes"
          },
          {
            "field": "minimum_commitment",
            "type": "string",
            "label": "Any stated minimum spend/commitment"
          },
          {
            "field": "self_serve_signup",
            "type": "bool",
            "label": "Get an API key without talking to sales?"
          },
          {
            "field": "requires_sales_call",
            "type": "bool",
            "label": "Does going live require sales?"
          },
          {
            "field": "enterprise_plan_available",
            "type": "bool",
            "label": "Named enterprise tier?"
          },
          {
            "field": "starting_price_usd",
            "type": "number",
            "label": "Lowest published paid entry price (USD number)"
          },
          {
            "field": "price_basis",
            "type": "string",
            "label": "Unit the starting price is per, e.g. '1,000 emails'"
          },
          {
            "field": "free_tier_limit",
            "type": "string",
            "label": "Free-tier ceiling in literal terms"
          },
          {
            "field": "price_points",
            "type": "object[]",
            "label": "Structured prices: [{plan,item,amount_usd,amount_percent,per,source_url}]"
          },
          {
            "field": "soc2",
            "type": "enum",
            "label": "SOC 2 status",
            "values": [
              "type_2",
              "type_1",
              "in_progress",
              "none",
              "unknown"
            ]
          },
          {
            "field": "hipaa",
            "type": "bool",
            "label": "HIPAA (e.g. BAA available)?"
          },
          {
            "field": "gdpr",
            "type": "bool",
            "label": "GDPR compliance stated?"
          },
          {
            "field": "iso_27001",
            "type": "bool",
            "label": "ISO 27001 certified?"
          },
          {
            "field": "pci_dss",
            "type": "bool",
            "label": "PCI DSS compliant?"
          },
          {
            "field": "sla_published",
            "type": "bool",
            "label": "Published SLA / uptime commitment?"
          },
          {
            "field": "documented_rate_limits",
            "type": "string",
            "label": "Documented rate limits, quoted"
          },
          {
            "field": "known_restrictions",
            "type": "string[]",
            "label": "Notable documented restrictions/limits"
          },
          {
            "field": "auth_methods",
            "type": "string[]",
            "label": "Auth methods",
            "values": [
              "api_key",
              "oauth2",
              "jwt",
              "basic",
              "hmac_signature",
              "mtls",
              "session"
            ]
          },
          {
            "field": "api_style",
            "type": "enum",
            "label": "Primary API style",
            "values": [
              "rest",
              "graphql",
              "grpc",
              "soap",
              "websocket"
            ]
          },
          {
            "field": "base_url",
            "type": "string",
            "label": "API root/base URL"
          },
          {
            "field": "api_version",
            "type": "string",
            "label": "Current API version string"
          },
          {
            "field": "quickstart_url",
            "type": "string",
            "label": "Quickstart / hello-world URL"
          },
          {
            "field": "docs_url",
            "type": "string",
            "label": "Developer docs URL"
          },
          {
            "field": "api_reference_url",
            "type": "string",
            "label": "API reference URL"
          },
          {
            "field": "openapi_spec_url",
            "type": "string",
            "label": "OpenAPI spec URL"
          },
          {
            "field": "changelog_url",
            "type": "string",
            "label": "Changelog URL"
          },
          {
            "field": "status_page_url",
            "type": "string",
            "label": "Status page URL"
          },
          {
            "field": "notable_customers",
            "type": "string[]",
            "label": "Named public customers"
          },
          {
            "field": "launched_at",
            "type": "string",
            "label": "Launch date (ISO date or year)"
          }
        ]
      },
      {
        "action": "token",
        "label": "Optional - raise your rate limit",
        "method": "GET",
        "url": "https://apio.sh/api/feedback/token"
      }
    ]
  }
}