Preview the price of changes
Prices up to ten changes against the billing account and answers what each costs a month, the monthly total before and after, the amount for the rest of this month and its VAT; nothing is changed and nothing is charged. Send the quote's id as quote_id with the change itself (a package, add-on or server type change) until expires_at, 15 minutes later, to make it at the price you were shown. A quote is for the company's owner and its billing contacts.
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.
Body
The billing account to price against, by its id. Left out, your company's default one. account_id is taken as the same field. At least 1.
Up to 10 items.
Fields of each item
For new_site and new_cluster, the add-ons to price with it.
Fields
0 to 512.
Extra disk in GB, 102400 (100 TB) at most.
0 to 4096.
0 to 512.
Extra disk in GB, 102400 (100 TB) at most.
For new_site, the staging environments to price with it. Up to 10 items.
Fields of each item
Up to 16 characters.
The server type. general is Standard and optimised is Performance.
generaloptimised0 to 65536.
0 to 4096.
A package code, such as CC12. Up to 16 characters.
Up to 16 characters.
What is changed. A package, addons or compute_family change is for a site or a CoreCluster; a uat_size change is for an environment.
Fields
At least 1.
siteclusterenvironmentpackageaddonsuat_sizecompute_familynew_sitenew_clusterA staging environment size, such as small. Up to 16 characters.
Returns
200 The quote.
Fields of the 200 answer
none when the changes alter nothing.
nownoneThe hour the new price would start from. Format: date-time.
Until when the quote's id is taken as quote_id. Format: date-time.
Format: uuid.
Fields of each item
Fields
The monthly price now, or null for something new.
Fields
What the line is, such as package, addons or uat.
Fields
Fields
Fields
What the change adds for the rest of this month, from the hour it would start.
Fields
Fields
Format: date-time.
Format: date-time.
The VAT on the monthly difference.
Fields
Fields
While the contract is in its free trial, when the trial ends and what is charged now. Otherwise null.
If it is refused
| Status | Reason | What to do |
|---|---|---|
401 | none | Send a valid token as Authorization: Bearer <token>. |
403 | billing_forbidden | Billing is for the organisation's owner and billing contacts. Ask one of them to do this. |
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. |
409 | billing_settling | This environment has just been moved and its billing is still being updated. Try again in a few minutes. |
409 | contract_missing | There is no billing contract to price this against. Ask support to set up billing, or make the change without a quote where that is offered. |
409 | downgrade | A smaller package cannot be chosen here. Choose a larger one; downgrades are arranged with support. |
409 | same_family | This is already the server type. Choose a different one. |
409 | same_package | This is already the package. Choose a different one. |
422 | invalid | Fix the field named in field; errors says why. |
422 | package_unknown | That is not a package Corefinity sells for this. Choose one from the catalogue. |
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 -X POST https://manage.corefinity.com/api/corestack/billing/quote \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"changes": [
{
"family": "general",
"package": "CC8",
"region": "uk",
"type": "new_cluster"
}
]
}'use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->post('https://manage.corefinity.com/api/corestack/billing/quote', [
'changes' => [
[
'family' => 'general',
'package' => 'CC8',
'region' => 'uk',
'type' => 'new_cluster',
],
],
]);
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/billing/quote', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({
changes: [
{
family: 'general',
package: 'CC8',
region: 'uk',
type: 'new_cluster',
},
],
}),
});
// 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.post(
"https://manage.corefinity.com/api/corestack/billing/quote",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
json={
"changes": [
{
"family": "general",
"package": "CC8",
"region": "uk",
"type": "new_cluster",
},
],
},
)
data = res.json() if res.content else None{
"applies": "now",
"currency": "GBP",
"effective_from": "2027-01-18T11:00:00Z",
"expires_at": "2027-01-18T10:30:00Z",
"id": "c798dc86-3497-421e-a481-91bac3c92fd9",
"lines": [
{
"after": {
"amount": "900.00",
"currency": "GBP"
},
"before": {
"amount": "600.00",
"currency": "GBP"
},
"delta": {
"amount": "300.00",
"currency": "GBP"
},
"key": "package",
"label": "Package: CC8 → CC12"
}
],
"monthly_after": {
"amount": "900.00",
"currency": "GBP"
},
"monthly_before": {
"amount": "600.00",
"currency": "GBP"
},
"monthly_delta": {
"amount": "300.00",
"currency": "GBP"
},
"prorata": {
"amount": {
"amount": "131.05",
"currency": "GBP"
},
"from": "2027-01-18T11:00:00Z",
"hours": 325,
"to": "2027-02-01T00:00:00Z"
},
"tax": {
"amount": {
"amount": "60.00",
"currency": "GBP"
},
"kind": "standard",
"note": "UK VAT 20 %",
"rate_percent": 20
},
"trial": null
}{
"message": "Unauthenticated."
}{
"code": "billing_forbidden",
"message": "Billing is available to your company's owner and billing contacts.",
"reason": "billing_forbidden"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"code": "billing_settling",
"message": "This environment has just been moved and its billing is still being updated. Try again in a few minutes.",
"reason": "billing_settling"
}{
"code": "invalid",
"errors": {
"changes.0.disk_gb": [
"The changes.0.disk_gb may not be greater than 102400."
]
},
"field": "changes.0.disk_gb",
"message": "The changes.0.disk_gb may not be greater than 102400.",
"reason": "invalid"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}