---
title: "Get API key"
method: GET
path: "/api/v1/api-keys/{id}"
tags: ["API Keys"]
---

# Get API key

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

Get an API key's metadata. The secret is never returned — only the prefix.

## Path parameters

- `id` string, uuid, required

## Response `200`

API key details

- object
  - `success` boolean
  - `data` APIKey
    - `id` string, uuid, required
    - `account_id` string, uuid
    - `name` string, required
    - `key_prefix` string, required — First 13 characters of the key — the `raff_` prefix plus the first 8 hex characters (e.g. `raff_17d70fcf`). The full secret is only returned once at create or regenerate time.
    - `scope` 'public' — Always `public` for customer-created keys
    - `rate_limit_tier` 'standard' | 'high' — Rate-limit tier. Standard is 30 RPS / burst 60; High is 100 RPS / burst 200.
    - `expires_at` string, date-time — When the key auto-expires. Omitted for never-expires keys.
    - `last_used_at` string, date-time
    - `is_active` boolean, required
    - `role_id` string, uuid — Account-level role this key uses
    - `role_name` string
    - `role_slug` string
    - `project_accesses` APIKeyProjectAccess[] — Per-project access grants
      - `project_id` string, uuid
      - `project_name` string
      - `role_id` string, uuid
      - `role_name` string
      - `role_slug` string
    - `created_by` string, uuid
    - `created_at` string, date-time

## Other responses

- `404` — Resource not found

---

[API](https://skmtc.net/rafftechnologies/apis/raff-api.md) · [All operations](https://skmtc.net/rafftechnologies/apis/raff-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rafftechnologies/raff-api/versions/a3f123570011/schema)