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 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

Request Body

The request does not have a request body.

Response Syntax


HTTP/1.1 200
Content-type: application/json

{
   "DurableExecutionArn": "string",
   "DurableExecutionName": "string",
   "EndTimestamp": number,
   "Error": { 
      "ErrorData": "string",
      "ErrorMessage": "string",
      "ErrorType": "string",
      "StackTrace": [ "string" ]
   },
   "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.

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

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 Errors.

InvalidParameterValueException

One of the parameters in the request is not valid.

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

HTTP Status Code: 400

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