New Ory Agent Security is now live! Claim your complimentary test drive. Get Started!

Skip to main content

Verify API Key

POST 

/v2alpha1/admin/apiKeys:verify

Verifies a single API key or derived token. Validates the credential's signature, expiration, and revocation status. Works with any credential type (issued keys, imported keys, JWT, macaroon). The verification result includes decoded claims and metadata — admin access only.

Cache Control (HTTP Headers):

  • Cache-Control: no-cache - Bypasses cache read, forces fresh DB lookup
  • Cache-Control: no-store - Bypasses cache read AND write (never cached)
  • Pragma: no-cache - Same as Cache-Control: no-cache (HTTP/1.0)
POST /v2alpha1/admin/apiKeys:verify
{
"credential": "sk_live_abc123..."
}
SDK ReferenceTypeScript
adminVerifyApiKey(verifyApiKeyRequest)
ParametersTypeRequiredDescription
verifyApiKeyRequestVerifyApiKeyRequestrequired
cacheControlstringoptionalCache-directive controlling the verifier cache. `no-cache` forces a fresh database lookup (cache read is bypassed). `no-store` additionally prevents the result from being written to the cache. Any other value is ignored.
pragmastringoptionalHTTP/1.0 alias for `Cache-Control: no-cache`. Behaves identically when set to `no-cache`; ignored otherwise.
VariableType
dataVerifyApiKeyResponse