Get a site's redirects
Answers the redirect rules in the order they are tried, with the version every save sends back and the domains a rule can be limited to.
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 redirect set.
Fields of the 200 answer
Whether a saved set of rules is live on the site.
Fields
Sent only by the sets that have more to say, such as HTTP authentication.
The change that is applying the set, while one is running.
Such as applied or applying.
The domains a rule can be limited to.
Fields of each item
The domain's role, such as primary or alias.
The formats import and export take.
Whether a rule can be limited to some domains at the moment.
The domains the site answers on.
Fields
Fields of each item
The domains the rule is limited to. Null for every domain.
The rule's id. Null for a rule that is not saved yet, as in an import or a test of unsaved rules.
The rule's place in the table, starting at 1. A rule whose path is the address asked for (an exact rule, or a prefix rule's own path) is taken first, whatever its position. Otherwise prefix and regex rules are tried in this order, and the first match wins. On a domain, the rules limited to it are taken this way before the rules for every domain.
The id of an earlier rule that always answers first, so this one never matches.
301302exactprefixregexIf 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. |
409 | deleted | The site, environment or copy has been deleted, or is being deleted. Nothing can be changed on it. Restore a deleted site first if it can still be restored. |
409 | provisioning | The site is still being created. Try again in a few minutes. |
429 | rate_limited | Wait for the seconds in Retry-After. |
Reasons are listed by name in Errors and refusals.
The same task elsewhere
curl https://manage.corefinity.com/api/corestack/sites/1042/redirects \
-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/redirects');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/redirects', {
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/redirects",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"apply": {
"applied_at": "2026-11-02T15:41:09Z",
"error": null,
"operation": null,
"state": "applied",
"state_label": "Applied"
},
"available_hosts": [
{
"host": "harbourandfinch.example.com",
"role": "primary"
},
{
"host": "www.harbourandfinch.example.com",
"role": "alias"
}
],
"formats": [
"nginx",
"apache",
"csv"
],
"host_scoping": true,
"hosts": [
"harbourandfinch.example.com",
"www.harbourandfinch.example.com"
],
"limits": {
"from_max": 2000,
"import_max_bytes": 524288,
"regex_max": 256,
"rules_max": 2000,
"to_max": 2000
},
"rules": [
{
"enabled": true,
"from": "/about-us.html",
"hosts": null,
"id": 41,
"keep_query": true,
"note": "Old brochure page",
"position": 1,
"shadowed_by": null,
"status": 301,
"to": "/about",
"type": "exact"
},
{
"enabled": true,
"from": "/blog",
"hosts": [
"www.harbourandfinch.example.com"
],
"id": 42,
"keep_query": true,
"note": null,
"position": 2,
"shadowed_by": null,
"status": 301,
"to": "/news",
"type": "prefix"
}
],
"version": 12
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"code": "deleted",
"message": "This site is deleted and waiting to be purged. Restore it first.",
"reason": "deleted"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}