---
title: "POST /ListTransactions"
method: POST
path: "/ListTransactions"
---

# POST /ListTransactions

`POST /ListTransactions`

Returns metadata about transactions and their status. To prevent the response from growing indefinitely, only uncommitted transactions and those available for time-travel queries are returned.

This operation can help you identify uncommitted transactions or to get information about transactions.

## Query parameters

- `MaxResults` string
- `NextToken` string

## Request body

- object
  - `CatalogId` string — The catalog for which to list transactions. Defaults to the account ID of the caller.
  - `StatusFilter` 'ALL' | 'COMPLETED' | 'ACTIVE' | 'COMMITTED' | 'ABORTED' — A filter indicating the status of transactions to return. Options are ALL | COMPLETED | COMMITTED | ABORTED | ACTIVE. The default is <code>ALL</code>.
  - `MaxResults` integer — The maximum number of transactions to return in a single call.
  - `NextToken` string — A continuation token if this is not the first call to retrieve transactions.

## Response `200`

Success

- ListTransactionsResponse
  - `Transactions` TransactionDescription[] — A list of transactions. The record for each transaction is a <code>TransactionDescription</code> object.
    - `TransactionId` string — The ID of the transaction.
    - `TransactionStatus` 'ACTIVE' | 'COMMITTED' | 'ABORTED' | 'COMMIT_IN_PROGRESS' — A status of ACTIVE, COMMITTED, or ABORTED.
    - `TransactionStartTime` string, date-time — The time when the transaction started.
    - `TransactionEndTime` string, date-time — The time when the transaction committed or aborted, if it is not currently active.
  - `NextToken` string — A continuation token indicating whether additional data is available.

## Other responses

- `480` — InvalidInputException
- `481` — InternalServiceException
- `482` — OperationTimeoutException

---

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