List application versions
Answers the lines each platform offers, with what a fresh install gets and the PHP and MariaDB versions each line runs. Send placement to learn which lines one of your CoreClusters or a region can run.
Query parameters
One platform only, such as wordpress, magento2, laravel or shopware.
Where the site would run: cluster:{id} for one of your CoreClusters (the id, with no leading zero), or region:{key} for a region (2 to 8 lower-case letters, such as region:uk).
Returns
200 The lines, by platform.
Fields of the 200 answer
Fields of each item
Fields of each item
Why not, in plain words. Null when available.
Why not, in plain words. Null when available.
Fields of each item
What acknowledge must carry to create a site on this line, such as eol.
Whether something can be done now and, when it cannot, why not.
Fields
How close the line is to its end.
nonesoon_90soon_30endedWhether something can be done now and, when it cannot, why not.
Fields
The version a fresh install gets.
The value to send as app_version when you create a site.
The MariaDB versions a site on this line can run.
Fields
Versions that are on their way and cannot be chosen yet.
How many security patches a fresh install includes, and through which month.
The PHP versions a site on this line can run.
Fields
Versions that are on their way and cannot be chosen yet.
The search engine the line needs, when it needs one.
The date security fixes end, when known.
Such as active, security or eol.
Such as latest or recommended.
If it is refused
| Status | Reason | What to do |
|---|---|---|
401 | none | Send a valid token as Authorization: Bearer <token>. |
403 | scope_required | Use a token with the scope named in scope. |
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. |
503 | catalogue_unavailable | Application versions are unavailable right now. Try again in a few minutes. |
Reasons are listed by name in Errors and refusals.
The same task elsewhere
curl https://manage.corefinity.com/api/app-versions \
-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/app-versions');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/app-versions', {
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/app-versions",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"catalogue_version": "2026-11-08.1",
"platforms": [
{
"available": true,
"default_version": "7.1",
"editions": [],
"family": "wordpress",
"label": "WordPress",
"platform": "wordpress",
"reason": null,
"versions": [
{
"acknowledge": [],
"days_left": null,
"default": true,
"edition": null,
"empty": {
"available": true,
"reason": null
},
"eol_since": null,
"eol_stage": "none",
"fresh": {
"available": true,
"reason": null
},
"held_reason": null,
"installs": "7.1.3",
"key": "7.1",
"label": "WordPress 7.1",
"mariadb": {
"default": "11.8",
"pending": [],
"versions": [
"11.4",
"11.8",
"12.3"
]
},
"notes": [],
"patches": {
"count": 0,
"through": null
},
"php": {
"default": "8.3",
"pending": [],
"versions": [
"8.3",
"8.4",
"8.5"
]
},
"search": null,
"security_until": null,
"services": null,
"status": "active",
"tag": "latest"
}
],
"warning": null
}
]
}{
"message": "Unauthenticated."
}{
"code": "scope_required",
"message": "This access token does not have the destructive scope this needs. Use a token with the destructive scope.",
"reason": "scope_required",
"scope": "destructive"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"code": "invalid",
"errors": {
"platform": [
"That platform is not one we offer."
]
},
"field": "platform",
"message": "That platform is not one we offer.",
"reason": "invalid"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}{
"code": "catalogue_unavailable",
"message": "Application versions are unavailable right now. Try again in a few minutes.",
"reason": "catalogue_unavailable"
}