POST

/#X-Amz-Target=AWSStepFunctions.ListExecutions

http://states.{region}.amazonaws.com/#X-Amz-Target=AWSStepFunctions.ListExecutions

Lists all executions of a state machine or a Map Run. You can list all executions related to a state machine by specifying a state machine Amazon Resource Name (ARN), or those related to a Map Run by specifying a Map Run ARN. Results are sorted by time, with the most recent execution first. If <code>nextToken</code> is returned, there are more results available. The value of <code>nextToken</code> is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged. Each pagination token expires after 24 hours. Using an expired pagination token will return an HTTP 400 InvalidToken error. <note> This operation is eventually consistent. The results are best effort and may not reflect very recent updates and changes. </note> This API action is not supported by <code>EXPRESS</code> state machines.

Access Token Required: API Key

Query Params

maxResultsstring

Pagination limit

nextTokenstring

Pagination token

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request POST \
2     --url 'http://states.{region}.amazonaws.com/#X-Amz-Target=AWSStepFunctions.ListExecutions' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}

1curl --request POST \ 2 --url 'http://states.{region}.amazonaws.com/#X-Amz-Target=AWSStepFunctions.ListExecutions' \ 3 --header 'accept: application/json' \ 4 --header 'content-type: application/json'