CorefinityCorefinityDocs
Open the Control PanelControl Panel
Billing · 4 of 16

Get the price catalogue

Answers the packages on sale with their monthly prices, the add-ons with the price of one unit, the staging environment sizes, the price modifiers (the Performance server type, the region) and the VAT that applies to the account. Prices exclude VAT and are in the billing account's currency unless currency names another; everyone who is signed in may read them. Someone who may not read the billing account, and a request whose account is not one of your company's, is not refused: the prices are in pounds sterling unless currency says otherwise, and the three fields of vat are null.

GET/api/corestack/billing/catalogue

Query parameters

accountinteger

The billing account to read, by its id (see GET /corestack/billing/account). Left out, the request acts on your company's default billing account. An account that does not exist and one that is not your company's answer the same 404. At least 1.

account_idinteger

The same as account, under the name the MCP tools use. Send one of the two: when they name different accounts the request is refused 422 invalid on account_id. At least 1.

product_linestring

Only one line: cs for CoreStack packages, cc for CoreCluster packages.

cscc
regionstring

The region to price in, uk when left out.

ukusnlaus
currencystring

The currency to price in. Left out, the billing account's.

GBPUSDEUR
platformstring

A platform key, such as wordpress. The packages that cannot run it are moved to hidden. A key that is not a platform on offer is refused 422 invalid on platform.

Returns

200 The catalogue.

Fields of the 200 answer
addonsarray of objectsRequired
Fields of each item
keystringRequired
labelstringRequired
maxintegerRequired
monthlyobjectRequired

The monthly price of one unit on Standard servers.

Fields
amountstringRequired
currencystringRequired
stepintegerRequired
unitstringRequired
unit_pricesobjectRequired

The monthly price of one unit with six decimal places, by product line and then by server type (general is Standard, optimised is Performance). A line's price is the unit price times the quantity, rounded half to even to pennies.

compute_optimisedobjectRequired

Whether Performance servers are offered in the region.

Fields
availablebooleanRequired
labelstringRequired
product_linesobjectRequired

The same answer for each product line, by its key.

reasonstring or nullRequired
currencystringRequired
hiddenarray of objectsRequired

With platform, the packages that cannot run it, each with why.

Fields of each item
codestringRequired
copystringRequired

Why, in a sentence.

reasonstringRequired
modifiersarray of objectsRequired

What changes a price, as a percentage, such as the Performance server type or a region.

Fields of each item
applies_toarray of stringsRequired
keystringRequired
labelstringRequired
scopestringRequired
value_percentstringRequired
packagesarray of objectsRequired
Fields of each item
codestringRequired

The package's code, such as CC8.

coresnumberRequired
disk_gbnumberRequired
included_uatobject or null

The staging environments a CoreStack package includes at no charge, or null when it includes none.

Fields
countintegerRequired

How many are included.

sizestringRequired

The size of the included staging environment, as the catalogue's staging sizes name it.

steps_up_fromstring

With platform=shopware, the size the package includes for other platforms, when Shopware gets a larger one.

keystringRequired

The same code in lower case, as the package and upgrade routes name it.

log_quota_gbnumber or null
log_retention_daysinteger or null
memory_gibnumberRequired
money_back_daysintegerRequired

The package's money-back guarantee, in days. 0 when it has none.

monthlyobjectRequired

The monthly price on Standard servers.

Fields
amountstringRequired
currencystringRequired
monthly_optimisedobject or any or nullRequired

The monthly price on Performance servers, or null where they are not offered.

namestringRequired
platforms_allowedarray of strings or any or null

The platforms the package can run. null when it runs every one.

product_linestringRequired
cscc
tiersarray of strings or any or null

The site sizes a CoreCluster package takes. null for a CoreStack package.

trial_daysintegerRequired

The package's free trial, in days. 0 when it has none.

platformstring or nullRequired
regionstringRequired
uat_sizesarray of objectsRequired

The staging environment sizes.

Fields of each item
coresnumberRequired
disk_gbnumberRequired
keystringRequired
labelstringRequired
memory_gibnumberRequired
monthlyobjectRequired
Fields
amountstringRequired
currencystringRequired
vatobjectRequired

The VAT that applies to the billing account. Prices exclude it. All three are null when you may not read the account: you are not the company's owner, a billing contact or its primary user, or account names an account that is not your company's.

Fields
countrystring or nullRequired

The country VAT is judged for, as a two-letter code.

kindstring or nullRequired

How VAT applies, such as standard, reverse_charge or outside_scope.

rate_percentnumber or nullRequired

