---
title: "List applications"
method: GET
path: "/api/v1/deploy/applications"
tags: ["Deploy"]
---

# List applications

`GET /api/v1/deploy/applications`

List applications.

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

## Query parameters

- `page` integer
- `page_size` integer
- `sort_by` string
- `sort_direction` 'asc' | 'desc'

## Headers

- `Accept` string

## Response `200`

OK

- ListApplicationsResponse — ListApplicationsResponse schema
  - `data` object
    - `applications` object[]
      - `base_path` string
      - `branch` string
      - `build_pack` string
      - `build_variables` string
      - `compose_services` object[], nullable
        - `application_id` string, uuid
        - `created_at` string, date-time
        - `domains` object[], nullable
          - `application_id` string, uuid
          - `compose_service` ComposeService
            - `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
          - `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` object[], nullable
        - `application` Application, nullable
          - `base_path` string
          - `branch` string
          - `build_pack` string
          - `build_variables` string
          - `compose_services` object[], 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` object, nullable
              - …
            - `application_id` string, uuid
            - `children` ApplicationDeployment[], nullable
            - `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
              - …
            - `parent_deployment_id` string, uuid
            - `server_id` string, uuid
            - `status` object, nullable
              - …
            - `updated_at` string, date-time
          - `dockerfile_path` string
          - `domains` object[], 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` object[], 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_id` string, uuid
          - `port` integer
          - `post_run_command` string
          - `pre_run_command` string
          - `proxy_server` string
          - `repository` string
          - `routing_strategy` string
          - `servers` object[], nullable
            - `application_id` string, uuid
            - `created_at` string, date-time
            - `id` string, uuid
            - `is_primary` boolean
            - `server` object, nullable
              - …
            - `server_id` string, uuid
          - `source` string
          - `status` object, nullable
            - `application_id` string, uuid
            - `created_at` string, date-time
            - `id` string, uuid
            - `status` string
            - `updated_at` string, date-time
          - `template_id` string, uuid
          - `updated_at` string, date-time
          - `user_id` string, uuid
        - `application_id` string, uuid
        - `children` ApplicationDeployment[]
          - `application` object, nullable
            - `base_path` string
            - `branch` string
            - `build_pack` string
            - `build_variables` string
            - `compose_services` object[], nullable
              - …
            - `created_at` string, date-time
            - `deployments` ApplicationDeployment[], 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_id` string, uuid
            - `port` integer
            - `post_run_command` string
            - `pre_run_command` string
            - `proxy_server` string
            - `repository` string
            - `routing_strategy` string
            - `servers` object[], nullable
              - …
            - `source` string
            - `status` object, nullable
              - …
            - `template_id` string, uuid
            - `updated_at` string, date-time
            - `user_id` string, uuid
          - `application_id` string, uuid
          - `children` ApplicationDeployment[], nullable
          - `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_deployment_id` string, uuid
            - `application_id` string, uuid
            - `created_at` string, date-time
            - `id` string, uuid
            - `log` string
            - `updated_at` string, date-time
          - `parent_deployment_id` string, uuid
          - `server_id` string, uuid
          - `status` object, nullable
            - `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
        - `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_deployment_id` string, uuid
          - `application_id` string, uuid
          - `created_at` string, date-time
          - `id` string, uuid
          - `log` string
          - `updated_at` string, date-time
        - `parent_deployment_id` string, uuid
        - `server_id` string, uuid
        - `status` object, nullable
          - `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_id` string, uuid
        - `compose_service` object, nullable
          - `application_id` string, uuid
          - `created_at` string, date-time
          - `domains` ApplicationDomain[]
            - `application_id` string, uuid
            - `compose_service` ComposeService
              - …
            - `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
        - `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_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_id` string, uuid
      - `port` integer
      - `post_run_command` string
      - `pre_run_command` string
      - `proxy_server` string
      - `repository` string
      - `routing_strategy` string
      - `servers` object[], nullable
        - `application_id` string, uuid
        - `created_at` string, date-time
        - `id` string, uuid
        - `is_primary` boolean
        - `server` object, nullable
          - `auth_method` string
          - `created_at` string, date-time
          - `deleted_at` string, date-time, nullable
          - `description` string, nullable
          - `fingerprint` string, nullable
          - `host` string, nullable
          - `id` string, uuid
          - `is_active` boolean
          - `is_default` boolean
          - `key_size` integer, nullable
          - `key_type` string, nullable
          - `last_used_at` string, date-time, nullable
          - `name` string
          - `organization_id` string, uuid
          - `port` integer, nullable
          - `proxy_host` string, nullable
          - `public_key` string, nullable
          - `updated_at` string, date-time
          - `user` string, nullable
        - `server_id` string, uuid
      - `source` string
      - `status` object, nullable
        - `application_id` string, uuid
        - `created_at` string, date-time
        - `id` string, uuid
        - `status` string
        - `updated_at` string, date-time
      - `template_id` string, uuid
      - `updated_at` string, date-time
      - `user_id` string, uuid
    - `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`

---

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