List your orders
Answers your company's orders for new sites and CoreClusters, newest first, 25 a page, with how many there are in each state; the company's owner and its billing contacts see every order with who placed it. kind, user_id and search narrow the rows and the counts alike, and total counts every order whatever the filters. Paged by cursor: send next_cursor back as cursor; null means the last page.
Query parameters
Only orders in this state. open is in progress or being built; ended is cancelled or expired. Defaults to all.
allopencompletedfailedendedOnly orders for a site, or only orders for a CoreCluster.
siteclusterOnly orders placed by this person, an id from placers. At least 1.
An order number, a domain or a CoreCluster's name. Up to 100 characters.
The next_cursor of the previous answer. Anything that is not a whole number is refused 422 on cursor.
Returns
200 A page of orders.
Fields of the 200 answer
Send as cursor to read the next page. Null on the last page.
Fields
How many orders are in each state, after kind, user_id and search.
Fields
Fields of each item
For your own order in progress, where to carry on.
Format: date-time.
When the order completed, failed, was cancelled or expired. Format: date-time.
The order number. At least 1.
in_progressbuildingcompletedfailedcancelledexpiredcsccnullWhether you placed it. Only the person who placed an order can continue it.
The site's domain or the CoreCluster's name.
For an order being built, how far it is.
requestingretryingno_roomnullWhen the order was placed. null for one that was not. Format: date-time.
The platform of a CoreStack site, by its name.
Where the order stands, in a sentence.
For an order that was cancelled, expired or failed, the order page with the same choices made.
The order's status page, as a path.
For an order in progress, the step it stopped at.
packageupgradesaccountverifybillingreviewnullFor a completed order, the site or CoreCluster it made, with its page in the Control Panel.
Format: date-time.
Fields
Whether Corefinity still has to check the order's VAT.
The people who placed one of the orders.
Fields of each item
At least 1.
Where a new order starts, as a path.
How many orders there are, whatever the filters.
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 | orders_forbidden | Orders are for the organisation's owner and people with a billing role. Ask one of them. |
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. |
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/orders \
-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/orders');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/orders', {
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/orders",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"company": {
"name": "Northwind Digital"
},
"counts": {
"all": 3,
"completed": 1,
"ended": 1,
"failed": 0,
"open": 1
},
"data": [
{
"continue_href": null,
"created_at": "2027-01-18T09:31:00Z",
"ended_at": null,
"id": 4227,
"label": "building",
"line": "cs",
"line_label": "CoreStack",
"mine": true,
"name": "journal.harbourandfinch.example.com",
"package": "CS2",
"phase": "requesting",
"placed_at": "2027-01-18T09:40:00Z",
"placed_by": {
"name": "Maya Okafor"
},
"platform": "WordPress",
"reason": "Placed · your site is being requested",
"region": {
"key": "uk",
"label": "United Kingdom"
},
"restart_href": null,
"status_href": "/order/status/4227",
"step": null,
"step_label": null,
"target": null,
"trial_ends_at": null,
"vat": {
"check_open": false,
"kind": null,
"status": null
}
},
{
"continue_href": null,
"created_at": "2027-01-10T10:48:00Z",
"ended_at": "2027-01-10T11:20:00Z",
"id": 4218,
"label": "completed",
"line": "cc",
"line_label": "CoreCluster",
"mine": true,
"name": "Northwind UK 1",
"package": "CC8",
"phase": null,
"placed_at": "2027-01-10T11:02:00Z",
"placed_by": {
"name": "Maya Okafor"
},
"platform": null,
"reason": "Completed on 10 Jan 2027",
"region": {
"key": "uk",
"label": "United Kingdom"
},
"restart_href": null,
"status_href": "/order/status/4218",
"step": null,
"step_label": null,
"target": {
"href": "/managed-clusters/clusters/1017",
"kind": "cluster",
"name": "Northwind UK 1"
},
"trial_ends_at": null,
"vat": {
"check_open": false,
"kind": null,
"status": null
}
},
{
"continue_href": null,
"created_at": "2027-01-04T08:00:00Z",
"ended_at": "2027-01-05T08:00:00Z",
"id": 4209,
"label": "expired",
"line": "cs",
"line_label": "CoreStack",
"mine": true,
"name": "harbourandfinch.example.com",
"package": "CS2",
"phase": null,
"placed_at": null,
"placed_by": {
"name": "Maya Okafor"
},
"platform": "WordPress",
"reason": "Not placed before it expired",
"region": {
"key": "uk",
"label": "United Kingdom"
},
"restart_href": "/order?package=CS2&platform=wordpress®ion=uk¤cy=GBP&new=1",
"status_href": "/order/status/4209",
"step": null,
"step_label": null,
"target": null,
"trial_ends_at": null,
"vat": {
"check_open": false,
"kind": null,
"status": null
}
}
],
"next_cursor": null,
"placers": [
{
"id": 2051,
"name": "Maya Okafor"
}
],
"start_href": "/order?new=1",
"total": 3
}{
"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": {
"cursor": [
"The cursor format is invalid."
]
},
"field": "cursor",
"message": "The cursor format is invalid.",
"reason": "invalid"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}