# Fairly API API

**Canonical:** https://apis.io/apis/fairly-gg/fairly-api-api/  
**Provider:** Fairly — https://apis.io/providers/fairly-gg/  
**Base URL:** https://api.fairly.gg/  
**Documentation:** https://fairly.gg/developers

Fairly API API is one of 2 APIs that [Fairly](https://apis.io/providers/fairly-gg/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Real prices for PC games, including checkout fees, and the cheapest way to play. Data is licensed CC BY 4.0, attribution: "Fairly"; game cover images are not covered by that license. Versioning and deprecation policy: https://fairly.gg/developers#versioning. Some store links are affiliate links; Fai

## Operations (45)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/games` | Search games by title |
| GET | `/v1/games/index` | Indexable games for the sitemap |
| GET | `/v1/games/{id}` | Game with offers, subscriptions, cheapest way to play and historical lows |
| GET | `/v1/games/{id}/history` | Authorized-store price history, daily minimum list price (before store fees) |
| GET | `/v1/discover/under/{amount}` | Games under $3, $5 or $10 (rounded to a round number in the requested currency) |
| GET | `/v1/discover/tiers` | Under tiers ($3, $5, $10) as applied in the requested currency |
| GET | `/v1/discover/historical-lows` | Games at their historical low |
| GET | `/v1/discover/leaving/{service}` | Subscription games leaving within 30 days (game-pass, ps-plus) |
| GET | `/v1/discover/play-with/{service}` | Games you can play with a subscription (game-pass, ps-plus) |
| GET | `/v1/discover/deal-of-the-day` | Deal of the day for the region |
| GET | `/v1/discover/popular` | Most popular games with a usable offer |
| GET | `/v1/discover/this-week` | This week's picks |
| GET | `/v1/subscriptions` | Subscription summaries by region |
| GET | `/v1/subscriptions/{code}/catalog` | Subscription catalog by region |
| GET | `/v1/stores` | Stores with type, fee rules and verification dates |
| GET | `/v1/meta/status` | Source health: last successful fetch, age, consecutive failures and whether it is overdue (no key needed) |
| POST | `/v1/keys` | Create a developer API key |
| POST | `/v1/alerts` | Create a price alert (double opt-in) |
| GET | `/v1/alerts/confirm` | Confirm a price alert |
| POST | `/v1/newsletter` | Subscribe to the weekly email (double opt-in) |
| GET | `/v1/newsletter/confirm` | Confirm the weekly email subscription |
| GET | `/v1/unsubscribe/{token}` | Unsubscribe from an alert or the weekly email |
| POST | `/v1/unsubscribe/{token}` | Unsubscribe from an alert or the weekly email |
| POST | `/v1/reports` | Report a wrong price, a wrong match or a dead link |
| POST | `/v1/plan` | Subscription rotation plan: the smartest way to play a list of games |
| GET | `/v1/admin/queue` | Unresolved match queue with the raw record summary and the top 3 suggested games |
| POST | `/v1/admin/queue/{id}/resolve` | Resolve a queue row: approve the suggestion, reject the record or link it to a game |
| POST | `/v1/admin/queue/resolve-bulk` | Approve several queue rows for the same suggested game in one transaction (all or nothing) |
| GET | `/v1/admin/subscriptions/{code}/entries` | Subscription catalog entries with leaving dates |
| PUT | `/v1/admin/subscriptions/{code}/entries/{productId}` | Set the leaving date of an entry (from Xbox Wire); null clears it |
| GET | `/v1/admin/subscriptions/prices` | Every stored subscription monthly price with its source and the date it was checked |
| PUT | `/v1/admin/subscriptions/{code}/price` | Set the monthly price of a subscription in a region (no price source exists) |
| GET | `/v1/admin/keys` | API keys with 7-day usage (Redis and api_usage combined) and the 100+ requests flag |
| POST | `/v1/admin/keys/{id}/revoke` | Revoke an API key |
| GET | `/v1/admin/sources` | Source health: source_status plus the last fetched_at of each raw table; older than 24 hours is red |
| GET | `/v1/admin/games/{key}/offers` | Every offer of a game across sources and regions, plus its itad_id and ITAD historical-low seeds |
| GET | `/v1/admin/fee-rules` | Checkout fee rules per store, region and payment method |
| PUT | `/v1/admin/fee-rules/{id}` | Correct a fee rule (sets verified_at to now and status to verified) |
| GET | `/v1/admin/reports` | Wrong price / wrong match / dead link reports with weekly counts |
| POST | `/v1/admin/reports/{id}/resolve` | Mark a report as resolved |
| GET | `/v1/admin/kpi` | Experiment dashboard: weekly kpi_snapshot rows (newest first), the live current week and the targets |
| GET | `/v1/admin/api-metrics` | API and MCP usage: requests per key or anonymous, per endpoint or tool, error rate and latency percentiles |
| GET | `/v1/admin/experiment-report` | Weekly experiment report: KPIs, thresholds, funnel counts, clicks by channel, API usage, channel members, commission |
| POST | `/v1/admin/affiliate-sales/import` | Import an affiliate network sales report (CSV body, Content-Type: text/csv; up to 5 MB) |
| GET | `/v1/admin/affiliate-sales/summary` | Clicks to sales to commission, grouped by store, channel (src) and page |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/fairly-gg/openapi/_original/fairly-gg-api-openapi.json
- **JSONSchema** — https://artifacts.apis.io/fairly-gg/json-schema/fairly-gg-api-response-of-iread-only-list-of-subscription-summary-model-schema.json
- **JSONSchema** — https://artifacts.apis.io/fairly-gg/json-schema/fairly-gg-api-response-of-iread-only-list-of-discover-tier-model-schema.json
- **JSONSchema** — https://artifacts.apis.io/fairly-gg/json-schema/fairly-gg-api-response-of-iread-only-list-of-history-point-schema.json
- **JSONSchema** — https://artifacts.apis.io/fairly-gg/json-schema/fairly-gg-api-response-of-iread-only-list-of-source-status-schema.json
- **JSONSchema** — https://artifacts.apis.io/fairly-gg/json-schema/fairly-gg-api-response-of-iread-only-list-of-game-summary-schema.json
- **JSONSchema** — https://artifacts.apis.io/fairly-gg/json-schema/fairly-gg-api-response-of-discover-page-model-schema.json

## Other Fairly APIs (1)

- [Fairly API](https://apis.io/apis/fairly-gg/fairly-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/fairly-gg/fairly-api-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/fairly-gg/.