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

​
Example Usage

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

let value: GetCurrentKeyData = {
  label: "sk-or-v1-au78b3456789012345678901234567890",
  limit: 100,
  usage: 25.5,
  usageDaily: 25.5,
  usageWeekly: 25.5,
  usageMonthly: 25.5,
  byokUsage: 17.38,
  byokUsageDaily: 17.38,
  byokUsageWeekly: 17.38,
  byokUsageMonthly: 17.38,
  isFreeTier: false,
  isProvisioningKey: false,
  limitRemaining: 74.5,
  limitReset: "monthly",
  includeByokInLimit: false,
  rateLimit: {
    requests: 1000,
    interval: "1h",
    note: "This field is deprecated and safe to ignore.",
  },
};

​
Fields

FieldTypeRequiredDescriptionExample
labelstring:heavy_check_mark:Human-readable label for the API keysk-or-v1-0e6f44a47a05f1dad2ad7e88c4c1d6b77688157716fb1a5271146f7464951c96
limitnumber:heavy_check_mark:Spending limit for the API key in USD100
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
isFreeTierboolean:heavy_check_mark:Whether this is a free tier API keyfalse
isProvisioningKeyboolean:heavy_check_mark:Whether this is a provisioning keyfalse
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
expiresAtDate:heavy_minus_sign:ISO 8601 UTC timestamp when the API key expires, or null if no expiration2027-12-31T23:59:59Z
rateLimitoperations.RateLimit:heavy_check_mark:: warning: ** DEPRECATED **: This will be removed in a future release, please migrate away from it as soon as possible.

Legacy rate limit information about a key. Will always return -1.		{"requests": 1000,"interval": "1h","note": "This field is deprecated and safe to ignore."}