---
title: "POST /#X-Amz-Target=AmazonAthena.ListCalculationExecutions"
method: POST
path: "/#X-Amz-Target=AmazonAthena.ListCalculationExecutions"
---

# POST /#X-Amz-Target=AmazonAthena.ListCalculationExecutions

`POST /#X-Amz-Target=AmazonAthena.ListCalculationExecutions`

Lists the calculations that have been submitted to a session in descending order. Newer calculations are listed first; older calculations are listed later.

## Query parameters

- `MaxResults` string
- `NextToken` string

## Headers

- `X-Amz-Target` 'AmazonAthena.ListCalculationExecutions', required

## Request body

- ListCalculationExecutionsRequest
  - `SessionId` string, required — The session ID.
  - `StateFilter` 'CREATING' | 'CREATED' | 'QUEUED' | 'RUNNING' | 'CANCELING' | 'CANCELED' | 'COMPLETED' | 'FAILED' — <p>A filter for a specific calculation execution state. A description of each state follows.</p> <p> <code>CREATING</code> - The calculation is in the process of being created.</p> <p> <code>CREATED</code> - The calculation has been created and is ready to run.</p> <p> <code>QUEUED</code> - The calculation has been queued for processing.</p> <p> <code>RUNNING</code> - The calculation is running.</p> <p> <code>CANCELING</code> - A request to cancel the calculation has been received and the system is working to stop it.</p> <p> <code>CANCELED</code> - The calculation is no longer running as the result of a cancel request.</p> <p> <code>COMPLETED</code> - The calculation has completed without error.</p> <p> <code>FAILED</code> - The calculation failed and is no longer running.</p>
  - `MaxResults` integer — The maximum number of calculation executions to return.
  - `NextToken` string — A token generated by the Athena service that specifies where to continue pagination if a previous request was truncated. To obtain the next set of pages, pass in the <code>NextToken</code> from the response object of the previous page call.

## Response `200`

Success

- ListCalculationExecutionsResponse
  - `NextToken` string — A token generated by the Athena service that specifies where to continue pagination if a previous request was truncated. To obtain the next set of pages, pass in the <code>NextToken</code> from the response object of the previous page call.
  - `Calculations` CalculationSummary[] — A list of <a>CalculationSummary</a> objects.
    - `CalculationExecutionId` string — The calculation execution UUID.
    - `Description` string — A description of the calculation.
    - `Status` object — Contains information about the status of the calculation.
      - `SubmissionDateTime` string, date-time — The date and time the calculation was submitted for processing.
      - `CompletionDateTime` string, date-time — The date and time the calculation completed processing.
      - `State` 'CREATING' | 'CREATED' | 'QUEUED' | 'RUNNING' | 'CANCELING' | 'CANCELED' | 'COMPLETED' | 'FAILED' — <p>The state of the calculation execution. A description of each state follows.</p> <p> <code>CREATING</code> - The calculation is in the process of being created.</p> <p> <code>CREATED</code> - The calculation has been created and is ready to run.</p> <p> <code>QUEUED</code> - The calculation has been queued for processing.</p> <p> <code>RUNNING</code> - The calculation is running.</p> <p> <code>CANCELING</code> - A request to cancel the calculation has been received and the system is working to stop it.</p> <p> <code>CANCELED</code> - The calculation is no longer running as the result of a cancel request.</p> <p> <code>COMPLETED</code> - The calculation has completed without error.</p> <p> <code>FAILED</code> - The calculation failed and is no longer running.</p>
      - `StateChangeReason` string — The reason for the calculation state change (for example, the calculation was canceled because the session was terminated).

## Other responses

- `480` — InternalServerException
- `481` — InvalidRequestException
- `482` — ResourceNotFoundException

---

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