List a company's sites on ending versions
Answers the sites of a company you belong to or manage sites for whose line is ending or has ended, ended first. An agency reads only the sites it manages.
GET/ api/ companies/ {company}/ app-versions/ attention
Path parameters
companyintegerRequired
The id of a company you belong to or manage. Digits only. At least 1.
Returns
200 The sites that need attention. Empty when none does.
Fields of the 200 answer
sitesarray of objectsRequired
Fields of each item
companyobjectRequired
Fields
idintegerRequired
At least 1.
namestringRequired
days_leftinteger or null
display_versionstring or nullRequired
domainstringRequired
editionstring or null
eol_stagestringRequired
How close the line is to its end.
nonesoon_90soon_30endedlinestring or null
platformstringRequired
security_untilstring or null
site_idintegerRequired
At least 1.
statusstringRequired
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. |
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/companies/1204/app-versions/attention \
-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/companies/1204/app-versions/attention');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/companies/1204/app-versions/attention', {
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/companies/1204/app-versions/attention",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"sites": [
{
"company": {
"id": 1204,
"name": "Harbour & Finch"
},
"days_left": null,
"display_version": "11.9.0",
"domain": "bookings.harbourandfinch.example.com",
"edition": null,
"eol_stage": "ended",
"line": null,
"platform": "laravel",
"security_until": null,
"site_id": 1061,
"status": "eol"
}
]
}{
"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": "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"
}Try it
Was this helpful?