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

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

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

Gets the current status of a session.

## Headers

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

## Request body

- GetSessionStatusRequest
  - `SessionId` string, required — The session ID.

## Response `200`

Success

- GetSessionStatusResponse
  - `SessionId` string — The session ID.
  - `Status` object — Contains information about the status of the session.
    - `StartDateTime` string, date-time — The date and time that the session started.
    - `LastModifiedDateTime` string, date-time — The most recent date and time that the session was modified.
    - `EndDateTime` string, date-time — The date and time that the session ended.
    - `IdleSinceDateTime` string, date-time — The date and time starting at which the session became idle. Can be empty if the session is not currently idle.
    - `State` 'CREATING' | 'CREATED' | 'IDLE' | 'BUSY' | 'TERMINATING' | 'TERMINATED' | 'DEGRADED' | 'FAILED' — <p>The state of the session. A description of each state follows.</p> <p> <code>CREATING</code> - The session is being started, including acquiring resources.</p> <p> <code>CREATED</code> - The session has been started.</p> <p> <code>IDLE</code> - The session is able to accept a calculation.</p> <p> <code>BUSY</code> - The session is processing another task and is unable to accept a calculation.</p> <p> <code>TERMINATING</code> - The session is in the process of shutting down.</p> <p> <code>TERMINATED</code> - The session and its resources are no longer running.</p> <p> <code>DEGRADED</code> - The session has no healthy coordinators.</p> <p> <code>FAILED</code> - Due to a failure, the session and its resources are no longer running.</p>
    - `StateChangeReason` string — The reason for the session state change (for example, 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)