CorefinityCorefinityDocs
Open the Control PanelControl Panel
Application versions · 1 of 4

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.

GET/api/app-versions

Query parameters

platformstring

One platform only, such as wordpress, magento2, laravel or shopware.

placementstring

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
catalogue_versionstringRequired
platformsarray of objectsRequired
Fields of each item
availablebooleanRequired
default_versionstring or nullRequired
editionsarray of objectsRequired
Fields of each item
availableboolean
defaultboolean
default_versionstring or null
editionstringRequired
labelstringRequired
reasonstring or null

Why not, in plain words. Null when available.

familystring
labelstringRequired
platformstringRequired
reasonstring or nullRequired

Why not, in plain words. Null when available.

versionsarray of objectsRequired
Fields of each item
acknowledgearray of strings

What acknowledge must carry to create a site on this line, such as eol.

days_leftinteger or null
defaultbooleanRequired
editionstring or nullRequired
emptyobjectRequired

Whether something can be done now and, when it cannot, why not.

Fields
availablebooleanRequired
reasonstring or nullRequired
eol_sincestring or null
eol_stagestringRequired

How close the line is to its end.

nonesoon_90soon_30ended
freshobjectRequired

Whether something can be done now and, when it cannot, why not.

Fields
availablebooleanRequired
reasonstring or nullRequired
held_reasonstring or null
installsstring or nullRequired

The version a fresh install gets.

keystringRequired

The value to send as app_version when you create a site.

labelstringRequired
mariadbobject

The MariaDB versions a site on this line can run.

Fields
defaultstring or nullRequired
pendingarray

Versions that are on their way and cannot be chosen yet.

versionsarray of stringsRequired
notesarray
patchesobject or null

How many security patches a fresh install includes, and through which month.

phpobject

The PHP versions a site on this line can run.

Fields
defaultstring or nullRequired
pendingarray

Versions that are on their way and cannot be chosen yet.

versionsarray of stringsRequired
searchobject or null

The search engine the line needs, when it needs one.

security_untilstring or null

The date security fixes end, when known.

servicesobject or null
statusstringRequired

Such as active, security or eol.

tagstring or null

Such as latest or recommended.

warningstring or null

If it is refused

StatusReasonWhat to do
401noneSend a valid token as Authorization: Bearer <token>.
403scope_requiredUse a token with the scope named in scope.
404feature_offThis feature is not on for your organisation yet.
422invalidFix the field named in field; errors says why.
429rate_limitedWait for the seconds in Retry-After.
503catalogue_unavailableApplication 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"
{
  "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
    }
  ]
}
Try it
Held in this tab's memory only. Never stored or sent to us.

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

Was this helpful?
Open in ClaudeOpen in ChatGPT