---
title: "Your key and its history"
method: GET
path: "/api/v1/userkeys"
tags: ["Devices"]
---

# Your key and its history

`GET /api/v1/userkeys`

## Request

- Base URL: `https://saltapp.ai`
- URL: `https://saltapp.ai/api/v1/userkeys`
- Auth: API key in header `api-key`

The active key at the top level (`generation` included) and `retired:[{generation, public_fingerprint, encrypted_private_key, retired_at}]`, newest first: the keyring a client decrypts with. A vault key is ciphertext under your messages key; an `sld_` device gets public fields and retired fingerprints only.

## Response `200`

OK.

- object
  - `public_key` string
  - `public_fingerprint` string
  - `generation` integer
  - `encryption_scheme` string
  - `encrypted_private_key` string
  - `retired` object[]

## Other responses

- `401`: Missing or invalid credentials.

---

[API](https://skmtc.dev/saltapp/apis/salt-agent-api.md) · [All operations](https://skmtc.dev/saltapp/apis/salt-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/saltapp/apis/salt-agent-api/revisions/a8b8642ab7f8?raw)