---
title: "GET /journal-s3-exports"
method: GET
path: "/journal-s3-exports"
---

# GET /journal-s3-exports

`GET /journal-s3-exports`

Returns an array of journal export job descriptions for all ledgers that are associated with the current Amazon Web Services account and Region.

This action returns a maximum of `MaxResults` items, and is paginated so that you can retrieve all the items by calling `ListJournalS3Exports` multiple times.

This action does not return any expired export jobs. For more information, see [Export job expiration](https://docs.aws.amazon.com/qldb/latest/developerguide/export-journal.request.html#export-journal.request.expiration) in the _Amazon QLDB Developer Guide_.

## Query parameters

- `max_results` integer
- `next_token` string
- `MaxResults` string
- `NextToken` string

## Response `200`

Success

- ListJournalS3ExportsResponse
  - `JournalS3Exports` JournalS3ExportDescription[] — The array of journal export job descriptions for all ledgers that are associated with the current Amazon Web Services account and Region.
    - `LedgerName` string, required — The name of the ledger.
    - `ExportId` string, required — The UUID (represented in Base62-encoded text) of the journal export job.
    - `ExportCreationTime` string, date-time, required — The date and time, in epoch time format, when the export job was created. (Epoch time format is the number of seconds elapsed since 12:00:00 AM January 1, 1970 UTC.)
    - `Status` 'IN_PROGRESS' | 'COMPLETED' | 'CANCELLED', required — The current state of the journal export job.
    - `InclusiveStartTime` string, date-time, required — The inclusive start date and time for the range of journal contents that was specified in the original export request.
    - `ExclusiveEndTime` string, date-time, required — The exclusive end date and time for the range of journal contents that was specified in the original export request.
    - `S3ExportConfiguration` S3ExportConfiguration, required — The Amazon Simple Storage Service (Amazon S3) bucket location in which a journal export job writes the journal contents.
      - `Bucket` string, required — <p>The Amazon S3 bucket name in which a journal export job writes the journal contents.</p> <p>The bucket name must comply with the Amazon S3 bucket naming conventions. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/BucketRestrictions.html">Bucket Restrictions and Limitations</a> in the <i>Amazon S3 Developer Guide</i>.</p>
      - `Prefix` string, required — <p>The prefix for the Amazon S3 bucket in which a journal export job writes the journal contents.</p> <p>The prefix must comply with Amazon S3 key naming rules and restrictions. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMetadata.html">Object Key and Metadata</a> in the <i>Amazon S3 Developer Guide</i>.</p> <p>The following are examples of valid <code>Prefix</code> values:</p> <ul> <li> <p> <code>JournalExports-ForMyLedger/Testing/</code> </p> </li> <li> <p> <code>JournalExports</code> </p> </li> <li> <p> <code>My:Tests/</code> </p> </li> </ul>
      - `EncryptionConfiguration` object, required — The encryption settings that are used by a journal export job to write data in an Amazon S3 bucket.
        - `ObjectEncryptionType` 'SSE_KMS' | 'SSE_S3' | 'NO_ENCRYPTION', required — <p>The Amazon S3 object encryption type.</p> <p>To learn more about server-side encryption options in Amazon S3, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/serv-side-encryption.html">Protecting Data Using Server-Side Encryption</a> in the <i>Amazon S3 Developer Guide</i>.</p>
        - `KmsKeyArn` string — <p>The Amazon Resource Name (ARN) of a symmetric key in Key Management Service (KMS). Amazon S3 does not support asymmetric KMS keys.</p> <p>You must provide a <code>KmsKeyArn</code> if you specify <code>SSE_KMS</code> as the <code>ObjectEncryptionType</code>.</p> <p> <code>KmsKeyArn</code> is not required if you specify <code>SSE_S3</code> as the <code>ObjectEncryptionType</code>.</p>
    - `RoleArn` string, required — <p>The Amazon Resource Name (ARN) of the IAM role that grants QLDB permissions for a journal export job to do the following:</p> <ul> <li> <p>Write objects into your Amazon Simple Storage Service (Amazon S3) bucket.</p> </li> <li> <p>(Optional) Use your customer managed key in Key Management Service (KMS) for server-side encryption of your exported data.</p> </li> </ul>
    - `OutputFormat` 'ION_BINARY' | 'ION_TEXT' | 'JSON' — The output format of the exported journal data.
  - `NextToken` string — <ul> <li> <p>If <code>NextToken</code> is empty, then the last page of results has been processed and there are no more results to be retrieved.</p> </li> <li> <p>If <code>NextToken</code> is <i>not</i> empty, then there are more results available. To retrieve the next page of results, use the value of <code>NextToken</code> in a subsequent <code>ListJournalS3Exports</code> call.</p> </li> </ul>

---

[API](https://skmtc.net/aws/apis/qldb.md) · [All operations](https://skmtc.net/aws/apis/qldb/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/qldb/versions/40f98f4993d2/schema)