Skip to main content
The TypeScript SDK and docs are currently in beta. Report issues on GitHub.
The API key information

​
Example Usage

import { GetKeyData } from "@openrouter/sdk/models/operations";

let value: GetKeyData = {
  hash:
    "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",
  name: "My Production Key",
  label: "Production API Key",
  disabled: false,
  limit: 100,
  limitRemaining: 74.5,
  limitReset: "monthly",
  includeByokInLimit: false,
  usage: 25.5,
  usageDaily: 25.5,
  usageWeekly: 25.5,
  usageMonthly: 25.5,
  byokUsage: 17.38,
  byokUsageDaily: 17.38,
  byokUsageWeekly: 17.38,
  byokUsageMonthly: 17.38,
  createdAt: "2025-08-24T10:30:00Z",
  updatedAt: "2025-08-24T15:45:00Z",
};

​
Fields

FieldTypeRequiredDescriptionExample
hashstring:heavy_check_mark:Unique hash identifier for the API keysk-or-v1-0e6f44a47a05f1dad2ad7e88c4c1d6b77688157716fb1a5271146f7464951c96
namestring:heavy_check_mark:Name of the API keyMy Production Key
labelstring:heavy_check_mark:Human-readable label for the API keyProduction API Key
disabledboolean:heavy_check_mark:Whether the API key is disabledfalse
limitnumber:heavy_check_mark:Spending limit for the API key in USD100
limitRemainingnumber:heavy_check_mark:Remaining spending limit in USD74.5
limitResetstring:heavy_check_mark:Type of limit reset for the API keymonthly
includeByokInLimitboolean:heavy_check_mark:Whether to include external BYOK usage in the credit limitfalse
usagenumber:heavy_check_mark:Total OpenRouter credit usage (in USD) for the API key25.5
usageDailynumber:heavy_check_mark:OpenRouter credit usage (in USD) for the current UTC day25.5
usageWeeklynumber:heavy_check_mark:OpenRouter credit usage (in USD) for the current UTC week (Monday-Sunday)25.5
usageMonthlynumber:heavy_check_mark:OpenRouter credit usage (in USD) for the current UTC month25.5
byokUsagenumber:heavy_check_mark:Total external BYOK usage (in USD) for the API key17.38
byokUsageDailynumber:heavy_check_mark:External BYOK usage (in USD) for the current UTC day17.38
byokUsageWeeklynumber:heavy_check_mark:External BYOK usage (in USD) for the current UTC week (Monday-Sunday)17.38
byokUsageMonthlynumber:heavy_check_mark:External BYOK usage (in USD) for current UTC month17.38
createdAtstring:heavy_check_mark:ISO 8601 timestamp of when the API key was created2025-08-24T10:30:00Z
updatedAtstring:heavy_check_mark:ISO 8601 timestamp of when the API key was last updated2025-08-24T15:45:00Z
expiresAtDate:heavy_minus_sign:ISO 8601 UTC timestamp when the API key expires, or null if no expiration2027-12-31T23:59:59Z