Users, Wishlist, Alerts, and Notifications

All endpoints in this section require an OAuth access token.

User and wishlist

GET /me returns the current user profile and granted scopes. GET /wishlist returns the user's items; POST /wishlist/items adds { "game_id": "game_..." }, while DELETE /wishlist/items/{game_id} removes it. Required scope: wishlist:read or wishlist:write.

Alerts

GET /alerts lists alerts. POST /alerts creates a target-price or discount alert. A request may contain game_id, region, target_amount, currency, min_discount_percent, store_ids, and channels. At least one condition must be supplied. PATCH /alerts/{alert_id} changes active fields; DELETE /alerts/{alert_id} removes it.

{"data":{"id":"alert_01J4Q8BAVP4E","game_id":"game_01J2M4T5K7HADES2","region":"US","target_amount":"18.00","currency":"USD","channels":["email","webhook"],"status":"active","created_at":"2026-11-06T10:04:00Z"},"meta":{"request_id":"req_01J3KZ6VPG8J"}}

Notifications

GET /notifications returns delivery records ordered by created_at. PATCH /notifications/{notification_id} with { "read_at": "2026-11-06T10:12:00Z" } marks one as read. Notification preferences are configured at PATCH /me/notification-preferences; channels are email, webhook, and in_app.