# Gets the current state of an execution

Gets the current state of an execution

Endpoint: GET /stepFunctions/{tenantId}/describe/{executionArn}
Version: v1-2025-04-18
Security: knox-authorizer

## Security:

  - `knox-authorizer` (unknown)
    http bearer JWT

## Path parameters:

  - `tenantId` (string, required)
    The id of the tenant being accessed

  - `executionArn` (string, required)

## Response 200:

  - `200` (unknown)
    The execution

## Response 200 fields (application/json):

  - `executionArn` (string)
    The execution ARN

  - `input` (string)
    The input to the execution

  - `output` (object)
    The ouptut of the execution

  - `start_date` (string)
    When the execution started

  - `stateMachineArn` (string)
    The arn of the state machine being run

  - `status` (string)
    The status
    Enum: "ABORTED", "FAILED", "RUNNING", "SUBMITTED", "SUCCEEDED", "TIMED_OUT"

  - `stop_date` (string)
    The date the execution stopped

## Response 200 headers (application/json):

  - `Access-Control-Allow-Headers` (string)

  - `Access-Control-Allow-Methods` (string)

  - `Access-Control-Allow-Origin` (string)

## Response 400:

  - `400` (unknown)
    The request was not valid

## Response 400 headers:

  - `Access-Control-Allow-Headers` (string)

  - `Access-Control-Allow-Methods` (string)

  - `Access-Control-Allow-Origin` (string)

## Response 401:

  - `401` (unknown)
    Unauthorized

## Response 401 headers:

  - `Access-Control-Allow-Headers` (string)

  - `Access-Control-Allow-Methods` (string)

  - `Access-Control-Allow-Origin` (string)

## Response 403:

  - `403` (unknown)
    Forbidden

## Response 403 headers:

  - `Access-Control-Allow-Headers` (string)

  - `Access-Control-Allow-Methods` (string)

  - `Access-Control-Allow-Origin` (string)

## Response 404:

  - `404` (unknown)
    State machine was not found

## Response 404 headers:

  - `Access-Control-Allow-Headers` (string)

  - `Access-Control-Allow-Methods` (string)

  - `Access-Control-Allow-Origin` (string)

## Response 429:

  - `429` (unknown)
    The state machine could not be started because an instance is already running

## Response 429 headers:

  - `Access-Control-Allow-Headers` (string)

  - `Access-Control-Allow-Methods` (string)

  - `Access-Control-Allow-Origin` (string)

## Response 500:

  - `500` (unknown)
    An internal server error occured.

## Response 500 headers:

  - `Access-Control-Allow-Headers` (string)

  - `Access-Control-Allow-Methods` (string)

  - `Access-Control-Allow-Origin` (string)