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)| Parameters | Type | Required | Description |
|---|---|---|---|
| batchVerifyApiKeysRequest | BatchVerifyApiKeysRequest | required | |
| cacheControl | string | optional | Cache-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. |
| pragma | string | optional | HTTP/1.0 alias for `Cache-Control: no-cache`. Behaves identically when set to `no-cache`; ignored otherwise. |
| Variable | Type |
|---|---|
| data | BatchVerifyApiKeysResponse |