List plans

Changed on

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Lists Base44's plans with their limits, prices, and the IDs you need to change one.

You can call this without credentials. Then currency follows the country the request comes from. With a token, it follows your workspace: a paid workspace sees the currency it pays in, and a free one the currency it can check out in. An invalid or read-only token is ignored, and you get the answer for no credentials.

Prices are in the smallest currency unit, such as cents, and can be null while Base44 can't load them. Retry later rather than treating a null price as free.

Use price_ids with Change plan on a Stripe-billed workspace, and wix_product_id with Change Wix plan on a Wix-billed one.

Plans come in hierarchy order, and the default limit of 100 returns every plan on one page. To page through them, pass a smaller limit and send each next_cursor back as cursor. A cursor carries the rest of the query, so send it alone. hierarchy always lists every plan.

<Warning>The response includes fields beyond the ones documented here. Don't rely on undocumented response fields, as they can change at any time.</Warning>

get/api/billing/tiers

Request

  • Base URL
    https://app.base44.com
  • URL
    https://app.base44.com/api/billing/tiers
  • Auth
    • none
    • or HTTP bearer

Query parameters

limitinteger

Plans per page, 1 to 100. Defaults to 100, which fits every plan.

cursorstring

next_cursor from the previous page. Send it alone.

Response

Every plan, with its limits and prices.

hierarchystring[] required

Plan IDs from smallest to largest.

free_tierstring required

ID of the free plan.

recommended_tierstring required

ID of the plan Base44 recommends.

currency'usd' | 'ils' | 'eur' | 'gbp' | 'brl' required

Currency you're shown and charged in. wix_product_id is for this currency.

next_cursorstring nullable required

Send as cursor to get the next page. null on the last page.

Example response

{
  "tiers": [
    {
      "display_name": "Pro",
      "features": [
        "Unlimited apps",
        "Custom domains"
      ],
      "hidden": false,
      "limits": {
        "monthly_integration_credits": 20000,
        "monthly_message_credits": 500
      },
      "name": "pro",
      "price_ids": {
        "monthly_usd": "price_1QZk4LDr56L89dkKp0Pro0Mo",
        "yearly_usd": "price_1QZk4LDr56L89dkKp0Pro0Yr"
      },
      "pricing": {
        "monthly_usd": 5000,
        "yearly_usd": 48000
      },
      "rank": 4,
      "wix_product_id": "5f0c7a2e-3b91-4d6a-9e0f-2c8b1d4a7e63"
    }
  ],
  "hierarchy": [
    "free",
    "lite",
    "starter",
    "builder",
    "pro",
    "elite"
  ],
  "free_tier": "free",
  "recommended_tier": "pro",
  "currency": "usd",
  "next_cursor": "gAAAAABn7vJ0q2kX"
}

Changes