If it is refused

StatusReasonWhat to do
401noneSend a valid token as Authorization: Bearer <token>.
403company_unavailableYour company is unavailable.
403scope_requiredUse a token with the scope named in scope.
403two_factor_requiredTurn on two-factor on your account, then send again.
404feature_offThis feature is not on for your organisation yet.
422invalidFix the field named in field; errors says why.
422currency_unpublishedPrices in that currency are not available right now. Choose another currency, or try again later.
422zone_unknownThat is not a region. Choose uk, us, nl or aus.
429rate_limitedWait for the seconds in Retry-After.

Reasons are listed by name in Errors and refusals.

The same task elsewhere

curl https://manage.corefinity.com/api/corestack/billing/catalogue \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json"
{
  "addons": [
    {
      "key": "core",
      "label": "Extra core",
      "max": 16,
      "monthly": {
        "amount": "45.00",
        "currency": "GBP"
      },
      "step": 1,
      "unit": "core",
      "unit_prices": {
        "cc": {
          "general": "45.000000",
          "optimised": "54.000000"
        },
        "cs": {
          "general": "45.000000",
          "optimised": "54.000000"
        }
      }
    },
    {
      "key": "memory_gb",
      "label": "Extra memory",
      "max": 64,
      "monthly": {
        "amount": "5.00",
        "currency": "GBP"
      },
      "step": 1,
      "unit": "GB",
      "unit_prices": {
        "cc": {
          "general": "5.000000",
          "optimised": "6.000000"
        },
        "cs": {
          "general": "5.000000",
          "optimised": "6.000000"
        }
      }
    }
  ],
  "compute_optimised": {
    "available": true,
    "label": "Performance",
    "product_lines": {
      "cc": {
        "available": true,
        "reason": null
      }
    },
    "reason": null
  },
  "currency": "GBP",
  "hidden": [],
  "modifiers": [
    {
      "applies_to": [
        "cs",
        "cc"
      ],
      "key": "compute_optimised",
      "label": "Performance",
      "scope": "compute_family",
      "value_percent": "20"
    },
    {
      "applies_to": [
        "cs",
        "cc"
      ],
      "key": "region_uk",
      "label": "United Kingdom",
      "scope": "region",
      "value_percent": "0"
    }
  ],
  "packages": [
    {
      "code": "CC4",
      "cores": 4,
      "disk_gb": 200,
      "included_uat": null,
      "key": "cc4",
      "log_quota_gb": 250,
      "log_retention_days": 90,
      "memory_gib": 16,
      "money_back_days": 0,
      "monthly": {
        "amount": "300.00",
        "currency": "GBP"
      },
      "monthly_optimised": {
        "amount": "360.00",
        "currency": "GBP"
      },
      "name": "CoreCluster CC4",
      "platforms_allowed": [
        "wordpress",
        "laravel",
        "magento2"
      ],
      "product_line": "cc",
      "tiers": [
        "S",
        "M",
        "L"
      ],
      "trial_days": 0
    },
    {
      "code": "CC6",
      "cores": 6,
      "disk_gb": 300,
      "included_uat": null,
      "key": "cc6",
      "log_quota_gb": 300,
      "log_retention_days": 90,
      "memory_gib": 24,
      "money_back_days": 0,
      "monthly": {
        "amount": "450.00",
        "currency": "GBP"
      },
      "monthly_optimised": {
        "amount": "540.00",
        "currency": "GBP"
      },
      "name": "CoreCluster CC6",
      "platforms_allowed": [
        "wordpress",
        "laravel",
        "magento2"
      ],
      "product_line": "cc",
      "tiers": [
        "S",
        "M",
        "L"
      ],
      "trial_days": 0
    }
  ],
  "platform": null,
  "region": "uk",
  "uat_sizes": [
    {
      "cores": 0.5,
      "disk_gb": 20,
      "key": "xsmall",
      "label": "Extra small",
      "memory_gib": 2,
      "monthly": {
        "amount": "40.00",
        "currency": "GBP"
      }
    },
    {
      "cores": 1,
      "disk_gb": 50,
      "key": "small",
      "label": "Small",
      "memory_gib": 4,
      "monthly": {
        "amount": "75.00",
        "currency": "GBP"
      }
    }
  ],
  "vat": {
    "country": "GB",
    "kind": "standard",
    "rate_percent": 20
  }
}
Try it
Held in this tab's memory only. Never stored or sent to us.

Use a token with only the read scope. How to make one

Was this helpful?
Open in ClaudeOpen in ChatGPT