---
title: "Get a list of executions associated with an attack."
method: GET
path: "/executions"
tags: ["executions"]
---

# Get a list of executions associated with an attack.

`GET /executions`

Requires the privilege [`EXPERIMENTS_READ`](https://www.gremlin.com/docs/user-management/access-control/#privileges)

## Query parameters

- `taskId` string
- `teamId` string, required

## Response `default`

default response

- ExecutionResponse[]
  - `orgId` string — The teamId associated with the execution
  - `guid` string — Unique identifier associated with the execution
  - `targetType` 'Host' | 'Container' | 'Docker' | 'Kubernetes'
  - `infraTarget` object
  - `serviceStates` ServiceStateStage[] — A collection of states
    - `stage` 'InvalidArgument' | 'TargetNotFound' | 'Successful' | 'UserHalted' | 'ClientAborted' | 'LostCommunication' | 'InitializationFailed' | 'TeardownFailed' | 'HaltFailed' | 'Failed' | 'Pending' | 'Distributed' | 'Initializing' | 'HaltDistributed' | 'InterruptTriggered' | 'RollbackTriggered' | 'RollbackStarted' | 'Running' | 'TearingDown' | 'Halt'
    - `timestamp` string, date-time
  - `clientId` string — The unique agent identifier associated with the execution. For host-level experiments, this value represents the agent on the host where the execution is running. For container-level experiments, this value represents the agent that is running on the same host as the targeted container.
  - `clientStates` ClientState[] — A collection of states an execution goes through during its lifecycle, along with their corresponding timestamps. This list can be used to create a timeline of what happened to a particular target during an experiment. Meanings of specific state values can be found at https://www.gremlin.com/docs/fault-injection-experiments#experiment-stages
    - `stage` string
    - `timestamp` string, date-time
  - `tags` object
  - `labels` object
  - `multiSelectTags` object
  - `multiSelectLabels` object
  - `clientStatus` 'HEALTHY' | 'IMPAIRED' | 'UNHEALTHY'
  - `clientVersion` string
  - `error` string — If any critical error occurs during the execution's lifecycle, it is stored here.
  - `output` string — Raw logging output from the gremlin experiment process while the execution runs.
  - `infraCommand` object
  - `guestId` string — If execution is running against a container target, this field is populated with the containerId
  - `createSource` 'WebApp' | 'Api' | 'Scheduled' | 'Manual' | 'Spinnaker' | 'Concord' | 'GremlinFeeder' | 'GremlinSdkPython' | 'Scenario' | 'Chao' | 'K8sBackend' | 'Website' | 'Neotys' | 'IntegrationClient' | 'Validation'
  - `attackContainerId` string
  - `stage` 'InvalidArgument' | 'TargetNotFound' | 'Successful' | 'UserHalted' | 'ClientAborted' | 'LostCommunication' | 'InitializationFailed' | 'TeardownFailed' | 'HaltFailed' | 'Failed' | 'Pending' | 'Distributed' | 'Initializing' | 'HaltDistributed' | 'InterruptTriggered' | 'RollbackTriggered' | 'RollbackStarted' | 'Running' | 'TearingDown' | 'Halt'
  - `stageLifecycle` 'Active' | 'Halting' | 'Complete' | 'Error' — One of `Active`, `Halting`, `Complete`, or `Error`, this field describes where this execution is in its overall lifecycle. Values `Complete` and `Error` indicate the execution has finished.
  - `owningTeamId` string
  - `runasUser` string
  - `taskId` string
  - `kind` 'WebApp' | 'Api' | 'Scheduled' | 'Manual' | 'Spinnaker' | 'Concord' | 'GremlinFeeder' | 'GremlinSdkPython' | 'Scenario' | 'Chao' | 'K8sBackend' | 'Website' | 'Neotys' | 'IntegrationClient' | 'Validation'
  - `args` string[]
  - `startTime` string, date-time — The time at which this execution was created. For more fine-grained information about when exactly impact was applied, see `client_states`.
  - `endTime` string, date-time — The time at which this execution finished. For more fine-grained information about when exactly impact was removed, see `client_states`.
  - `createdAt` string, date-time
  - `updatedAt` string, date-time
  - `eventCodes` EventCode[]
    - `timestamp` string, date-time
    - `code` string
    - `message` string
    - `link` string
  - `metricsLinks` object
  - `scopeDetails` ScopeDetail[] — Detailed information about the scope of this experiment. This contains information such as which containerId or Linux namespace is targeted.
    - `key` string
    - `value` string

## Other responses

- `401` — Authorization header missing or malformed. Please provide proper credentials in the authorization header.
- `403` — User requires privilege for target team: EXPERIMENTS_READ

---

[API](https://skmtc.net/gremlin/apis/gremlin-api.md) · [All operations](https://skmtc.net/gremlin/apis/gremlin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gremlin/gremlin-api/revisions/36ee938323f0/schema)