---
title: "Get a list of Runbook Runs"
method: GET
path: "/spaces/{spaceIdentifier}/runbookRuns"
tags: ["RunbookRuns"]
---

# Get a list of Runbook Runs

`GET /spaces/{spaceIdentifier}/runbookRuns`

Lists all of the runbookRuns in the supplied Octopus Deploy Space, from projects, snapshots and environments accessible by the current user. The results will be sorted from most recent to least recent runbookRun.

## Path parameters

- `spaceIdentifier` string, required

## Query parameters

- `environments` string[]
- `ids` string[]
- `partialName` string
- `projects` string[]
- `runbooks` string[]
- `skip` integer
- `take` integer
- `taskState` 'Queued' | 'Executing' | 'Failed' | 'Canceled' | 'TimedOut' | 'Success' | 'Cancelling'
- `tenants` string[]

## Response `200`

The requested list of Runbook Runs

- RunbookRunResourceCollection
  - `Id` string — Gets or sets a unique identifier for this resource.
  - `Items` RunbookRunResource[]
    - `ChangeRequestSettings` ChangeRequestSettings[]
      - `Type` 'ServiceNow' | 'JiraServiceManagement'
    - `Comments` string
    - `Created` string, date-time
    - `DebugMode` string
    - `DeployedBy` string
    - `DeployedById` string
    - `DeployedToMachineIds` string[]
    - `EnvironmentId` string, required
    - `ExcludedMachineIds` string[] — A collection of machines in the target environment that should be excluded from the deployment.
    - `ExcludedTargetTagIds` string[] — A collection of target tag IDs that should be excluded from the deployment. Only deployment targets that have none of these tags will be deployed to. Tag IDs are in the format "TagSets-{id}/Tags-{id}".
    - `ExecutionPlanLogContext` ExecutionPlanLogContext
      - `Steps` StepLogContext[], required
        - `CorrelationId` string, required
        - `Slug` string, required
    - `FailTargetDiscovery` boolean
    - `FailureEncountered` boolean
    - `ForcePackageDownload` boolean
    - `FormValues` object
    - `FrozenRunbookProcessId` string
    - `Id` string — Gets or sets a unique identifier for this resource.
    - `LastModifiedBy` string — Gets or sets the username of the user who last modified this resource.
    - `LastModifiedOn` string, date-time — Gets or sets the date/time that this resource was last modified.
    - `Links` object — Gets or sets a dictionary of links to other related resources. These links can be used to navigate the resources on the server.
    - `ManifestVariableSetId` string
    - `Name` string
    - `Priority` string
    - `ProjectId` string
    - `QueueTime` string, date-time — If set this time will be the used to schedule the deployment to a later time, null is assumed to mean the time will be executed immediately.
    - `QueueTimeExpiry` string, date-time
    - `RunbookId` string, required
    - `RunbookName` string
    - `RunbookSnapshotId` string, required
    - `SkipActions` string[]
    - `SpaceId` string
    - `SpecificMachineIds` string[] — A collection of machines in the target environment that should be deployed to. If the collection is empty, all enabled machines are deployed.
    - `SpecificTargetTagIds` string[] — A collection of target tag IDs that should be included in the deployment. Only deployment targets that have at least one of these tags will be deployed to. Tag IDs are in the format "TagSets-{id}/Tags-{id}".
    - `TaskId` string
    - `TenantId` string
    - `TentacleRetentionPeriod` RetentionPeriod
      - `QuantityToKeep` integer
      - `ShouldKeepForever` boolean
      - `Strategy` string
      - `Unit` 'Days' | 'Items'
    - `UseGuidedFailure` boolean — If set to true, the deployment will prompt for manual intervention (Fail/Retry/Ignore) when failures are encountered in activities that support it. May be overridden with the Octopus.UseGuidedFailure special variable.
  - `ItemsPerPage` integer
  - `ItemType` string
  - `LastModifiedBy` string — Gets or sets the username of the user who last modified this resource.
  - `LastModifiedOn` string, date-time — Gets or sets the date/time that this resource was last modified.
  - `LastPageNumber` integer
  - `Links` object — Gets or sets a dictionary of links to other related resources. These links can be used to navigate the resources on the server.
  - `NumberOfPages` integer
  - `TotalResults` integer

## Other responses

- `400` — Bad request. Either the payload was not structurally valid or business rules did not permit the operation.
- `404` — Not found. One or more of the entities involved in the operation was not found.

---

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