---
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

---

[API](https://skmtc.net/flock/apis/litellm-api.md) · [All operations](https://skmtc.net/flock/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/flock/litellm-api/revisions/8fbaab4fc7c5/schema)
