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

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

`GET /projects/{projectId}/progression/v1`

## Path parameters

- `projectId` string, required

## Query parameters

- `releaseHistoryCount` integer

## Response `200`

The requested Project Progression information

- GetProjectProgressionResponse
  - `Progression` ProgressionResource, required
    - `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)