List subscription plans

GEThttps://app.speybooks.com/api/v1/billing/plans

Returns the available subscription plans with pricing and feature lists. Pricing is read live from Stripe, the same Price objects checkout charges, and is reported in pence (minor units). If Stripe is unreachable the declared fallback constants are used, so the call does not fail on a Stripe outage. The trial plan has no Stripe price and reports as "Free". The priceFormatted field is a display-ready string.

Response

200Returns all available subscription plans with pricing and features. Pricing is sourced live from Stripe (cached 5 minutes), the same Price objects checkout charges.

Show response fields

plansarray<object>

Show child attributes

featuresarray<string>

List of features included in the plan.

idstring

Plan identifier (sole_trader, limited_company).

namestring

Human-readable plan name.

priceinteger

Monthly price in pence (minor units).

priceFormattedstring

Formatted price string (for example "£15.00/month"), or "Free" for the trial plan.

RequestGET/v1/billing/planscurl

curl https://api.speybooks.com/v1/billing/plans \
  -H "Authorization: Bearer sk_test_..."

Response200

{
  "success": true,
  "data": {
    "plans": [
      {
        "id": "trial",
        "name": "Trial",
        "price": 0,
        "priceFormatted": "Free",
        "features": [
          "7-day grace period",
          "Full access while you decide"
        ]
      },
      {
        "id": "sole_trader",
        "name": "Sole Trader",
        "price": 1500,
        "priceFormatted": "£15.00/month",
        "features": [
          "Unlimited invoices & expenses",
          "Full API access",
          "Bank reconciliation",
          "Multi-currency (GBP, USD, EUR)",
          "Full data export"
        ]
      },
      {
        "id": "limited_company",
        "name": "Limited Company",
        "price": 2500,
        "priceFormatted": "£25.00/month",
        "features": [
          "Everything in Sole Trader",
          "MTD VAT returns (UK)",
          "Dividend vouchers",
          "Director loan tracking"
        ]
      }
    ]
  }
}