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

# List deployments

`GET /deployments`

Returns a list of all registered deployments, including their endpoints and associated services.

## Response `200`

List of all registered deployments with their metadata

- ListDeploymentsResponse — List of all registered deployments
  - `deployments` DeploymentResponse[], required
    - union
      - object — Deployment response for HTTP deployments
        - `additional_headers` SerdeableHeaderHashMap — Proxy type to implement HashMap<HeaderName, HeaderValue> ser/de Use it directly or with `#[serde(with = "serde_with::As::<serde_with::FromInto<restate_serde_util::SerdeableHeaderMap>>")]`.
        - `auth` HttpAuth — HTTP authentication details.
          - `GoogleIdToken` GoogleIdTokenAuth, required
            - `audience` string, nullable — Explicit OIDC `aud` claim. Leave unset to automatically derive from the deployment URL.
            - `impersonate_service_account` string, nullable — Service account email to impersonate via `iamcredentials:generateIdToken`. Leave unset to use the ambient ADC identity.
        - `created_at` string, required
        - `http_version` string, required — # HTTP Version HTTP Version used to invoke this service deployment.
        - `id` string, required
        - `info` SchemaInfo[] — # Info List of configuration/deprecation information related to this deployment.
          - `code` string, nullable
          - `message` string, required
        - `max_protocol_version` integer, required — # Maximum Service Protocol version During registration, the SDKs declare a range from minimum (included) to maximum (included) Service Protocol supported version.
        - `metadata` object — # Metadata Deployment metadata.
        - `min_protocol_version` integer, required — # Minimum Service Protocol version During registration, the SDKs declare a range from minimum (included) to maximum (included) Service Protocol supported version.
        - `protocol_type` 'RequestResponse' | 'BidiStream', required
        - `sdk_version` string, nullable — # SDK version SDK library and version declared during registration.
        - `services` ServiceNameRevPair[], required — # Services List of services exposed by this deployment.
          - `name` string, required
          - `revision` integer, required
        - `uri` string, uri, required — # Deployment URI URI used to invoke this service deployment.
      - object — Deployment response for Lambda deployments
        - `additional_headers` SerdeableHeaderHashMap — Proxy type to implement HashMap<HeaderName, HeaderValue> ser/de Use it directly or with `#[serde(with = "serde_with::As::<serde_with::FromInto<restate_serde_util::SerdeableHeaderMap>>")]`.
        - `arn` string, required
        - `assume_role_arn` string, nullable — # Assume role ARN Assume role ARN used to invoke this deployment. Check https://docs.restate.dev/category/aws-lambda for more details.
        - `compression` 'Zstd' — Lambda compression
        - `created_at` string, required
        - `id` string, required
        - `info` SchemaInfo[] — # Info List of configuration/deprecation information related to this deployment.
          - `code` string, nullable
          - `message` string, required
        - `max_protocol_version` integer, required — # Maximum Service Protocol version During registration, the SDKs declare a range from minimum (included) to maximum (included) Service Protocol supported version.
        - `metadata` object — # Metadata Deployment metadata.
        - `min_protocol_version` integer, required — # Minimum Service Protocol version During registration, the SDKs declare a range from minimum (included) to maximum (included) Service Protocol supported version.
        - `sdk_version` string, nullable — # SDK version SDK library and version declared during registration.
        - `services` ServiceNameRevPair[], required — # Services List of services exposed by this deployment.
          - `name` string, required
          - `revision` integer, required

## Changes

- **2026-06-19** `7381abc4d9a3` — 1 info
  - added the optional property `deployments/items/oneOf[subschema #1: HttpDeploymentResponse]/auth` to the response with the `200` status
- **2026-01-30** `059a44500a5c` — 1 breaking, 1 info
  - added `subschema #1: HttpDeploymentResponse, subschema #2: LambdaDeploymentResponse` to the `deployments/items/` response property `oneOf` list for the response status `200`
  - removed `subschema #1: HttpDeploymentResponse, subschema #2: LambdaDeploymentResponse` from the `deployments/items/` response property `anyOf` list for the response status `200`

[Change history](https://skmtc.dev/restatedev/apis/admin-api/changes/deployments/get.md)

---

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