Request Syntax URI Request Parameters Request Body Response Syntax Response Elements Errors See Also

GetDurableExecution

Retrieves detailed information about a specific durable execution, including its current status, input payload, result or error information, and execution metadata such as start time and usage statistics.

Request Syntax


GET /2025-12-01/durable-executions/DurableExecutionArn?IncludeExecutionData=IncludeExecutionData HTTP/1.1

URI Request Parameters

The request uses the following URI parameters.

DurableExecutionArn

The Amazon Resource Name (ARN) of the durable execution.

Length Constraints: Minimum length of 1. Maximum length of 1024.

Pattern: arn:([a-zA-Z0-9-]+):lambda:([a-zA-Z0-9-]+):(\d{12}):function:([a-zA-Z0-9_-]+):(\$LATEST(?:\.PUBLISHED)?|[0-9]+)/durable-execution/([a-zA-Z0-9_-]+)/([a-zA-Z0-9_-]+)

Required: Yes

IncludeExecutionData

Specifies whether to include execution data such as input payload, result, and error information in the response. Set to false for a more compact response that includes only execution metadata. The default value is set to true.

Request Body

The request does not have a request body.

Response Syntax


HTTP/1.1 200
Content-type: application/json

{
   "DurableConfig": { 
      "ExecutionTimeout": number,
      "KMSKeyArn": "string",
      "RetentionPeriodInDays": number
   },
   "DurableExecutionArn": "string",
   "DurableExecutionName": "string",
   "EndTimestamp": number,
   "Error": { 
      "ErrorData": "string",
      "ErrorMessage": "string",
      "ErrorType": "string",
      "StackTrace": [ "string" ]
   },
   "ExecutionDataIncluded": boolean,
   "FunctionArn": "string",
   "InputPayload": "string",
   "Result": "string",
   "StartTimestamp": number,
   "Status": "string",
   "TraceHeader": { 
      "XAmznTraceId": "string"
   },
   "Version": "string"
}

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

DurableConfig

Configuration settings for the durable execution, including execution timeout, retention period for execution history, and an optional ARN of the AWS Key Management Service (AWS KMS) customer managed key that is used to encrypt your durable execution's payload data, including input, output, and error payloads.

Type: DurableConfig object

DurableExecutionArn

The Amazon Resource Name (ARN) of the durable execution.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 1024.

Pattern: arn:([a-zA-Z0-9-]+):lambda:([a-zA-Z0-9-]+):(\d{12}):function:([a-zA-Z0-9_-]+):(\$LATEST(?:\.PUBLISHED)?|[0-9]+)/durable-execution/([a-zA-Z0-9_-]+)/([a-zA-Z0-9_-]+)

DurableExecutionName

The name of the durable execution. This is either the name you provided when invoking the function, or a system-generated unique identifier if no name was provided.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 64.

Pattern: [a-zA-Z0-9-_]+

EndTimestamp

The date and time when the durable execution ended, in Unix timestamp format. This field is only present if the execution has completed (status is SUCCEEDED, FAILED, TIMED_OUT, or STOPPED).

Type: Timestamp

Error

Error information if the durable execution failed. This field is only present when the execution status is FAILED, TIMED_OUT, or STOPPED. The combined size of all error fields is limited to 256 KB.

Type: ErrorObject object

ExecutionDataIncluded

Indicates whether execution data is included in this response. Returns false when IncludeExecutionData is set to false in the request.

Type: Boolean

FunctionArn

The Amazon Resource Name (ARN) of the Lambda function that was invoked to start this durable execution.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 10000.

Pattern: arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso([a-z]?)))?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_\.]+(:(\$LATEST(\.PUBLISHED)?|[a-zA-Z0-9-_]+))?

InputPayload

The JSON input payload that was provided when the durable execution was started. For asynchronous invocations, this is limited to 256 KB. For synchronous invocations, this can be up to 6 MB.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 6291456.

Result

The JSON result returned by the durable execution if it completed successfully. This field is only present when the execution status is SUCCEEDED. The result is limited to 256 KB.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 6291456.

StartTimestamp

The date and time when the durable execution started, in Unix timestamp format.

Type: Timestamp

Status

The current status of the durable execution. Valid values are RUNNING, SUCCEEDED, FAILED, TIMED_OUT, and STOPPED.

Type: String

Valid Values: RUNNING | SUCCEEDED | FAILED | TIMED_OUT | STOPPED

TraceHeader

The trace headers associated with the durable execution.

Type: TraceHeader object

Version

The version of the Lambda function that was invoked for this durable execution. This ensures that all replays during the execution use the same function version.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 1024.

Pattern: (\$LATEST(\.PUBLISHED)?|[0-9]+)

Errors

For information about the errors that are common to all actions, see Common Error Types.

InvalidParameterValueException

One of the parameters in the request is not valid.

message: The exception message.
Type: The exception type.

HTTP Status Code: 400

KMSAccessDeniedException

Lambda couldn't decrypt the environment variables because AWS KMS access was denied. Check the Lambda function's KMS permissions.

HTTP Status Code: 502

KMSDisabledException

Lambda couldn't decrypt the environment variables because the AWS KMS key used is disabled. Check the Lambda function's KMS key settings.

HTTP Status Code: 502

KMSInvalidStateException

Lambda couldn't decrypt the environment variables because the state of the AWS KMS key used is not valid for Decrypt. Check the function's KMS key settings.

HTTP Status Code: 502

KMSNotFoundException

Lambda couldn't decrypt the environment variables because the AWS KMS key was not found. Check the function's KMS key settings.

HTTP Status Code: 502

ResourceNotFoundException

The resource specified in the request does not exist.

HTTP Status Code: 404

ServiceException

The AWS Lambda service encountered an internal error.

HTTP Status Code: 500

TooManyRequestsException

The request throughput limit was exceeded. For more information, see Lambda quotas.

retryAfterSeconds: The number of seconds the caller should wait before retrying.

HTTP Status Code: 429