---
title: "Key Aliases"
method: GET
path: "/key/aliases"
tags: ["key management"]
---

# Key Aliases

`GET /key/aliases`

Lists key aliases with pagination and optional search.

Non-admin users only see aliases for keys they own or keys belonging to
their teams.

Returns:
    {
        "aliases": List[str],
        "total_count": int,
        "current_page": int,
        "total_pages": int,
        "size": int,
    }

## Query parameters

- `page` integer — Page number
- `size` integer — Page size
- `search` string, nullable — Search key aliases (case-insensitive partial match)
- `team_id` string, nullable — Filter aliases to keys belonging to this team

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-18** `082b5fabd909` — 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

[Change history](https://skmtc.dev/flock/apis/litellm-api/changes/key/aliases/get.md)

---

[API](https://skmtc.dev/flock/apis/litellm-api.md) · [All operations](https://skmtc.dev/flock/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/flock/apis/litellm-api/revisions/3b2b241e4b0b?raw)