Download archived general ledger journal entry chunk content

GET 
/gljournalentries/archives/{chunkId}/content

Streams the content of one archived chunk of general ledger journal entries, identified by the chunkId returned from the Archive Location API. The chunk is decrypted as it leaves encrypted storage and relayed straight to the caller without ever being written to disk. The chunkId must be given exactly as the Archive Location API returned it. Requires the VIEW_ARCHIVED_JOURNAL_ENTRIES permission.

Request

Responses

200

The archive chunk's content, streamed as a binary attachment.

Response Headers

Content-Disposition

Marks the response as a file attachment and suggests a filename, e.g. attachment; filename="4821.csv".

Content-Length

The exact byte size of the streamed content.

401

Unauthorized

403

Forbidden

404

The chunk does not exist, is not yet archived, or is not available for download.

429

A download limit has been reached. The errorReason identifies the cause: ARCHIVE_DOWNLOAD_CONCURRENCY_LIMIT_REACHED (31022) - too many downloads are already in progress; retry after the number of seconds in the Retry-After header. ARCHIVE_DOWNLOAD_MONTHLY_LIMIT_REACHED (31023) - the monthly download allowance is exhausted; it resets at 00:00 UTC on the 1st of the month, which is what Retry-After reports.

Response Headers

Retry-After

Seconds to wait before retrying.

500

Internal Error

503

The archived Journal Entries data is unavailable. The errorReason identifies the specific cause and errorCode is its numeric code: ARCHIVAL_JOURNALENTRY_NOT_ENABLED (31001) - the archived Journal Entries feature is not enabled; ARCHIVAL_JOURNALENTRY_DATA_NOT_AVAILABLE (31010) - the feature is enabled but no archived data is available yet; ARCHIVE_STORAGE_UNAVAILABLE (31021) - the archive storage could not be reached, or the chunk's stored content is missing.