Skip to main content
GET
Get Score

Overview

Retrieve the complete ZKScore for a user, including total score, rank, tier, and breakdown by category.

Parameters

string
required
ZKS ID (e.g., alice.zks) or wallet address (e.g., 0x742d35Cc...)
number
Specific chain ID to get score for (optional, defaults to aggregated score)
ZKS ID Support: When using a ZKS ID, the API returns aggregated scores across all linked wallets for that identity.

Response

boolean
Indicates if the request was successful
string | null
The ZKS ID (without .zks suffix), or null if not set
string
The primary wallet address
object

Examples

Response Example

Score Tiers