---
title: "Gets the progress of a release in the environment lifecycle."
method: GET
path: "/spaces/{spaceIdentifier}/progression/{projectId}"
tags: ["Progression"]
---

# Gets the progress of a release in the environment lifecycle.

`GET /spaces/{spaceIdentifier}/progression/{projectId}`

## Path parameters

- `spaceIdentifier` string, required
- `projectId` string, required

## Query parameters

- `releaseHistoryCount` integer

## Response `200`

The requested Project Progression information

- ProgressionResource
  - `ChannelEnvironments` object
  - `Environments` ReferenceDataItem[]
    - `Id` string
    - `Name` string
  - `Id` string
  - `LastModifiedBy` string
  - `LastModifiedOn` string, date-time
  - `LifecycleEnvironments` object
  - `Links` object
  - `Releases` ReleaseProgressionResource[]
    - `Channel` ChannelResource
      - `AutomaticEphemeralEnvironmentDeployments` boolean
      - `CustomFieldDefinitions` ChannelCustomFieldDefinitionResource[]
        - `Description` string
        - `FieldName` string
      - `Description` string
      - `EphemeralEnvironmentNameTemplate` string
      - `GitReferenceRules` string[]
      - `GitResourceRules` ChannelGitResourceRuleResource[]
        - `GitDependencyActions` DeploymentActionGitDependencyResource[]
          - `DeploymentActionSlug` string, required
          - `GitDependencyName` string, required
        - `Id` string
        - `Rules` string[]
      - `Id` string
      - `IsDefault` boolean
      - `LastModifiedBy` string
      - `LastModifiedOn` string, date-time
      - `LifecycleId` string
      - `Links` object
      - `Name` string
      - `ParentEnvironmentId` string — The parent environment for all ephemeral environments created in this channel.
      - `ProjectId` string
      - `Rules` ChannelVersionRuleResource[]
        - `ActionPackages` DeploymentActionPackageResource[]
          - `DeploymentAction` string
          - `PackageReference` string
        - `Id` string
        - `LastModifiedBy` string
        - `LastModifiedOn` string, date-time
        - `Links` object
        - `Tag` string
        - `VersioningStrategy` string
        - `VersionRange` string
        - `VersionTagRegex` string
      - `Slug` string
      - `SpaceId` string
      - `TenantTags` string[]
      - `Type` string
    - `Deployments` object
    - `HasUnresolvedDefect` boolean
    - `NextDeployments` string[]
    - `Release` ReleaseResource
      - `Assembled` string, date-time
      - `BuildInformation` ReleasePackageVersionBuildInformationResource[]
        - `Branch` string
        - `BuildEnvironment` string
        - `BuildNumber` string
        - `BuildUrl` string
        - `Commits` CommitDetails[]
          - `Comment` string
          - `Id` string
          - `LinkUrl` string
        - `IssueTrackerName` string
        - `PackageId` string
        - `VcsCommitNumber` string
        - `VcsCommitUrl` string
        - `VcsRoot` string
        - `VcsType` string
        - `Version` string
        - `WorkItems` WorkItemLink[]
          - `Description` string
          - `Id` string
          - `LinkUrl` string
          - `Source` string
      - `ChannelId` string
      - `CustomFields` object
      - `Id` string
      - `IgnoreChannelRules` boolean
      - `LastModifiedBy` string
      - `LastModifiedOn` string, date-time
      - `LibraryVariableSetSnapshotIds` string[]
      - `Links` object
      - `ProjectDeploymentProcessSnapshotId` string
      - `ProjectId` string
      - `ProjectVariableSetSnapshotId` string
      - `ReleaseNotes` string
      - `SelectedGitResources` SelectedGitResource[]
        - `ActionName` string, required
        - `GitReferenceResource` GitReferenceResource, required
          - `GitCommit` string
          - `GitRef` string
        - `GitResourceReferenceName` string
      - `SelectedPackages` SelectedPackage[]
        - `ActionName` string
        - `PackageReferenceName` string
        - `StepName` string
        - `Version` string
      - `SpaceId` string
      - `Version` string, required
      - `VersionControlReference` SnapshotGitReferenceResource
        - `GitCommit` string
        - `GitRef` string
        - `VariablesGitCommit` string
    - `ReleaseRetentionPeriod` RetentionPeriod
      - `QuantityToKeep` integer
      - `ShouldKeepForever` boolean
      - `Strategy` string
      - `Unit` 'Days' | 'Items'
    - `TentacleRetentionPeriod` RetentionPeriod
      - `QuantityToKeep` integer
      - `ShouldKeepForever` boolean
      - `Strategy` string
      - `Unit` 'Days' | 'Items'

## 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/versions/bc9158facfc7/schema)