---
title: "List Deployment Aliases"
method: GET
path: "/v2/deployments/{id}/aliases"
tags: ["aliases"]
---

# List Deployment Aliases

`GET /v2/deployments/{id}/aliases`

Retrieves all Aliases for the Deployment with the given ID. The authenticated user or team must own the deployment.

## Path parameters

- `id` string, required — The ID of the deployment the aliases should be listed for

## Query parameters

- `teamId` string
- `slug` string

## Response `200`

The list of aliases assigned to the deployment

- object
  - `aliases` object[], required — A list of the aliases assigned to the deployment
    - `uid` string, required — The unique identifier of the alias
    - `alias` string, required — The alias name, it could be a `.vercel.app` subdomain or a custom domain
    - `created` string, date-time, required — The date when the alias was created
    - `redirect` string, nullable — Target destination domain for redirect when the alias is a redirect
    - `protectionBypass` object — The protection bypass for the alias

## Other responses

- `400` — One of the provided values in the request query is invalid.
- `401` — The request is not authorized.
- `403` — You do not have permission to access this resource.
- `404` — The deployment was not found
- `410`

---

[API](https://skmtc.net/vercel/apis/api.md) · [All operations](https://skmtc.net/vercel/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vercel/api/versions/61d1ba3f6dac/schema)