Skip to main content

Overview

Comprehensive list of all error codes returned by the ZKScore API.

Error Code Format

Error codes follow the pattern: ZKS-XXX-YYY
  • XXX: Category code
  • YYY: Specific error number

Common Error Codes

CodeDescriptionResolution
ZKS-001-001Identity not foundVerify ZKS ID exists
ZKS-001-002Identity not activatedActivate identity first
ZKS-002-001Invalid API keyCheck API key
ZKS-002-002Rate limit exceededImplement backoff
ZKS-003-001Score not foundUser has no score yet
ZKS-004-001Achievement not foundVerify achievement ID
ZKS-005-001Network errorRetry request