Check a company's Marketplace keys
Asks the Magento repository again what the saved keys can install and answers the keys with the new result. Up to 6 checks an hour for each company.
POST/ api/ companies/ {company}/ magento-keys/ check
Path parameters
companyintegerRequired
The id of a company you belong to or manage. Digits only. At least 1.
Returns
200 The keys, checked again.
Fields of the 200 answer
agencystring or null
can_changebooleanRequired
commerce_sitesobject
The Adobe Commerce sites that use the keys.
Fields
countinteger
sitesarray
entitlementsobjectRequired
What the keys can install.
Fields
checked_atstring or nullRequired
Format: date-time.
commercebooleanRequired
errorstring or nullRequired
open_sourcebooleanRequired
fallbackstring or null
public_key_last4string or nullRequired
sourcestringRequired
Where the keys come from: company for the company's own, none when there are none. Other values name keys the company inherits.
updated_atstring or nullRequired
Format: date-time.
updated_byobject or any or nullRequired
Who saved the keys.
verified_atstring or nullRequired
Format: date-time.
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 | 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. |
429 | rate_limited | Wait for the seconds in Retry-After. |
502 | none | Read the message; it says what happened. |
Reasons are listed by name in Errors and refusals.
The same task elsewhere
curl -X POST https://manage.corefinity.com/api/companies/1204/magento-keys/check \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json"use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->post('https://manage.corefinity.com/api/companies/1204/magento-keys/check');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/companies/1204/magento-keys/check', {
method: 'POST',
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.post(
"https://manage.corefinity.com/api/companies/1204/magento-keys/check",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"agency": "own",
"can_change": true,
"commerce_sites": {
"count": 0,
"sites": []
},
"entitlements": {
"checked_at": "2026-11-19T08:00:00Z",
"commerce": true,
"error": null,
"open_source": true
},
"fallback": "none",
"public_key_last4": "3f9a",
"source": "company",
"updated_at": "2026-11-19T08:00:00Z",
"updated_by": {
"agency": null,
"id": 2012,
"name": "Daniel Reyes"
},
"verified_at": "2026-11-19T08:00:00Z"
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"code": "rate_limited",
"message": "The keys were checked several times in the last hour. Try again later.",
"reason": "rate_limited",
"retry_after_seconds": 1700
}{
"keys": {
"agency": "string",
"can_change": true,
"commerce_sites": {
"count": 1,
"sites": [
null
]
},
"entitlements": {
"checked_at": "2026-11-09T20:14:07Z",
"commerce": true,
"error": "string",
"open_source": true
},
"fallback": "string",
"public_key_last4": "string",
"source": "string",
"updated_at": "2026-11-09T20:14:07Z",
"updated_by": {
"id": 1,
"name": "string"
},
"verified_at": "2026-11-09T20:14:07Z"
},
"message": "string"
}Try it
Was this helpful?