Get a logs export
Answers one of your exports, of a site or of a CoreCluster; only the person who started an export can read it. Read it until state is ready, failed or expired.
GET/ api/ corestack/ logs/ exports/ {download}
Path parameters
downloadstringRequired
The id of an export, as its start answered it. 26 characters.
Returns
200 The export.
Fields of the 200 answer
bytesinteger or nullRequired
The size of the file. Null until it is ready.
errorstring or nullRequired
Why the export failed. Null otherwise.
expires_atstring or nullRequired
When the export can no longer be collected. Format: date-time.
formatstringRequired
csvjsonidstringRequired
The {download} of the export endpoints.
linesinteger or nullRequired
The lines in the file. Null until it is ready.
statestringRequired
preparing, then ready. expired once it was collected or its time ran out. failed when it could not be made.
preparingreadyexpiredfailedtruncatedbooleanRequired
True when the file was cut at 50,000 lines or 64 MiB.
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. |
Reasons are listed by name in Errors and refusals.
The same task elsewhere
curl https://manage.corefinity.com/api/corestack/logs/exports/01JB2Y8N7Q4X3R5T6V8W9Z0A1B \
-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/logs/exports/01JB2Y8N7Q4X3R5T6V8W9Z0A1B');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/logs/exports/01JB2Y8N7Q4X3R5T6V8W9Z0A1B', {
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/logs/exports/01JB2Y8N7Q4X3R5T6V8W9Z0A1B",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"bytes": 9873412,
"error": null,
"expires_at": "2026-11-04T10:00:00Z",
"format": "csv",
"id": "01JB2Y8N7Q4X3R5T6V8W9Z0A1B",
"lines": 41220,
"state": "ready",
"truncated": false
}{
"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": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}Try it
Was this helpful?