List a site's Magento stores
Reads Magento's websites, store views, base URLs and mapped addresses. The result may be reused for 60 seconds; a save checks Magento again.
Path parameters
The id of a site row. A website's production site and each of its environments has its own id. Digits only. At least 1.
Returns
200 The stores, their addresses, both versions and any warnings.
Fields of the 200 answer
Addresses without their own store choice, including the platform address.
The explicit default, or Magento's default website when none was selected.
At least 0.
At least 0.
Format: date-time.
Extra store addresses set up by support. Non-empty makes customer store changes read-only.
Non-blocking warnings such as base_url_elsewhere, base_url_host_unchosen, store_codes_in_urls and store_not_shown.
Fields of each item
Fields of each item
The base URL is on a host not showing this store.
The base URL is on the site's preview address, primary domain or its www form and can move automatically with a store domain.
Fields of each item
The base URL is on a host not showing this store.
The base URL is on the site's preview address, primary domain or its www form and can move automatically with a store domain.
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. |
404 | not_magento | Only a Magento 2 site has Magento stores. Choose a Magento 2 site. |
409 | stale | What you read has changed since you read it. Read it again, then send the change with its new version or quote. |
409 | store_hosts | This site serves extra Magento stores on their own addresses. Ask Corefinity support to change its domains. |
409 | store_mapping_unreadable | The store mapping in this site's nginx rules has been edited by hand. Remove the edit in the Nginx tab, or ask Corefinity support. |
429 | rate_limited | Wait for the seconds in Retry-After. |
502 | stores_unreadable | Magento's stores could not be read. Try again in a moment. |
503 | switched_off | Corefinity has switched this action off for the moment. Try again later. |
Reasons are listed by name in Errors and refusals.
The same task elsewhere
curl https://manage.corefinity.com/api/corestack/sites/1042/magento/stores \
-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/sites/1042/magento/stores');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/magento/stores', {
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/sites/1042/magento/stores",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"default_hosts": [
"shop.example.com"
],
"default_store": {
"code": "base",
"type": "website"
},
"domains_version": 0,
"nginx_version": 0,
"read_at": "2026-11-11T12:00:00Z",
"store_hosts": [],
"warnings": [],
"websites": [
{
"active": true,
"base_url": "https://shop.example.com/",
"base_url_elsewhere": false,
"base_url_own": true,
"code": "base",
"default_group_id": 1,
"id": 1,
"is_default": true,
"name": "Main shop",
"shown_on": [
"shop.example.com"
],
"store_views": [
{
"active": true,
"base_url": "https://shop.example.com/",
"base_url_elsewhere": true,
"base_url_own": true,
"code": "default",
"group_id": 1,
"id": 1,
"is_active": true,
"name": "English",
"shown_on": [],
"website_id": 1
}
]
}
]
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"code": "stale",
"message": "This site changed in the meantime. Reload.",
"reason": "stale"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}{
"code": "stores_unreadable",
"message": "Magento's stores could not be read. Try again in a moment.",
"reason": "stores_unreadable"
}{
"code": "switched_off",
"message": "Site commands are switched off at the moment",
"reason": "switched_off"
}Try it is off for this endpointIt has not been cleared for the console. Copy the request and run it yourself when you are sure.