# Data retrieval APIs for AWS Step Functions
<a name="awsstepfunctions"></a>

AWS Step Functions provides the following APIs for data retrieval.


****  

| Actions | Description | Access level | 
| --- | --- | --- | 
| <a name="states-DescribeActivity"></a>[https://docs.aws.amazon.com/step-functions/latest/apireference/API_DescribeActivity.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DescribeActivity.html) | Describe an activity | Read | 
| <a name="states-DescribeExecution"></a>[https://docs.aws.amazon.com/step-functions/latest/apireference/API_DescribeExecution.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DescribeExecution.html) | Describe an execution | Read | 
| <a name="states-DescribeMapRun"></a>[https://docs.aws.amazon.com/step-functions/latest/apireference/API_DescribeMapRun.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DescribeMapRun.html) | Describe a map run | Read | 
| <a name="states-DescribeStateMachine"></a>[https://docs.aws.amazon.com/step-functions/latest/apireference/API_DescribeStateMachine.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DescribeStateMachine.html) | Describe a state machine | Read | 
| <a name="states-DescribeStateMachineAlias"></a>[https://docs.aws.amazon.com/step-functions/latest/apireference/API_DescribeStateMachineAlias.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DescribeStateMachineAlias.html) | Describe a state machine alias | Read | 
| <a name="states-DescribeStateMachineForExecution"></a>[https://docs.aws.amazon.com/step-functions/latest/apireference/API_DescribeStateMachineForExecution.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DescribeStateMachineForExecution.html) | Describe the state machine for an execution | Read | 
| <a name="states-GetExecutionHistory"></a>[https://docs.aws.amazon.com/step-functions/latest/apireference/API_GetExecutionHistory.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_GetExecutionHistory.html) | Return the history of the specified execution as a list of events | Read | 
| <a name="states-ListActivities"></a>[https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListActivities.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListActivities.html) | List the existing activities | List | 
| <a name="states-ListExecutions"></a>[https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListExecutions.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListExecutions.html) | List the executions of a state machine | List | 
| <a name="states-ListMapRuns"></a>[https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListMapRuns.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListMapRuns.html) | List the map runs of an execution | List | 
| <a name="states-ListStateMachineAliases"></a>[https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListStateMachineAliases.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListStateMachineAliases.html) | List the aliases of a state machine | List | 
| <a name="states-ListStateMachineVersions"></a>[https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListStateMachineVersions.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListStateMachineVersions.html) | List the versions of a state machine | List | 
| <a name="states-ListStateMachines"></a>[https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListStateMachines.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListStateMachines.html) | Lists the existing state machines | List | 
| <a name="states-ListTagsForResource"></a>[https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListTagsForResource.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListTagsForResource.html) | List tags for an AWS Step Functions resource | List | 
| <a name="states-RevealSecrets"></a>[https://docs.aws.amazon.com/step-functions/latest/dg/test-state-isolation.html](https://docs.aws.amazon.com/step-functions/latest/dg/test-state-isolation.html) | Reveal sensitive data from an execution | Read | 
| <a name="states-ValidateStateMachineDefinition"></a>[https://docs.aws.amazon.com/step-functions/latest/apireference/API_ValidateStateMachineDefinition.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_ValidateStateMachineDefinition.html) | Validate a state machine definition | Read |