---
title: "Get an API key"
method: GET
path: "/org/api-keys/{keyId}"
tags: ["API Keys"]
---

# Get an API key

`GET /org/api-keys/{keyId}`

## Request

- Base URL: `https://apiv2.senso.ai/api/v1`
- URL: `https://apiv2.senso.ai/api/v1/org/api-keys/{keyId}`
- Auth: API key in header `X-API-Key`

Returns one of your organization's API keys by id (never its secret value).

## Path parameters

- `keyId` string, uuid, required

## Response `200`

The API key.

- APIKeyResponse: An API key's metadata. The secret key value is never included — it is returned once, at creation.
  - `id` string, uuid, required
  - `organization_id` string, uuid, required
  - `name` string, required
  - `scoped` boolean, required: Whether the key is restricted to specific knowledge-base folders (see `GET /org/api-keys/{keyId}/kb-permissions`).
  - `expires_at` string, date-time: When the key expires, if an expiry was set.
  - `revoked_at` string, date-time: When the key was revoked. These read endpoints return only active keys, so this is always absent here.
  - `last_used_at` string, date-time: When the key was last used, if ever.
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `400`: The request was malformed — a bad path/query parameter or an invalid value.
- `401`: Missing or invalid credentials — supply a valid org API key in the `X-API-Key` header.
- `404`: The requested resource does not exist or is not visible to this key.

---

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