---
title: "GET /api/keys/{id}"
method: GET
path: "/api/keys/{id}"
tags: ["api", "api_keys"]
---

# GET /api/keys/{id}

`GET /api/keys/{id}`

Get an API Key

## Path parameters

- `id` string, required — The ID of the API key.

## Response `200`

OK

- RedactedAPIKeyResource
  - `_id` string, required — The ID of the API key.
  - `active` boolean — Whether the API key can be used to authenticate against the API.
  - `name` string, required — An internal name to identify the API key.
  - `sellerId` string — The ID of the seller that owns the API key.
  - `orgId` string — The ID of the organisation that owns the API key.
  - `createdBy` object — The entity that created the API key.
    - `type` 'USER' | 'APP' | 'API_KEY' | 'SYSTEM', required — The type of the entity
    - `id` string, required — The ID of the entity
  - `createdAt` string, date-time, required — An ISO Timestamp indicating when the API Key was created.
  - `updatedAt` string, date-time, required — An ISO Timestamp indicating when the API Key was last updated.
  - `expiresAt` string, date-time, nullable — Optional ISO instant after which the key no longer authenticates; omit or null for no automatic expiry.
  - `version` integer — The version of the API key.
  - `fullSellerAccess` boolean — Seller keys only: when true, grants full seller access (seller-admin equivalent).
  - `permissions` string[] — Explicit permissions

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

## Changes

- **2026-09-05** `0c9cb42c536a` — 3 info
  - added the optional property `fullSellerAccess` to the response with the `200` status
  - added the optional property `permissions` to the response with the `200` status
  - added the optional property `version` to the response with the `200` status

[Change history](https://skmtc.dev/vivenu/apis/vivenu-api/changes/api/keys/:id/get.md)

---

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