---
title: "List application deployments"
method: GET
path: "/api/v1/deploy/application/deployments"
tags: ["deployments", "api/v1/deploy", "application"]
---

# List application deployments

`GET /api/v1/deploy/application/deployments`

List application deployments.

Auth: Required (bearer token).
Scope: Organization-scoped in authenticated context.
Side effects: Read-only operation.

## Query parameters

- `id` string, uuid, required
- `page` integer
- `limit` integer

## Headers

- `Accept` string

## Response `200`

OK

- ListDeploymentsResponse — ListDeploymentsResponse schema
  - `data` object
    - `deployments` object[]
      - `application` object, nullable
        - `base_path` string
        - `branch` string
        - `build_pack` string
        - `build_variables` string
        - `compose_services` object[], nullable
          - `application` Application, nullable
            - `base_path` string
            - `branch` string
            - `build_pack` string
            - `build_variables` string
            - `compose_services` object[], nullable
              - …
            - `created_at` string, date-time
            - `deployments` object[], nullable
              - …
            - `dockerfile_path` string
            - `domains` object[], nullable
              - …
            - `environment` string
            - `environment_variables` string
            - `family_id` string, uuid
            - `id` string, uuid
            - `is_live_deployment` boolean
            - `labels` string[], nullable
            - `logs` object[], nullable
              - …
            - `name` string
            - `organization` object, nullable
              - …
            - `organization_id` string, uuid
            - `port` integer
            - `post_run_command` string
            - `pre_run_command` string
            - `proxy_server` string
            - `repository` string
            - `source` string
            - `status` object, nullable
              - …
            - `updated_at` string, date-time
            - `user` object, nullable
              - …
            - `user_id` string, uuid
          - `application_id` string, uuid
          - `created_at` string, date-time
          - `domains` object[], nullable
            - `application` Application, nullable
              - …
            - `application_id` string, uuid
            - `compose_service` ComposeService, nullable
              - …
            - `compose_service_id` string, uuid
            - `created_at` string, date-time
            - `domain` string
            - `id` string, uuid
            - `port` integer, nullable
          - `id` string, uuid
          - `port` integer
          - `service_name` string
          - `updated_at` string, date-time
        - `created_at` string, date-time
        - `deployments` ApplicationDeployment[], nullable
          - `application` Application, nullable
            - `base_path` string
            - `branch` string
            - `build_pack` string
            - `build_variables` string
            - `compose_services` object[], nullable
              - …
            - `created_at` string, date-time
            - `deployments` object[], nullable
              - …
            - `dockerfile_path` string
            - `domains` object[], nullable
              - …
            - `environment` string
            - `environment_variables` string
            - `family_id` string, uuid
            - `id` string, uuid
            - `is_live_deployment` boolean
            - `labels` string[], nullable
            - `logs` object[], nullable
              - …
            - `name` string
            - `organization` object, nullable
              - …
            - `organization_id` string, uuid
            - `port` integer
            - `post_run_command` string
            - `pre_run_command` string
            - `proxy_server` string
            - `repository` string
            - `source` string
            - `status` object, nullable
              - …
            - `updated_at` string, date-time
            - `user` object, nullable
              - …
            - `user_id` string, uuid
          - `application_id` string, uuid
          - `commit_hash` string
          - `container_id` string, uuid
          - `container_image` string
          - `container_name` string
          - `container_status` string
          - `created_at` string, date-time
          - `id` string, uuid
          - `image_s3_key` string
          - `image_size` integer
          - `logs` object[], nullable
            - `application` Application, nullable
              - …
            - `application_deployment` ApplicationDeployment — recursive
            - `application_deployment_id` string, uuid
            - `application_id` string, uuid
            - `created_at` string, date-time
            - `id` string, uuid
            - `log` string
            - `updated_at` string, date-time
          - `status` object, nullable
            - `application_deployment` ApplicationDeployment — recursive
            - `application_deployment_id` string, uuid
            - `created_at` string, date-time
            - `id` string, uuid
            - `status` string
            - `updated_at` string, date-time
          - `updated_at` string, date-time
        - `dockerfile_path` string
        - `domains` object[], nullable
          - `application` Application, nullable
            - `base_path` string
            - `branch` string
            - `build_pack` string
            - `build_variables` string
            - `compose_services` object[], nullable
              - …
            - `created_at` string, date-time
            - `deployments` object[], nullable
              - …
            - `dockerfile_path` string
            - `domains` object[], nullable
              - …
            - `environment` string
            - `environment_variables` string
            - `family_id` string, uuid
            - `id` string, uuid
            - `is_live_deployment` boolean
            - `labels` string[], nullable
            - `logs` object[], nullable
              - …
            - `name` string
            - `organization` object, nullable
              - …
            - `organization_id` string, uuid
            - `port` integer
            - `post_run_command` string
            - `pre_run_command` string
            - `proxy_server` string
            - `repository` string
            - `source` string
            - `status` object, nullable
              - …
            - `updated_at` string, date-time
            - `user` object, nullable
              - …
            - `user_id` string, uuid
          - `application_id` string, uuid
          - `compose_service` object, nullable
            - `application` Application, nullable
              - …
            - `application_id` string, uuid
            - `created_at` string, date-time
            - `domains` ApplicationDomain[]
              - …
            - `id` string, uuid
            - `port` integer
            - `service_name` string
            - `updated_at` string, date-time
          - `compose_service_id` string, uuid
          - `created_at` string, date-time
          - `domain` string
          - `id` string, uuid
          - `port` integer, nullable
        - `environment` string
        - `environment_variables` string
        - `family_id` string, uuid
        - `id` string, uuid
        - `is_live_deployment` boolean
        - `labels` string[], nullable
        - `logs` object[], nullable
          - `application` Application, nullable
            - `base_path` string
            - `branch` string
            - `build_pack` string
            - `build_variables` string
            - `compose_services` object[], nullable
              - …
            - `created_at` string, date-time
            - `deployments` object[], nullable
              - …
            - `dockerfile_path` string
            - `domains` object[], nullable
              - …
            - `environment` string
            - `environment_variables` string
            - `family_id` string, uuid
            - `id` string, uuid
            - `is_live_deployment` boolean
            - `labels` string[], nullable
            - `logs` object[], nullable
              - …
            - `name` string
            - `organization` object, nullable
              - …
            - `organization_id` string, uuid
            - `port` integer
            - `post_run_command` string
            - `pre_run_command` string
            - `proxy_server` string
            - `repository` string
            - `source` string
            - `status` object, nullable
              - …
            - `updated_at` string, date-time
            - `user` object, nullable
              - …
            - `user_id` string, uuid
          - `application_deployment` ApplicationDeployment, nullable
            - `application` Application, nullable
              - …
            - `application_id` string, uuid
            - `commit_hash` string
            - `container_id` string, uuid
            - `container_image` string
            - `container_name` string
            - `container_status` string
            - `created_at` string, date-time
            - `id` string, uuid
            - `image_s3_key` string
            - `image_size` integer
            - `logs` object[], nullable
              - …
            - `status` object, nullable
              - …
            - `updated_at` string, date-time
          - `application_deployment_id` string, uuid
          - `application_id` string, uuid
          - `created_at` string, date-time
          - `id` string, uuid
          - `log` string
          - `updated_at` string, date-time
        - `name` string
        - `organization` object, nullable
          - `created_at` string, date-time
          - `id` string, uuid
          - `logo` string, nullable
          - `metadata` string, nullable
          - `name` string
          - `slug` string
        - `organization_id` string, uuid
        - `port` integer
        - `post_run_command` string
        - `pre_run_command` string
        - `proxy_server` string
        - `repository` string
        - `source` string
        - `status` object, nullable
          - `application` Application, nullable
            - `base_path` string
            - `branch` string
            - `build_pack` string
            - `build_variables` string
            - `compose_services` object[], nullable
              - …
            - `created_at` string, date-time
            - `deployments` object[], nullable
              - …
            - `dockerfile_path` string
            - `domains` object[], nullable
              - …
            - `environment` string
            - `environment_variables` string
            - `family_id` string, uuid
            - `id` string, uuid
            - `is_live_deployment` boolean
            - `labels` string[], nullable
            - `logs` object[], nullable
              - …
            - `name` string
            - `organization` object, nullable
              - …
            - `organization_id` string, uuid
            - `port` integer
            - `post_run_command` string
            - `pre_run_command` string
            - `proxy_server` string
            - `repository` string
            - `source` string
            - `status` object, nullable
              - …
            - `updated_at` string, date-time
            - `user` object, nullable
              - …
            - `user_id` string, uuid
          - `application_id` string, uuid
          - `created_at` string, date-time
          - `id` string, uuid
          - `status` string
          - `updated_at` string, date-time
        - `updated_at` string, date-time
        - `user` object, nullable
          - `avatar` string
          - `created_at` string, date-time
          - `email` string
          - `email_verified` boolean
          - `id` string, uuid
          - `image` string, nullable
          - `is_onboarded` boolean
          - `is_verified` boolean
          - `name` string
          - `organization_users` object[], nullable
            - `created_at` string, date-time
            - `id` string, uuid
            - `organization` object, nullable
              - …
            - `organization_id` string, uuid
            - `role` string
            - `user` User, nullable
              - …
            - `user_id` string, uuid
          - `organizations` object[], nullable
            - `created_at` string, date-time
            - `id` string, uuid
            - `logo` string, nullable
            - `metadata` string, nullable
            - `name` string
            - `slug` string
          - `provision_status` string, nullable
          - `updated_at` string, date-time
          - `username` string
        - `user_id` string, uuid
      - `application_id` string, uuid
      - `commit_hash` string
      - `container_id` string, uuid
      - `container_image` string
      - `container_name` string
      - `container_status` string
      - `created_at` string, date-time
      - `id` string, uuid
      - `image_s3_key` string
      - `image_size` integer
      - `logs` object[], nullable
        - `application` object, nullable
          - `base_path` string
          - `branch` string
          - `build_pack` string
          - `build_variables` string
          - `compose_services` object[], nullable
            - `application` Application, nullable
              - …
            - `application_id` string, uuid
            - `created_at` string, date-time
            - `domains` object[], nullable
              - …
            - `id` string, uuid
            - `port` integer
            - `service_name` string
            - `updated_at` string, date-time
          - `created_at` string, date-time
          - `deployments` ApplicationDeployment[], nullable
            - `application` Application, nullable
              - …
            - `application_id` string, uuid
            - `commit_hash` string
            - `container_id` string, uuid
            - `container_image` string
            - `container_name` string
            - `container_status` string
            - `created_at` string, date-time
            - `id` string, uuid
            - `image_s3_key` string
            - `image_size` integer
            - `logs` object[], nullable
              - …
            - `status` object, nullable
              - …
            - `updated_at` string, date-time
          - `dockerfile_path` string
          - `domains` object[], nullable
            - `application` Application, nullable
              - …
            - `application_id` string, uuid
            - `compose_service` object, nullable
              - …
            - `compose_service_id` string, uuid
            - `created_at` string, date-time
            - `domain` string
            - `id` string, uuid
            - `port` integer, nullable
          - `environment` string
          - `environment_variables` string
          - `family_id` string, uuid
          - `id` string, uuid
          - `is_live_deployment` boolean
          - `labels` string[], nullable
          - `logs` ApplicationLogs[]
            - `application` Application, nullable
              - …
            - `application_deployment` ApplicationDeployment, nullable
              - …
            - `application_deployment_id` string, uuid
            - `application_id` string, uuid
            - `created_at` string, date-time
            - `id` string, uuid
            - `log` string
            - `updated_at` string, date-time
          - `name` string
          - `organization` object, nullable
            - `created_at` string, date-time
            - `id` string, uuid
            - `logo` string, nullable
            - `metadata` string, nullable
            - `name` string
            - `slug` string
          - `organization_id` string, uuid
          - `port` integer
          - `post_run_command` string
          - `pre_run_command` string
          - `proxy_server` string
          - `repository` string
          - `source` string
          - `status` object, nullable
            - `application` Application, nullable
              - …
            - `application_id` string, uuid
            - `created_at` string, date-time
            - `id` string, uuid
            - `status` string
            - `updated_at` string, date-time
          - `updated_at` string, date-time
          - `user` object, nullable
            - `avatar` string
            - `created_at` string, date-time
            - `email` string
            - `email_verified` boolean
            - `id` string, uuid
            - `image` string, nullable
            - `is_onboarded` boolean
            - `is_verified` boolean
            - `name` string
            - `organization_users` object[], nullable
              - …
            - `organizations` object[], nullable
              - …
            - `provision_status` string, nullable
            - `updated_at` string, date-time
            - `username` string
          - `user_id` string, uuid
        - `application_deployment` ApplicationDeployment, nullable
          - `application` Application, nullable
            - `base_path` string
            - `branch` string
            - `build_pack` string
            - `build_variables` string
            - `compose_services` object[], nullable
              - …
            - `created_at` string, date-time
            - `deployments` object[], nullable
              - …
            - `dockerfile_path` string
            - `domains` object[], nullable
              - …
            - `environment` string
            - `environment_variables` string
            - `family_id` string, uuid
            - `id` string, uuid
            - `is_live_deployment` boolean
            - `labels` string[], nullable
            - `logs` object[], nullable
              - …
            - `name` string
            - `organization` object, nullable
              - …
            - `organization_id` string, uuid
            - `port` integer
            - `post_run_command` string
            - `pre_run_command` string
            - `proxy_server` string
            - `repository` string
            - `source` string
            - `status` object, nullable
              - …
            - `updated_at` string, date-time
            - `user` object, nullable
              - …
            - `user_id` string, uuid
          - `application_id` string, uuid
          - `commit_hash` string
          - `container_id` string, uuid
          - `container_image` string
          - `container_name` string
          - `container_status` string
          - `created_at` string, date-time
          - `id` string, uuid
          - `image_s3_key` string
          - `image_size` integer
          - `logs` object[], nullable
            - `application` Application, nullable
              - …
            - `application_deployment` ApplicationDeployment — recursive
            - `application_deployment_id` string, uuid
            - `application_id` string, uuid
            - `created_at` string, date-time
            - `id` string, uuid
            - `log` string
            - `updated_at` string, date-time
          - `status` object, nullable
            - `application_deployment` ApplicationDeployment — recursive
            - `application_deployment_id` string, uuid
            - `created_at` string, date-time
            - `id` string, uuid
            - `status` string
            - `updated_at` string, date-time
          - `updated_at` string, date-time
        - `application_deployment_id` string, uuid
        - `application_id` string, uuid
        - `created_at` string, date-time
        - `id` string, uuid
        - `log` string
        - `updated_at` string, date-time
      - `status` object, nullable
        - `application_deployment` ApplicationDeployment, nullable
          - `application` Application, nullable
            - `base_path` string
            - `branch` string
            - `build_pack` string
            - `build_variables` string
            - `compose_services` object[], nullable
              - …
            - `created_at` string, date-time
            - `deployments` object[], nullable
              - …
            - `dockerfile_path` string
            - `domains` object[], nullable
              - …
            - `environment` string
            - `environment_variables` string
            - `family_id` string, uuid
            - `id` string, uuid
            - `is_live_deployment` boolean
            - `labels` string[], nullable
            - `logs` object[], nullable
              - …
            - `name` string
            - `organization` object, nullable
              - …
            - `organization_id` string, uuid
            - `port` integer
            - `post_run_command` string
            - `pre_run_command` string
            - `proxy_server` string
            - `repository` string
            - `source` string
            - `status` object, nullable
              - …
            - `updated_at` string, date-time
            - `user` object, nullable
              - …
            - `user_id` string, uuid
          - `application_id` string, uuid
          - `commit_hash` string
          - `container_id` string, uuid
          - `container_image` string
          - `container_name` string
          - `container_status` string
          - `created_at` string, date-time
          - `id` string, uuid
          - `image_s3_key` string
          - `image_size` integer
          - `logs` object[], nullable
            - `application` Application, nullable
              - …
            - `application_deployment` ApplicationDeployment — recursive
            - `application_deployment_id` string, uuid
            - `application_id` string, uuid
            - `created_at` string, date-time
            - `id` string, uuid
            - `log` string
            - `updated_at` string, date-time
          - `status` object, nullable
            - `application_deployment` ApplicationDeployment — recursive
            - `application_deployment_id` string, uuid
            - `created_at` string, date-time
            - `id` string, uuid
            - `status` string
            - `updated_at` string, date-time
          - `updated_at` string, date-time
        - `application_deployment_id` string, uuid
        - `created_at` string, date-time
        - `id` string, uuid
        - `status` string
        - `updated_at` string, date-time
      - `updated_at` string, date-time
    - `page` integer
    - `page_size` integer
    - `total_count` integer
  - `message` string
  - `status` string

## Other responses

- `400` — Bad Request _(validation or deserialization error)_
- `500` — Internal Server Error _(panics)_
- `default`

## Changes

- **2026-03-09** `344ac18cbced` — 164 breaking, 336 warning, 124 info
  - added the new required `query` request parameter `id`
  - removed the request body
  - the response property `data/deployments/items/application/compose_services/items/application/deployments/items/` became nullable for the status `200` (media type: application/json)
  - the response property `data/deployments/items/application/compose_services/items/application/deployments/items/` became nullable for the status `200` (media type: application/xml)
  - …620 more
- …earlier changes not shown

[Full history](https://skmtc.dev/nixopus/apis/openapi/changes/api/v1/deploy/application/deployments/get.md)

---

[API](https://skmtc.dev/nixopus/apis/openapi.md) · [All operations](https://skmtc.dev/nixopus/apis/openapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nixopus/openapi/revisions/344ac18cbced/schema)