CorefinityCorefinityDocs
Open the Control PanelControl Panel
Logs · 12 of 25

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
csvjson
idstringRequired

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.

preparingreadyexpiredfailed
truncatedbooleanRequired

True when the file was cut at 50,000 lines or 64 MiB.

If it is refused

StatusReasonWhat to do
401noneSend a valid token as Authorization: Bearer <token>.
403company_unavailableYour company is unavailable.
403scope_requiredUse a token with the scope named in scope.
403two_factor_requiredTurn on two-factor on your account, then send again.
404feature_offThis feature is not on for your organisation yet.
429rate_limitedWait 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"
{
  "bytes": 9873412,
  "error": null,
  "expires_at": "2026-11-04T10:00:00Z",
  "format": "csv",
  "id": "01JB2Y8N7Q4X3R5T6V8W9Z0A1B",
  "lines": 41220,
  "state": "ready",
  "truncated": false
}
Try it
Held in this tab's memory only. Never stored or sent to us.

Use a token with only the read scope. How to make one

Was this helpful?
Open in ClaudeOpen in ChatGPT