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

Skip to main content

Batch Verify API Keys

POST 

/v2alpha1/admin/apiKeys:batchVerify

Verifies multiple credentials in a single request. Efficiently verifies up to 100 credentials in parallel. Each credential is verified independently; partial failures are returned. 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)

The cache directive applies to every credential in the batch.

POST /v2alpha1/admin/apiKeys:batchVerify
{
"requests": [
{"credential": "sk_live_abc123..."},
{"credential": "eyJhbGciOiJFZERTQSI..."}
]
}
SDK ReferenceTypeScript
adminBatchVerifyApiKeys(batchVerifyApiKeysRequest)
ParametersTypeRequiredDescription
batchVerifyApiKeysRequestBatchVerifyApiKeysRequestrequired
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
dataBatchVerifyApiKeysResponse