# Get lifecycle details

Source: https://www.jawsdeploy.net/rest-api/lifecycles-details | Section: Lifecycles

Retrieve one lifecycle by ID.

`GET /api/lifecycle/details`

Returns one lifecycle: its name, description, ordered phases, and the environments in each phase.

The lifecycle ID identifies its workspace, so no `workspaceId` is required.

Phase fields - `progressRequirement`, `progressRequirementErrorMode`, `progressRequirementCount`, and `howToTrigger` - are described in [Add a lifecycle phase](https://www.jawsdeploy.net/rest-api/lifecycle-phase-add).

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `lifecycleId` | query | string | yes | ID of the lifecycle. |

## Errors

| Status | Meaning |
|---|---|
| 400 | Missing or unknown `lifecycleId`. |
| 401 | Missing or invalid Basic auth credentials, or the service account cannot manage lifecycles in this workspace. |

Example request:

```
GET /api/lifecycle/details?lifecycleId=lc_1 HTTP/1.1
Authorization: Basic <base64(serviceAccountId:apiKey)>
```

Example response:

```
{
  "lifecycleId": "lc_1",
  "workspaceId": "ws_abc",
  "name": "default",
  "description": "Standard promotion path",
  "phases": [
    {
      "phaseId": "ph_1",
      "name": "Dev",
      "description": null,
      "sortOrder": 1,
      "progressRequirement": "AllMustComplete",
      "progressRequirementErrorMode": "NoErrorsNoWarnings",
      "progressRequirementCount": 0,
      "environments": [
        { "environmentId": "env_a", "environmentName": "Development", "howToTrigger": "Automatic" }
      ]
    },
    {
      "phaseId": "ph_2",
      "name": "Staging",
      "description": "Sign-off before production",
      "sortOrder": 2,
      "progressRequirement": "MinimumNumberToComplete",
      "progressRequirementErrorMode": "NoErrorsAllowWarnings",
      "progressRequirementCount": 1,
      "environments": [
        { "environmentId": "env_b", "environmentName": "Staging EU", "howToTrigger": "Manual" },
        { "environmentId": "env_c", "environmentName": "Staging US", "howToTrigger": "Manual" }
      ]
    }
  ]
}
```