Get Statistics Definitions
horizon_get_statistics_definitionsRetrieves statistics definitions by version so you can show counter labels, modes, reset policies, and report bounds without loading player values.
Instructions
Reads the project's statistics catalog conditionally by version. Use when: showing counter labels, modes, reset policies and optional report bounds. Not for: loading player counter values; use horizon_get_statistics. Requires: userId and the player's session: sign in with horizon_signin_email or horizon_signin_anonymous and pass its accessToken as sessionToken. Side effects: None (read only). Returns: {definitionVersion, definitions}; definitions null means unchanged, an empty array means an empty catalog. Errors: 401 SESSION_REQUIRED: sign in again; 403 SESSION_FORBIDDEN: use the matching player. 409 OPERATION_CONFLICT means the ID was already used for a different payload. 410 OPERATION_EXPIRED rejects an expired/evicted unknown ID. Never replace an uncertain ID automatically. 422 UNKNOWN_STATISTIC/UPDATE_ABOVE_LIMIT/VALUE_OVERFLOW rejects the whole batch. Needs HORIZON_API_KEY. Every failure returns an error result (isError) with the HTTP status and body: a 401 that horizon_test_connection also returns means HORIZON_API_KEY is wrong, 429 means the account's per-minute rate limit was reached (wait a minute, then retry).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sessionToken | Yes | Player accessToken from horizon_signin_anonymous or horizon_signin_email; sent as Bearer | |
| definitionVersion | No | Last cached definitionVersion; omit to load the full catalog |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| definitions | Yes | ||
| definitionVersion | Yes |