Plan

Subscription rotation plan: the smartest way to play a list of games

Month-by-month plan for up to 30 games: buy at the cheapest measured real price, or play inside a subscription month while the game is in the catalog. Honors weekly hours (default 10, a subscription month is 4 weeks), announced leave dates and the subscriptions you already own (owned_subscriptions, marginal cost 0). Totals compare against buying every game at its cheapest measured price, never list price. Games without a reliable main-story length (free to play, live service, multiplayer only, missing) are left out of every time-based calculation and listed in excluded. Future months assume a game stays in its catalog unless a leave date is known (assumes_catalog_stays). assumptions repeats the inputs; every price carries buy_price_fetched_at. No API key needed; the keyless per-IP limits apply. Nothing is stored.

post/v1/plan

Request

  • Base URL: https://api.fairly.gg
  • URL: https://api.fairly.gg/v1/plan
  • Auth: one of:
    • API key in header X-Api-Key
    • none

Request body

gamesstring[] nullable required
owned_subscriptionsstring[] nullable required
hours_per_weeknumber double nullable required
regionstring nullable required
currencystring nullable required
include_marketplacesboolean nullable required

Response

OK

fetched_atstring date-time required
data_age_secondsinteger required
staleboolean required
regionunknown
currencystring nullable
region_fallbackboolean nullable
attributionstring

Changes

No recorded changes to this operation across all 1 revision of this API.