---
title: "List hosted on-prem deployments for ops"
method: GET
path: "/onprem/v1/hosted-deployments"
tags: ["onprem", "onprem"]
---

# List hosted on-prem deployments for ops

`GET /onprem/v1/hosted-deployments`

## Query parameters

- `status` 'pending' | 'provisioning' | 'ready' | 'failed' | 'destroying' | 'destroyed' | 'upgrade_pending' | 'upgrading' | 'pause_pending' | 'pausing' | 'resume_after_pause' | 'paused' | 'pause_failed' | 'resume_pending' | 'resuming' | 'resume_failed', nullable
- `limit` integer

## Response `200`

Success

- SuccessResponseListHostedDeploymentRow
  - `success` true, required — Flag for it request was successful
  - `data` HostedDeploymentRow[], required — Response data
    - `id` union, required
      - string, uuid
      - string
    - `signup_id` union, required
      - string, uuid
      - string
    - `license_id` union, required
      - string, uuid
      - string
    - `deployment_id` string, nullable
    - `status` 'pending' | 'provisioning' | 'ready' | 'failed' | 'destroying' | 'destroyed' | 'upgrade_pending' | 'upgrading' | 'pause_pending' | 'pausing' | 'resume_after_pause' | 'paused' | 'pause_failed' | 'resume_pending' | 'resuming' | 'resume_failed', required
    - `customer_slug` string, required
    - `cloud_provider` 'gcp' | 'aws'
    - `gcp_project_id` string, nullable
    - `gcp_project_number` string, nullable
    - `aws_account_id` string, nullable
    - `aws_cluster_name` string, nullable
    - `region` string
    - `hostname` string, nullable
    - `base_url` string, nullable
    - `image_tag` string, nullable
    - `desired_image_tag` string, nullable
    - `egress_ip` string, nullable
    - `release_channel` 'stable' | 'canary' | 'pinned'
    - `helm_overrides` object, nullable
    - `sso_allowed_domains` string[], nullable
    - `license_key_secret_id` string, required
    - `terraform_state_prefix` string, nullable
    - `migrate_active` boolean
    - `last_error` string, nullable
    - `ready_at` string, date-time, nullable
    - `upgraded_at` string, date-time, nullable
    - `destroyed_at` string, date-time, nullable
    - `auto_pause_exempt_until` string, date-time, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `meta` ResponseMeta
    - `requestId` string — Unique request identifier for tracing
    - `timestamp` string, date-time — Response timestamp (UTC)
    - `durationMs` integer, nullable — Request processing time in milliseconds

## Other responses

- `401` — Auth Invalid Token
- `403` — Forbidden Insufficient Permissions
- `422` — Validation Failed
- `426` — Business Quota Exceeded
- `500` — Internal Error

---

[API](https://skmtc.dev/definite/apis/defapi.md) · [All operations](https://skmtc.dev/definite/apis/defapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/definite/defapi/revisions/5ea378187147/schema)