---
title: "Get API Key"
method: GET
path: "/api/api-keys/{id}"
tags: ["Beta APIs"]
---

# Get API Key

`GET /api/api-keys/{id}`

## Request

- Base URL: `https://a.klaviyo.com`
- URL: `https://a.klaviyo.com/api/api-keys/{id}`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/klaviyo/apis/klaviyo-api-beta/docs/api/api-keys/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

> 🚧 This endpoint is in beta and subject to change.
            >
            > A beta revision header (2026-10-15.pre) is required to use our beta APIs. Klaviyo APIs in beta are not intended for use in production. See our [versioning and deprecation policy](https://developers.klaviyo.com/en/docs/api_versioning_and_deprecation_policy) for more information.

Retrieve a single private API key by id.<br><br>*Rate limits*:<br>Burst: `1/s`<br>Steady: `15/m`

**Scopes:**
`credentials:read`

[OpenAPI Spec](https://raw.githubusercontent.com/klaviyo/openapi/main/openapi/beta/apis/get_api_key_beta.json)

## Path parameters

- `id` string, required: Identifier for the key.

## Query parameters

- `additional-fields[api-key]` string[]
- `fields[api-key]` string[]

## Headers

- `revision` string, required

## Response `200`

Success

- GetApiKeyResponse
  - `data` object, required
    - `type` 'api-key', required
    - `attributes` object, required
      - `redacted_key` string, nullable: Masked form of the key showing only the last four characters. Returned only when requested via ``additional-fields[api-key]=redacted_key``.
      - `name` string, required: Human-readable label set on the key.
      - `status` 'active' | 'disabled', required: Whether the key is active or disabled.
      - `scopes` string[], required: API scopes granted to this key.
      - `created` string, date-time, required: Date and time when the key was created, in ISO 8601 format (YYYY-MM-DDTHH:MM:SS.mmmmmm).
    - `id` string, required: Identifier for the key.
    - `links` ObjectLinks, required
      - `self` string, uri, required
  - `links` ObjectLinks
    - `self` string, uri, required
  - `meta` ResponseMeta: Response-level metadata
    - `agent_hints` AgentHints: Optional hints emitted by the API for agent callers
      - `next_steps` string[]: Suggested follow-up actions for agents to take after this response

## Other responses

- `4XX`: Client Error
- `5XX`: Server Error

## Changes

- **2026-11-04** `67d4dca13074`: 1 warning
  - added the new `experiments:read` enum value to the `data/allOf[#/components/schemas/ApiKeyResponseObjectResource]/attributes/scopes/items/` response property for the response status `200`
- **2026-10-15** `e06c9e59da3b`: 4 warning
  - added the new `locations:read` enum value to the `data/allOf[#/components/schemas/ApiKeyResponseObjectResource]/attributes/scopes/items/` response property for the response status `200`
  - added the new `locations:write` enum value to the `data/allOf[#/components/schemas/ApiKeyResponseObjectResource]/attributes/scopes/items/` response property for the response status `200`
  - added the new `messages:read` enum value to the `data/allOf[#/components/schemas/ApiKeyResponseObjectResource]/attributes/scopes/items/` response property for the response status `200`
  - added the new `messages:write` enum value to the `data/allOf[#/components/schemas/ApiKeyResponseObjectResource]/attributes/scopes/items/` response property for the response status `200`
- **2026-09-30** `bd9b937a9d74`: 1 warning
  - added the new `social:read` enum value to the `data/allOf[#/components/schemas/ApiKeyResponseObjectResource]/attributes/scopes/items/` response property for the response status `200`
- …earlier changes not shown

[Operation history](https://skmtc.dev/klaviyo/apis/klaviyo-api-beta/changes/api/api-keys/:id/get.md)

---

[API](https://skmtc.dev/klaviyo/apis/klaviyo-api-beta.md) - [All operations](https://skmtc.dev/klaviyo/apis/klaviyo-api-beta/llms.txt) - [OpenAPI document](https://skmtc.dev/klaviyo/apis/klaviyo-api-beta/revisions/67d4dca13074?raw)