Get Item Catalog Page
horizon_get_item_catalogRead a single page of item templates and archived catalog entries with keyset pagination for displaying item details or reviewing a catalog.
Instructions
Reads one bounded item template page, including archived templates. Use when: showing item details or reviewing a catalog with explicit keyset pagination. Not for: automatically scanning the whole catalog or combining pages from different revisions. 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: {revision,definitions,nextAfterKey,total,limits,serverTime}. Retain the first revision for later pages; null cursor ends the list. Errors: 409 REVISION_CONFLICT or an uncertain response: use horizon_get_items and reconcile intent, never silently substitute a new revision and repeat. 404 ITEM_NOT_FOUND means this instance no longer exists. 422 ITEM_PROPERTY_NOT_ALLOWED/ITEM_PROPERTY_LIMIT_REACHED rejects the entire adjustment. 401 means the session is missing or expired: sign in again and retry with the new accessToken. 403 for a session means the token belongs to another user: pass the userId that signed in. 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 |
|---|---|---|---|
| limit | No | Explicit page size, default 50; never automatically fetch all pages | |
| userId | Yes | Signed-in player UUID matching the session | |
| afterKey | No | Previous nextAfterKey, or omit for the first page | |
| sessionToken | Yes | Player accessToken sent only as Authorization Bearer | |
| catalogRevision | No | First page revision, retained unchanged on later pages; conflict requires restarting the catalog read |