---
title: "Get details about an existing Shared Key"
method: GET
path: "/v2/sharedkeys/{sharedkey_id}"
tags: ["v2"]
---

# Get details about an existing Shared Key

`GET /v2/sharedkeys/{sharedkey_id}`

## Headers

- `Client-Agent` string
- `X-Fields` string, mask

## Response `200`

Shared Key Details

- SharedKeyDetails
  - `id` string — The SharedKey ID.
  - `username` string — The owning user's unique Username. It is a combination of their chosen alias plus their ID.
  - `name` string — The Shared Key Name.
  - `kudos` integer — The Kudos limit assigned to this key.
  - `expiry` string, date-time — The date at which this API key will expire.
  - `utilized` integer — How much kudos has been utilized via this shared key until now.
  - `max_image_pixels` integer — The maximum amount of image pixels this key can generate per job. -1 means unlimited.
  - `max_image_steps` integer — The maximum amount of image steps this key can use per job. -1 means unlimited.
  - `max_text_tokens` integer — The maximum amount of text tokens this key can generate per job. -1 means unlimited.

## Other responses

- `401` — Invalid API Key
- `404` — Shared Key Not Found

---

[API](https://skmtc.net/haidra-org/apis/ai-horde.md) · [All operations](https://skmtc.net/haidra-org/apis/ai-horde/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/haidra-org/ai-horde/versions/dfeb0bedd935/schema)