---
title: "List Deployments"
method: GET
path: "/ai/deployment"
tags: ["deployment"]
---

# List Deployments

`GET /ai/deployment`

## Request

- Base URL: `https://api-ch-gva-2.exoscale.com/v2`
- URL: `https://api-ch-gva-2.exoscale.com/v2/ai/deployment`
- Auth: none declared
- TypeScript: <https://skmtc.dev/exoscale/apis/exoscale-api/docs/ai/deployment/get.ts> (a function with typed inputs; its response is checked against the schema)

List Deployments

## Query parameters

- `visibility` string

## Response `200`

OK

- ListDeploymentsResponse: AI deployment list
  - `deployments` ListDeploymentsResponseEntry[], required
    - `gpu-count` integer: Number of GPUs
    - `updated-at` string, date-time: Update time
    - `deployment-url` string, required: Deployment inference endpoint URL
    - `service-level` string: Service level
    - `name` string, required: Deployment name
    - `state` 'ready' | 'creating' | 'preparing' | 'error' | 'deploying' | 'scaling' | 'updating', required: Deployment state
    - `gpu-type` string: GPU type family
    - `id` string, uuid: Deployment ID
    - `replicas` integer: Number of replicas (>=0)
    - `created-at` string, date-time: Creation time
    - `visibility` 'public' | 'private', required: Deployment visibility: private for your organization's deployments, public for Exoscale Managed Inference deployments.
    - `model` ModelRef, required: Model reference. Provide either id or name.
      - `name` string: Associated model name
      - `id` string, uuid: Associated model ID

## Other responses

- `400`: Bad Request

## Changes

- **2026-11-06** `63da6f74c845`: 3 warning, 8 info
  - added the new `preparing` enum value to the `deployments/items/state` response property for the response status `200`
  - added the new `scaling` enum value to the `deployments/items/state` response property for the response status `200`
  - added the new `updating` enum value to the `deployments/items/state` response property for the response status `200`
  - added the new optional `query` request parameter `visibility`
  - …7 more
- **2026-03-16** `e05707a7b346`: 1 warning, 3 info
  - removed the optional property `deployments/items/status` from the response with the `200` status
  - api tag `deployment` added
  - api tag `dedicated-inference` removed
  - added the optional property `deployments/items/state` to the response with the `200` status
- **2025-11-14** `352cae63dff6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/exoscale/apis/exoscale-api/changes/ai/deployment/get.md)

---

[API](https://skmtc.dev/exoscale/apis/exoscale-api.md) - [All operations](https://skmtc.dev/exoscale/apis/exoscale-api/llms.txt) - [OpenAPI document](https://skmtc.dev/exoscale/apis/exoscale-api/revisions/63da6f74c845?raw)