Get an Enterprise copy
Answers where the copy is and what it copied. A copy that failed says why in failure_reason, and in error what happened and what to do next.
Path parameters
The id of a copy, as a start or a re-sync answers it. Digits only; 0 or an id above 2147483647 is refused 422.
Returns
200 The copy.
Fields of the 200 answer
Fields
What the run copied. Null until it has ended.
When the copy's run last ended. A copy's times are sent in UTC with a +00:00 offset, not Z. Format: date-time.
The copy this one followed, when it was made by a re-sync. At least 1.
When the copy was started. Format: date-time.
The size of the environment's database, measured when the copy started.
For a failed copy, what happened and what to do next.
For a failed copy, the stable code of why.
The size of the environment's files, measured when the copy started.
Whether the copy itself is ready to be finished. The site's own checks are made when you finish it.
When the copy was finished. Format: date-time.
At least 1.
The copy's run, as an operation of the site.
presync until the copy ends, then done (finished, or followed by a newer copy) or failed.
At least 1.
running while the copy runs, waiting once its run has ended, failed when it failed.
Where the copy is: guard, transfer, fixups and check while it runs, copied once its run has ended, superseded when a re-sync followed it, finished when it was finished.
The copy a re-sync made after this one. At least 1.
At least 1.
At least 1.
When the site was last checked to be a copy and not a live site. Format: date-time.
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 | none | Check the id. You see only what your account can reach. |
422 | invalid | Fix the field named in field; errors says why. |
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/enterprise-copies/6201 \
-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/enterprise-copies/6201');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/enterprise-copies/6201', {
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/enterprise-copies/6201",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"copy": {
"copied": {
"at": "2026-11-03T12:41:07+00:00",
"dangling_links": 0,
"db_bytes": 10522669875,
"duration_seconds": 2467,
"files_bytes": 31876710400,
"neutralised_at": "2026-11-03T12:40:12+00:00",
"unreadable_files": 0
},
"copied_at": "2026-11-03T12:41:07+00:00",
"copy_of": null,
"created_at": "2026-11-03T12:00:00+00:00",
"database_bytes": 10737418240,
"error": null,
"failure_reason": null,
"files_bytes": 32212254720,
"finishable": true,
"finished_at": null,
"id": 6201,
"operation": {
"id": 5141,
"status": "completed",
"step": "checked"
},
"phase": "presync",
"source_environment_id": 1311,
"state": "waiting",
"step": "copied",
"superseded_by": null,
"target_cluster_id": 1017,
"target_site_id": 1081,
"unactivated_at": "2026-11-03T12:41:05+00:00"
}
}{
"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"
}{
"message": "Not found."
}{
"code": "invalid",
"errors": {
"copy": [
"The copy must be a whole number from 1 to 2147483647."
]
},
"field": "copy",
"message": "The copy must be a whole number from 1 to 2147483647.",
"reason": "invalid"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}