Plans

Base URL: $BUSINESS_API

The object

idstring · optional
codestring · optional
namestring · optional

Display name in the caller's language on reads

taglinestring · optional

Tagline in the caller's language on reads

name_i18nobject · optional

One text per language, keyed by language tag (pt, en, pt-MZ).

tagline_i18nobject · optional

One text per language, keyed by language tag (pt, en, pt-MZ).

default_namestring · optional

Platform plan list only; the default name behind a localised name

default_taglinestring · optional

Platform plan list only; the default tagline

price_centsinteger · optional
currencystring · optional
max_connectionsinteger · optional
max_usersinteger · optional
max_accountsinteger · optional

Maximum accounts owned by the subscribed organization's legal entity; 0 means no plan cap

max_sandboxesinteger · optional
trial_daysinteger · optional
overage_connection_centsinteger · optional
overage_user_centsinteger · optional
capabilitiesarray of string · optional
capability_labelsarray of CapabilityLabel · optional

The capabilities labelled in the caller's language (reads)

Show child attributes
codestring · required
labelstring · required

The capability's label in the caller's language

publishedboolean · optional
display_orderinteger · optional
highlightedboolean · optional
created_atstring (date-time) · optional
Endpoints
The object
{
  "id": "pla_2lVU4nTwUfHw6nxUwjbOeRn8u5D",
  "code": "COD-2026-000142",
  "name": "Ana Matsinhe",
  "tagline": "tagline",
  "name_i18n": {
    "en": "Up to 100 customers",
    "pt": "Até 100 clientes"
  },
  "tagline_i18n": {
    "en": "Up to 100 customers",
    "pt": "Até 100 clientes"
  },
  "default_name": "Ana Matsinhe",
  "default_tagline": "default tagline",
  "price_cents": 125000,
  "currency": "MZN",
  "max_connections": 1,
  "max_users": 1,
  "max_accounts": 1,
  "max_sandboxes": 1,
  "trial_days": 1,
  "overage_connection_cents": 1,
  "overage_user_cents": 1,
  "capabilities": [
    "configure"
  ],
  "capability_labels": [
    {
      "code": "COD-2026-000142",
      "label": "label"
    }
  ],
  "published": true,
  "display_order": 1,
  "highlighted": true,
  "created_at": "2026-11-19T09:30:00Z"
}

List the plans a utility may choose from

Logs

GET /plans

Returns the published plans plus the tenant's own plan, wrapped in a data array, with the offers beside them (the custom offer past the largest plan). Name, tagline, capability labels and offer text are in the caller's language: lang, else Accept-Language, else the plan's default text. Clients show these and build no plan text of their own. Requires the business:subscription:read permission. The list is not paginated.

Parameters

limitinteger · query · optional

Maximum resources to return (default 20, maximum 100).

afterstring · query · optional

Opaque cursor returned by the previous page.

langstring · query · optional

The language to answer plan text in, as a language tag (pt, en, pt-MZ). It wins over Accept-Language. A language without a translation falls back to the plan's default text.

Accept-Languagestring · header · optional

The caller's languages by preference, used when lang is not sent.

Returns

200 Plans

Show attributes
dataarray of Plan · optional
Show child attributes
idstring · optional
codestring · optional
namestring · optional

Display name in the caller's language on reads

taglinestring · optional

Tagline in the caller's language on reads

name_i18nobject · optional

One text per language, keyed by language tag (pt, en, pt-MZ).

tagline_i18nobject · optional

One text per language, keyed by language tag (pt, en, pt-MZ).

default_namestring · optional

Platform plan list only; the default name behind a localised name

default_taglinestring · optional

Platform plan list only; the default tagline

price_centsinteger · optional
currencystring · optional
max_connectionsinteger · optional
max_usersinteger · optional
max_accountsinteger · optional

Maximum accounts owned by the subscribed organization's legal entity; 0 means no plan cap

max_sandboxesinteger · optional
trial_daysinteger · optional
overage_connection_centsinteger · optional
overage_user_centsinteger · optional
capabilitiesarray of string · optional
capability_labelsarray of CapabilityLabel · optional

The capabilities labelled in the caller's language (reads)

Show child attributes
codestring · required
labelstring · required

The capability's label in the caller's language

publishedboolean · optional
display_orderinteger · optional
highlightedboolean · optional
created_atstring (date-time) · optional
offersarray of PlanOffer · optional

Offers listed beside the plans; the custom offer (code custom) when a published plan has a connection limit.

Show child attributes
codestring · required
labelstring · required

Title in the caller's language

textstring · required

One line in the caller's language

ctastring · required

The link's wording in the caller's language

label_i18nobject · optional

One text per language, keyed by language tag (pt, en, pt-MZ).

text_i18nobject · optional

One text per language, keyed by language tag (pt, en, pt-MZ).

cta_i18nobject · optional

One text per language, keyed by language tag (pt, en, pt-MZ).

contact_pathstring · required

Path on the public site to contact sales

above_connectionsinteger · required

The active connection count the offer starts above

Errors 403

Permissions business:subscription:read · Roles: admin, analyst, finance, owner, viewer

curl -X GET "$BUSINESS_API/plans" \
  -H "Authorization: Bearer sk_test_..."
Response 200
{
  "data": [
    {
      "id": "pla_2lVU4nTwUfHw6nxUwjbOeRn8u5D",
      "code": "COD-2026-000142",
      "name": "Ana Matsinhe",
      "tagline": "tagline",
      "name_i18n": {
        "en": "Up to 100 customers",
        "pt": "Até 100 clientes"
      },
      "tagline_i18n": {
        "en": "Up to 100 customers",
        "pt": "Até 100 clientes"
      },
      "default_name": "Ana Matsinhe",
      "default_tagline": "default tagline",
      "price_cents": 125000,
      "currency": "MZN",
      "max_connections": 1,
      "max_users": 1,
      "max_accounts": 1,
      "max_sandboxes": 1,
      "trial_days": 1,
      "overage_connection_cents": 1,
      "overage_user_cents": 1,
      "capabilities": [
        "configure"
      ],
      "capability_labels": [
        {
          "code": "COD-2026-000142",
          "label": "label"
        }
      ],
      "published": true,
      "display_order": 1,
      "highlighted": true,
      "created_at": "2026-11-19T09:30:00Z"
    }
  ],
  "offers": [
    {
      "code": "custom",
      "label": "label",
      "text": "text",
      "cta": "cta",
      "label_i18n": {
        "en": "Up to 100 customers",
        "pt": "Até 100 clientes"
      },
      "text_i18n": {
        "en": "Up to 100 customers",
        "pt": "Até 100 clientes"
      },
      "cta_i18n": {
        "en": "Up to 100 customers",
        "pt": "Até 100 clientes"
      },
      "contact_path": "/contact?topic=sales",
      "above_connections": 1
    }
  ]
}