{"openapi":"3.1.0","info":{"title":"Fixtures & Scores API","version":"1.0.0","description":"Recent match results with scores, upcoming fixtures and all events on a given date — across football (soccer) and other sports. Look up by league or by date for schedules, final scores, venues and rounds.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/fixtures-api","description":"oanor gateway"}],"tags":[{"name":"Fixtures"}],"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/day":{"get":{"operationId":"get_v1_day","tags":["Fixtures"],"summary":"Events on a date","description":"","parameters":[{"name":"date","in":"query","required":true,"description":"Date YYYY-MM-DD","schema":{"type":"string"},"example":"2026-05-23"},{"name":"sport","in":"query","required":false,"description":"Sport (default Soccer)","schema":{"type":"string"},"example":"Soccer"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"date":"2026-05-23","count":3,"sport":"Soccer","events":[{"id":"2265406","date":"2026-05-23","time":"16:00:00","event":"Bologna vs Inter Milan","round":"38","sport":"Soccer","thumb":"https://r2.thesportsdb.com/images/media/event/thumb/1taz061755935175.jpg","venue":"Stadio Renato Dall'Ara","league":"Italian Serie A","season":"2025-2026","status":"FT","away_team":"Inter Milan","home_team":"Bologna","timestamp":"2026-05-23T16:00:00","away_score":3,"home_score":3},{"id":"2265409","date":"2026-05-23","time":"18:45:00","event":"Lazio vs Pisa","round":"38","sport":"Soccer","thumb":"https://r2.thesportsdb.com/images/media/event/thumb/wl2pec1755935186.jpg","venue":"Stadio Olimpico","league":"Italian Serie A","season":"2025-2026","status":"FT","away_team":"Pisa","home_team":"Lazio","timestamp":"2026-05-23T18:45:00","away_score":1,"home_score":2},{"id":"2267999","date":"2026-05-23","time":"15:30:00","event":"Cracovia vs Korona Kielce","round":"34","sport":"Soccer","thumb":"https://r2.thesportsdb.com/images/media/event/thumb/nmsg7f1750344107.jpg","venue":"Stadion Cracovii im Józefa Piłsudskiego","league":"Polish Ekstraklasa","season":"2025-2026","status":"FT","away_team":"Korona Kielce","home_team":"Cracovia","timestamp":"2026-05-23T15:30:00","away_score":1,"home_score":1}]},"meta":{"timestamp":"2026-05-30T01:26:03.665Z","request_id":"106db100-23ab-49b4-a24b-aef286dd6668"},"status":"ok","message":"Events 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/results":{"get":{"operationId":"get_v1_results","tags":["Fixtures"],"summary":"Recent results (with scores)","description":"","parameters":[{"name":"league","in":"query","required":true,"description":"TheSportsDB league id","schema":{"type":"string"},"example":"4328"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":1,"events":[{"id":"2267452","date":"2026-05-24","time":"15:00:00","event":"West Ham United vs Leeds United","round":"38","sport":"Soccer","thumb":"https://r2.thesportsdb.com/images/media/event/thumb/iejgyx1750321086.jpg","venue":"London Stadium","league":"English Premier League","season":"2025-2026","status":"FT","away_team":"Leeds United","home_team":"West Ham United","timestamp":"2026-05-24T15:00:00","away_score":0,"home_score":3}],"league_id":4328},"meta":{"timestamp":"2026-05-30T01:26:04.052Z","request_id":"4d610fea-2936-45bb-9e15-ad9e4b869cac"},"status":"ok","message":"Results 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":["Fixtures"],"summary":"Upcoming fixtures","description":"","parameters":[{"name":"league","in":"query","required":true,"description":"TheSportsDB league id","schema":{"type":"string"},"example":"4328"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":0,"events":[],"league_id":4328},"meta":{"timestamp":"2026-05-30T01:26:04.372Z","request_id":"b8847e68-2277-4ba8-b71a-d0be265233fa"},"status":"ok","message":"Fixtures 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"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":2500,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":1100,"monthly_call_quota":45000,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3400,"monthly_call_quota":220000,"rps_limit":18,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":8900,"monthly_call_quota":900000,"rps_limit":45,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/fixtures-api"}