# QueryExecutionStatus
<a name="API_QueryExecutionStatus"></a>

The completion date, current state, submission time, and state change reason (if applicable) for the query execution.

## Contents
<a name="API_QueryExecutionStatus_Contents"></a>

 ** AthenaError **   <a name="athena-Type-QueryExecutionStatus-AthenaError"></a>
Provides information about an Athena query error.  
Type: [AthenaError](API_AthenaError.md) object  
Required: No

 ** CompletionDateTime **   <a name="athena-Type-QueryExecutionStatus-CompletionDateTime"></a>
The date and time that the query completed.  
Type: Timestamp  
Required: No

 ** State **   <a name="athena-Type-QueryExecutionStatus-State"></a>
The state of query execution. `QUEUED` indicates that the query has been submitted to the service, and Athena will execute the query as soon as resources are available. `RUNNING` indicates that the query is in execution phase. `SUCCEEDED` indicates that the query completed without errors. `FAILED` indicates that the query experienced an error and did not complete processing. `CANCELLED` indicates that a user input interrupted query execution.  
For queries that experience certain transient errors, the state transitions from `RUNNING` back to `QUEUED`. The `FAILED` state is always terminal with no automatic retry. 
Type: String  
Valid Values: `QUEUED | RUNNING | SUCCEEDED | FAILED | CANCELLED`   
Required: No

 ** StateChangeReason **   <a name="athena-Type-QueryExecutionStatus-StateChangeReason"></a>
Further detail about the status of the query.  
Type: String  
Required: No

 ** SubmissionDateTime **   <a name="athena-Type-QueryExecutionStatus-SubmissionDateTime"></a>
The date and time that the query was submitted.  
Type: Timestamp  
Required: No

## See Also
<a name="API_QueryExecutionStatus_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/athena-2017-05-18/QueryExecutionStatus) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/athena-2017-05-18/QueryExecutionStatus) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/athena-2017-05-18/QueryExecutionStatus)