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

# List Deployment Aliases

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

## Request

- Base URL: `https://api.vercel.com`
- URL: `https://api.vercel.com/v2/deployments/{id}/aliases`
- Auth: HTTP bearer

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
    - `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
    - `protectionBypass` object: The protection bypass for the alias
    - `redirect` string, nullable: Target destination domain for redirect when the alias is a redirect
    - `uid` string, required: The unique identifier of 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`

## Changes

- **2026-07-21** `2ae10ee9d21c`: 1 info
  - added the non-success response with the status `410`
- **2025-10-09** `50caddad4ae7`: 1 info
  - added the optional property `aliases/items/protectionBypass/additionalProperties/oneOf[subschema #1]/expires` to the response with the `200` status
- **2025-03-19** `37b482c58c92`: 2 breaking, 2 info
  - added `subschema #1, subschema #2, subschema #3, subschema #4` to the `aliases/items/protectionBypass/additionalProperties/` response property `oneOf` list for the response status `200`
  - the `aliases/items/protectionBypass/additionalProperties/` response's property type changed from `string` to no type for status `200`
  - added the new optional `query` request parameter `slug`
  - added the non-success response with the status `401`
- **2022-12-06** `8eb562567170`: 1 info
  - added the optional property `aliases/items/protectionBypass` to the response with the `200` status

[Operation history](https://skmtc.dev/vercel/apis/vercel-api/changes/v2/deployments/:id/aliases/get.md)

---

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