---
title: "List Process deployments"
method: GET
path: "/api/v1/process-deployments"
tags: ["ProcessDeployments"]
---

# List Process deployments

`GET /api/v1/process-deployments`

If response data is empty there were no deployed Processes found with the chosen filters

## Query parameters

- `PageNumber` integer
- `PageSize` integer
- `agentGroupId` integer
- `processName` string
- `processGuid` string, uuid
- `tags` string[]
- `excludeSubprocesses` boolean

## Response `200`

OK

- DtoProcessDeploymentGetPagedResponse
  - `data` DtoProcessDeploymentGet[] — Response data
    - `deploymentId` integer — Unique identifier for the deployment.
    - `processId` integer — Unique identifier for Process version.
    - `processName` string — Process name
    - `processGuid` string, uuid — Process unique identifier. This is shared between all versions of the Process.
    - `processVersion` string — Process version in the format X.Y.Z.
    - `processBuildVersion` integer — Process build version. This version is incremented by 1 on every successful Process build.
    - `deployedAtUtc` string, date-time, nullable
    - `deployedBy` string, nullable
    - `description` string, nullable — Optional description for deployment
    - `triggersActive` boolean — Are Process Triggers active
    - `agentGroup` DtoAgentGroupBase
      - `id` integer — Unique identifier for the Agent Group
      - `displayName` string — Display name for the Agent Group
  - `paging` PagingModel
    - `currentPage` integer — Current page
    - `pageSize` integer — Number of entries per page
    - `totalCount` integer — Total number of entries
    - `firstPage` string, uri, nullable — Url of the first page
    - `lastPage` string, uri, nullable — Url of the last page
    - `nextPage` string, uri, nullable — Url of the next page
    - `previousPage` string, uri, nullable — Url of the previous page

## Other responses

- `400` — Agent group doesnt exist

---

[API](https://skmtc.dev/frends/apis/frends-api.md) · [All operations](https://skmtc.dev/frends/apis/frends-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/frends/frends-api/revisions/cf4c0a0d1c8a/schema)