---
title: "Retrieves a list of individual key versions with the same key name."
method: GET
path: "/keys/{key-name}/versions"
tags: ["Keys"]
---

# Retrieves a list of individual key versions with the same key name.

`GET /keys/{key-name}/versions`

The full key identifier, attributes, and tags are provided in the response. This operation requires the keys/list permission.

## Path parameters

- `key-name` string, required

## Query parameters

- `maxresults` integer
- `api-version` string, required

## Response `200`

A response message containing a list of keys along with a link to the next page of keys.

- KeyListResult — The key list result.
  - `value` KeyItem[] — A response message containing a list of keys in the key vault along with a link to the next page of keys.
    - `kid` string — Key identifier.
    - `attributes` KeyAttributes — The object attributes managed by the KeyVault service.
      - `enabled` boolean — Determines whether the object is enabled.
      - `nbf` integer — Not before date in UTC.
      - `exp` integer — Expiry date in UTC.
      - `created` integer — Creation time in UTC.
      - `updated` integer — Last updated time in UTC.
    - `tags` object — Application specific metadata in the form of key-value pairs.
    - `managed` boolean — True if the key's lifetime is managed by key vault. If this is a key backing a certificate, then managed will be true.
  - `nextLink` string — The URL to get the next set of keys.

## Other responses

- `default` — Key Vault error response describing why the operation failed.

---

[API](https://skmtc.net/azure/apis/keyvaultclient.md) · [All operations](https://skmtc.net/azure/apis/keyvaultclient/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/keyvaultclient/revisions/1f612999ec40/schema)