---
title: "Introspect current API key"
method: GET
path: "/v1/api_key"
tags: ["API Key"]
---

# Introspect current API key

`GET /v1/api_key`

Returns the API key resource for the key authenticating this request. Useful for verifying which key is in use and discovering its current authorization context without inferring it from rejected requests.

## Response `200`

The authenticated API key

- ApiKeyResourceDto
  - `type` 'api_key', required — Resource type discriminator.
  - `id` string, required — Unique identifier of the API key.
  - `merchant_id` string, required — Identifier of the merchant the key belongs to.
  - `scopes` string[], required — The effective set of scopes for this key. Stored aliases (e.g. `full_access`, `read_only`) are always expanded to concrete `resource:action` scopes against the current registry before they appear here.
  - `ip_allow_list` string[], required — IP addresses or CIDR ranges this key is permitted to authenticate from. An empty array means the key is not IP-restricted.
  - `expires_at` string, date-time, nullable, required — ISO 8601 UTC timestamp at which this key expires. `null` if the key has no expiry.
  - `created_at` string, date-time, required — ISO 8601 UTC timestamp at which this key was created.
  - `updated_at` string, date-time, nullable, required — ISO 8601 UTC timestamp of the last update to this key (e.g. roll, IP allowlist change, revoke). `null` if the key has not been updated since creation.
  - `api_version` string, required — Effective API version for the request (header value or merchant pin).

## Changes

- **2026-07-24** `e2a23b7a5f9f` — 2 warning
  - added the new `account_holders:read` enum value to the `scopes/items/` response property for the response status `200`
  - added the new `account_holders:write` enum value to the `scopes/items/` response property for the response status `200`
- **2026-07-20** `34dee3db0e93` — 1 warning
  - added the new `transactions:read` enum value to the `scopes/items/` response property for the response status `200`
- **2026-07-10** `2df25917fff2` — 1 info
  - removed the `account_openings:write` enum value from the `scopes/items/` response property for the response status `200`
- **2026-07-08** `d879cc9cc2e7` — 1 warning
  - added the new `account_openings:write` enum value to the `scopes/items/` response property for the response status `200`
- **2026-05-07** `1bf74121838c` — 2 info
  - api tag `API Key` added
  - api tag `ApiKey` removed

[Full history](https://skmtc.dev/augustus/apis/augustus-banking-api/changes/v1/api_key/get.md)

---

[API](https://skmtc.dev/augustus/apis/augustus-banking-api.md) · [All operations](https://skmtc.dev/augustus/apis/augustus-banking-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/augustus/augustus-banking-api/revisions/37109d1ed976/schema)