CorefinityCorefinityDocs
Open the Control PanelControl Panel
Billing · 14 of 16

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.

POST/api/corestack/billing/quote

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.

Body

accountinteger

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.

changesarray of objectsRequired

Up to 10 items.

Fields of each item
addonsobject

For new_site and new_cluster, the add-ons to price with it.

Fields
coresinteger

0 to 512.

disk_gbinteger

Extra disk in GB, 102400 (100 TB) at most.

memory_gbinteger

0 to 4096.

coresinteger

0 to 512.

disk_gbinteger

Extra disk in GB, 102400 (100 TB) at most.

environmentsarray of objects

For new_site, the staging environments to price with it. Up to 10 items.

Fields of each item
uat_sizestringRequired

Up to 16 characters.

familystring

The server type. general is Standard and optimised is Performance.

generaloptimised
log_storage_gbinteger

0 to 65536.

memory_gbinteger

0 to 4096.

packagestring

A package code, such as CC12. Up to 16 characters.

regionstring

Up to 16 characters.

subjectobject

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
idintegerRequired

At least 1.

typestringRequired
siteclusterenvironment
typestringRequired
packageaddonsuat_sizecompute_familynew_sitenew_cluster
uat_sizestring

A staging environment size, such as small. Up to 16 characters.

Returns

200 The quote.

Fields of the 200 answer
appliesstringRequired

none when the changes alter nothing.

nownone
currencystringRequired
effective_fromstringRequired

The hour the new price would start from. Format: date-time.

expires_atstringRequired

Until when the quote's id is taken as quote_id. Format: date-time.

idstringRequired

Format: uuid.

linesarray of objectsRequired
Fields of each item
afterobjectRequired
Fields
amountstringRequired
currencystringRequired
beforeobject or any or nullRequired

The monthly price now, or null for something new.

deltaobjectRequired
Fields
amountstringRequired
currencystringRequired
keystringRequired

What the line is, such as package, addons or uat.

labelstringRequired
monthly_afterobjectRequired
Fields
amountstringRequired
currencystringRequired
monthly_beforeobjectRequired
Fields
amountstringRequired
currencystringRequired
monthly_deltaobjectRequired
Fields
amountstringRequired
currencystringRequired
prorataobjectRequired

What the change adds for the rest of this month, from the hour it would start.

Fields
amountobjectRequired
Fields
amountstringRequired
currencystringRequired
fromstringRequired

Format: date-time.

hoursintegerRequired
tostringRequired

Format: date-time.

taxobjectRequired

The VAT on the monthly difference.

Fields
amountobjectRequired
Fields
amountstringRequired
currencystringRequired
kindstringRequired
notestring or nullRequired
rate_percentnumberRequired
trialobject or any or nullRequired

While the contract is in its free trial, when the trial ends and what is charged now. Otherwise null.

If it is refused

StatusReasonWhat to do
401noneSend a valid token as Authorization: Bearer <token>.
403billing_forbiddenBilling is for the organisation's owner and billing contacts. Ask one of them to do this.
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.
409billing_settlingThis environment has just been moved and its billing is still being updated. Try again in a few minutes.
409contract_missingThere 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.
409downgradeA smaller package cannot be chosen here. Choose a larger one; downgrades are arranged with support.
409same_familyThis is already the server type. Choose a different one.
409same_packageThis is already the package. Choose a different one.
422invalidFix the field named in field; errors says why.
422package_unknownThat is not a package Corefinity sells for this. Choose one from the catalogue.
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 -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"
      }
    ]
  }'
{
  "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
}
Try it
Held in this tab's memory only. Never stored or sent to us.

This sends a real POST request and changes your account.

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

Was this helpful?
Open in ClaudeOpen in ChatGPT