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.
Query parameters
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.
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.
Only one line: cs for CoreStack packages, cc for CoreCluster packages.
csccThe region to price in, uk when left out.
ukusnlausThe currency to price in. Left out, the billing account's.
GBPUSDEURA 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
Fields of each item
The monthly price of one unit on Standard servers.
Fields
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.
Whether Performance servers are offered in the region.
Fields
The same answer for each product line, by its key.
With platform, the packages that cannot run it, each with why.
Fields of each item
Why, in a sentence.
What changes a price, as a percentage, such as the Performance server type or a region.
Fields of each item
Fields of each item
The package's code, such as CC8.
The staging environments a CoreStack package includes at no charge, or null when it includes none.
Fields
How many are included.
The size of the included staging environment, as the catalogue's staging sizes name it.
With platform=shopware, the size the package includes for other platforms, when Shopware gets a larger one.
The same code in lower case, as the package and upgrade routes name it.
The package's money-back guarantee, in days. 0 when it has none.
The monthly price on Standard servers.
Fields
The monthly price on Performance servers, or null where they are not offered.
The platforms the package can run. null when it runs every one.
csccThe site sizes a CoreCluster package takes. null for a CoreStack package.
The package's free trial, in days. 0 when it has none.
The staging environment sizes.
Fields of each item
Fields
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
The country VAT is judged for, as a two-letter code.
How VAT applies, such as standard, reverse_charge or outside_scope.
If it is refused
| Status | Reason | What to do |
|---|---|---|
401 | none | Send a valid token as Authorization: Bearer <token>. |
403 | company_unavailable | Your company is unavailable. |
403 | scope_required | Use a token with the scope named in scope. |
403 | two_factor_required | Turn on two-factor on your account, then send again. |
404 | feature_off | This feature is not on for your organisation yet. |
422 | invalid | Fix the field named in field; errors says why. |
422 | currency_unpublished | Prices in that currency are not available right now. Choose another currency, or try again later. |
422 | zone_unknown | That is not a region. Choose uk, us, nl or aus. |
429 | rate_limited | Wait 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"use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->get('https://manage.corefinity.com/api/corestack/billing/catalogue');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/billing/catalogue', {
method: 'GET',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
},
});
// An answer with no body (204) has nothing to parse.
const text = await res.text();
const data = text && JSON.parse(text);import os
import requests
res = requests.get(
"https://manage.corefinity.com/api/corestack/billing/catalogue",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"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
}
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"code": "invalid",
"errors": {
"account_id": [
"Send account or account_id, not both: they name different billing accounts."
]
},
"field": "account_id",
"message": "Send account or account_id, not both: they name different billing accounts.",
"reason": "invalid"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}