---
title: "GET /v2/GetKeyInfo"
method: GET
path: "/v2/GetKeyInfo"
tags: ["Access key"]
---

# GET /v2/GetKeyInfo

`GET /v2/GetKeyInfo`

Return information about a specific key like its identifiers, its permissions and buckets on which it has permissions.
You can search by specifying the exact key identifier (`id`) or by specifying a pattern (`search`).

For confidentiality reasons, the secret key is not returned by default: you must pass the `showSecretKey` query parameter to get it.

## Query parameters

- `id` string
- `search` string
- `showSecretKey` boolean

## Response `200`

Information about the access key

- GetKeyInfoResponse
  - `accessKeyId` string, required
  - `buckets` KeyInfoBucketResponse[], required
    - `globalAliases` string[], required
    - `id` string, required
    - `localAliases` string[], required
    - `permissions` ApiBucketKeyPerm, required
      - `owner` boolean
      - `read` boolean
      - `write` boolean
  - `created` string, date-time, nullable
  - `expiration` string, date-time, nullable
  - `expired` boolean, required
  - `name` string, required
  - `permissions` KeyPerm, required
    - `createBucket` boolean
  - `secretAccessKey` string, nullable

## Other responses

- `500` — Internal server error

---

[API](https://skmtc.dev/deuxfleurs/apis/garage-administration-api.md) · [All operations](https://skmtc.dev/deuxfleurs/apis/garage-administration-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/deuxfleurs/garage-administration-api/revisions/07ffb2d0febb/schema)