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)| Parameters | Type | Required | Description |
|---|---|---|---|
| verifyApiKeyRequest | VerifyApiKeyRequest | 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 | VerifyApiKeyResponse |