Error Codes Reference - ZKScore Documentation

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

Code	Description	Resolution
`ZKS-001-001`	Identity not found	Verify ZKS ID exists
`ZKS-001-002`	Identity not activated	Activate identity first
`ZKS-002-001`	Invalid API key	Check API key
`ZKS-002-002`	Rate limit exceeded	Implement backoff
`ZKS-003-001`	Score not found	User has no score yet
`ZKS-004-001`	Achievement not found	Verify achievement ID
`ZKS-005-001`	Network error	Retry request

Glossary HTTP Status Codes