{"openapi":"3.1.0","info":{"title":"Epic Games Store Free Games API","version":"1.0.0","description":"Live free-games promotions from the Epic Games Store. The games that are free to claim right now (with the window they are free) and the ones becoming free soon — each with title, description, publisher, original price, store slug, cover image and store URL. The iconic \"Epic free game this week\" as a clean API for gaming, deal-alert, calendar and dashboard apps. Distinct from cross-store deal aggregators — Epic's own giveaways.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/epicgames-api","description":"oanor gateway"}],"tags":[{"name":"Free Games"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/free":{"get":{"operationId":"get_v1_free","tags":["Free Games"],"summary":"Games currently free on the Epic Games Store","description":"","parameters":[{"name":"country","in":"query","required":false,"description":"2-letter ISO country code (default US)","schema":{"type":"string"},"example":"US"},{"name":"locale","in":"query","required":false,"description":"Locale (default en-US)","schema":{"type":"string"},"example":"en-US"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Games currently free to claim on the Epic Games Store (claim before free_end).","count":2,"games":[{"url":"https://store.epicgames.com/en-US/p/the-ouroboros-king","slug":"the-ouroboros-king","image":"https://cdn1.epicgames.com/spt-assets/33630d7105014582a478094e89953f49/the-ouroboros-king-jwabx.jpg","title":"The Ouroboros King","free_end":"2026-06-18T15:00:00.000Z","publisher":"Plug In Digital SAS","free_start":"2026-06-11T15:00:00.000Z","description":"The Ouroboros King combines the strategic depth of chess with the build variety and replayability of roguelikes. Assemble a formidable army, discover powerful relics, and buy surprising gadgets to defeat the Coven.","original_price":"$9.99"},{"url":"https://store.epicgames.com/en-US/p/b28e038bd68b4e80840e7fb8b747de54","slug":"b28e038bd68b4e80840e7fb8b747de54","image":"https://cdn1.epicgames.com/spt-assets/a1af14251fb748fc9bda63bfc260f933/warhammer-40k-speed-freeks-1k4pq.jpg","title":"Warhammer 40K Speed Freeks","free_end":"2026-06-18T15:00:00.000Z","publisher":"Wired Productions","free_start":"2026-06-11T15:00:00.000Z","description":"High-octane combat racing in the Warhammer 40,000 universe.","original_price":"$19.99"}],"source":"Epic Games Store","country":"US"},"meta":{"timestamp":"2026-06-14T08:04:40.162Z","request_id":"871a7567-b30b-4413-b18e-d6747bea6055"},"status":"ok","message":"Free games retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/upcoming":{"get":{"operationId":"get_v1_upcoming","tags":["Free Games"],"summary":"Games becoming free on the Epic Games Store soon","description":"","parameters":[{"name":"country","in":"query","required":false,"description":"2-letter ISO country code (default US)","schema":{"type":"string"},"example":"US"},{"name":"locale","in":"query","required":false,"description":"Locale (default en-US)","schema":{"type":"string"},"example":"en-US"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Games becoming free on the Epic Games Store soon (free between free_start and free_end).","count":2,"games":[{"url":"https://store.epicgames.com/en-US/p/da528841e0eb43d8b93fd243c6767b0c","slug":"da528841e0eb43d8b93fd243c6767b0c","image":"https://cdn1.epicgames.com/spt-assets/919d5976f3804d4cabb8ca90ea43a956/citizen-sleeper-xudwg.jpg","title":"Citizen Sleeper","free_end":"2026-06-25T15:00:00.000Z","publisher":"Surprise Attack Pty Ltd DBA Fellow Traveller Games","free_start":"2026-06-18T15:00:00.000Z","description":"Roleplaying in the ruins of interplanetary capitalism. Live the life of an escaped worker, washed-up on a lawless station at the edge of an interstellar society. Inspired by the flexibility and freedom of TTRPGs, choose your friends, escape your past and change your future.","original_price":"$19.99"},{"url":"https://store.epicgames.com/en-US/p/4ee365fd76704f37ae3dc13676f1ac61","slug":"4ee365fd76704f37ae3dc13676f1ac61","image":"https://cdn1.epicgames.com/spt-assets/91105717b53044ed8e384e5fada71db8/robobeat-1ojda.png","title":"ROBOBEAT","free_end":"2026-06-25T15:00:00.000Z","publisher":"Kwalee","free_start":"2026-06-18T15:00:00.000Z","description":"Keep your trigger finger on the pulse! In rhythm shooter ROBOBEAT, you'll play as Ace - a bounty hunter on a mission to capture robot-gone-rogue Frazzer. Wall run, slide, and shoot to your own beat using the in-game custom music editor, blasting through Frazzer's armies!","original_price":"$19.99"}],"source":"Epic Games Store","country":"US"},"meta":{"timestamp":"2026-06-14T08:04:40.258Z","request_id":"05908f64-34c4-474a-8c36-485ae4e0bd3d"},"status":"ok","message":"Upcoming free games retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"free = games free to claim now; upcoming = games free soon. Optional country (2-letter ISO, default US) and locale (default en-US) localise the offer window and prices.","sample":{"first":"The Ouroboros King","free_now":2},"source":"Epic Games Store free-games promotions (live)","service":"epicgames-api","endpoints":{"GET /v1/free":"Games currently free on the Epic Games Store (country, locale).","GET /v1/meta":"This document.","GET /v1/upcoming":"Games becoming free on the Epic Games Store soon (country, locale)."},"description":"Live free-games promotions from the Epic Games Store, keyless. The games that are free to claim right now (with the window they are free) and the ones becoming free soon — each with title, description, publisher, original price, store slug, cover image and store URL. The iconic 'Epic free game this week' as a clean API for gaming, deal-alert and calendar apps. Live, no key, nothing stored. Distinct from cross-store deal aggregators — Epic's own giveaways.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-14T08:04:40.356Z","request_id":"fc9ef37b-fee4-4a0f-94ed-251d86bfa692"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":2000,"rps_limit":5,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":700,"monthly_call_quota":50000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2900,"monthly_call_quota":300000,"rps_limit":25,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":8900,"monthly_call_quota":2000000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/epicgames-api"}