---
title: "Get current API key"
method: GET
path: "/key"
tags: ["API Keys"]
---

# Get current API key

`GET /key`

Get information on the API key associated with the current authentication session

## Response `200`

API key details

- object
  - `data` object, required — Current API key information
    - `allowed_data_regions` string[], required — Data regions permitted for this API key by the guardrail policies on the key and the account regional-routing entitlement. Empty when no region is permitted. Reflects region policy only: other key restrictions, such as management keys being blocked from inference, still apply.
    - `byok_usage` number, double, required — Total external BYOK usage (in USD) for the API key
    - `byok_usage_daily` number, double, required — External BYOK usage (in USD) for the current UTC day
    - `byok_usage_monthly` number, double, required — External BYOK usage (in USD) for current UTC month
    - `byok_usage_weekly` number, double, required — External BYOK usage (in USD) for the current UTC week (Monday-Sunday)
    - `creator_user_id` string, nullable, required — The user ID of the key creator. For organization-owned keys, this is the member who created the key. For individual users, this is the user's own ID.
    - `expires_at` string, date-time, nullable — ISO 8601 UTC timestamp when the API key expires, or null if no expiration
    - `free_model_daily_requests` FreeModelDailyRequests, required — Free-model (`:free` variant) daily request quota for the account that owns the key. Reports the same counter and tier limit that free-model enforcement reads for accounts subject to the free-model limits; the counter resets at UTC midnight. Accounts and endpoints exempt from free-model limits, and BYOK requests, are not gated by it, so `remaining` is the tier policy rather than an enforced ceiling for them.
      - `limit` integer, required — Free-model requests the account may make per UTC day; the ceiling depends on total credits purchased and is independent of `is_free_tier`
      - `remaining` integer, required — Free-model requests left in the current UTC day
      - `used` integer, required — Free-model requests recorded for the account so far in the current UTC day
    - `include_byok_in_limit` boolean, required — Whether to include external BYOK usage in the credit limit
    - `is_free_tier` boolean, required — Whether this is a free tier API key
    - `is_management_key` boolean, required — Whether this is a management key
    - `is_provisioning_key` boolean, required — Whether this is a management key
    - `label` string, required — Human-readable label for the API key
    - `limit` number, double, nullable, required — Spending limit for the API key in USD
    - `limit_remaining` number, double, nullable, required — Remaining spending limit in USD
    - `limit_reset` string, nullable, required — Type of limit reset for the API key
    - `organization_id` string, nullable, required — The ID of the organization that owns this API key, or null when an individual account owns it.
    - `rate_limit` object, required — Legacy rate limit information about a key. Will always return -1.
      - `interval` string, required — Rate limit interval
      - `note` string, required — Note about the rate limit
      - `requests` integer, required — Number of requests allowed per interval
    - `usage` number, double, required — Total OpenRouter credit usage (in USD) for the API key
    - `usage_daily` number, double, required — OpenRouter credit usage (in USD) for the current UTC day
    - `usage_monthly` number, double, required — OpenRouter credit usage (in USD) for the current UTC month
    - `usage_weekly` number, double, required — OpenRouter credit usage (in USD) for the current UTC week (Monday-Sunday)
    - `workspace_id` string, nullable, required — The ID of the workspace this API key spends in, or null when no active workspace resolved for it, for example because the key's workspace was deleted.

## Other responses

- `401` — Unauthorized - Authentication required or invalid credentials
- `500` — Internal Server Error - Unexpected server error

## Changes

- **2026-09-19** `a47830bad6dd` — 2 info
  - added the required property `data/organization_id` to the response with the `200` status
  - added the required property `data/workspace_id` to the response with the `200` status
- **2026-09-16** `f0cbaaa19378` — 1 info
  - added the required property `data/allowed_data_regions` to the response with the `200` status
- **2026-09-16** `283f5eb47be6` — 1 info
  - added the required property `data/free_model_daily_requests` to the response with the `200` status

[Change history](https://skmtc.dev/openrouterteam/apis/openrouter-api/changes/key/get.md)

---

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