Search finished events by team name across all leagues, optionally by sport, over up to 31 days. Returns up to 100 events, newest first, since Dec 2025.
GET
/
historical
/
events
/
search
Search Historical Events
curl --request GET \ --url https://api.odds-api.io/v3/historical/events/search
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"Odds-API.io","colors":{"primary":"#c084fc","light":"#c084fc","dark":"#c084fc"},"logo":{"light":"https://mintcdn.com/odds-apiio/7mRBZE8RsajjfMCh/logo/light.svg?fit=max\u0026auto=format\u0026n=7mRBZE8RsajjfMCh\u0026q=85\u0026s=b56a8844d577deb54caa1d89f94deee3","dark":"https://mintcdn.com/odds-apiio/7mRBZE8RsajjfMCh/logo/dark.svg?fit=max\u0026auto=format\u0026n=7mRBZE8RsajjfMCh\u0026q=85\u0026s=1becddd2b3b805be3a0270d051b0961f"},"favicon":"https://mintcdn.com/odds-apiio/7mRBZE8RsajjfMCh/favicon.ico?fit=max\u0026auto=format\u0026n=7mRBZE8RsajjfMCh\u0026q=85\u0026s=e2550b235a2590fba77b87f0ce5ca1bc","navbar":{"links":[{"href":"mailto:hello@odds-api.io","label":"Support"},{"href":"https://status.odds-api.io","label":"Status"}],"primary":{"type":"button","label":"Get API Key","href":"https://odds-api.io/pricing"}},"footer":{"socials":{"x":"https://x.com/oddsapi_io"}},"seo":{"metatags":{"canonical":"https://docs.odds-api.io","description":"Official documentation for Odds-API.io - Real-time sports betting odds API with coverage of 450+ bookmakers and 34 sports worldwide.","keywords":"odds api, sports betting api, betting odds, real-time odds, bookmaker odds, sports data api, arbitrage betting, value bets","og:site_name":"Odds-API.io Documentation","og:type":"website","og:image":"https://docs.odds-api.io/images/og-image-v2.png","twitter:card":"summary_large_image","twitter:site":"@oddsapi_io"},"indexing":"all"},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"API Dashboard","icon":"chart-line","href":"https://odds-api.io"},{"anchor":"Get API Key","icon":"key","href":"https://odds-api.io/pricing"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"odds-apiio","hasAudioNarration":false,"actualSubdomain":"odds-apiio","customDomains":["docs.odds-api.io"],"gitSource":{"type":"github","owner":"outlier-as","repo":"oddsapi","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae8607f26d449f6e4d7ce37","collectionId":"5a0880a2-9a07-41f3-8f49-e8c9fc5d20b1","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae8607f26d449f6e4d7ce37"},"entitlements":{},"buildId":"6ae8607f26d449f6e4d7ce37","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"API Reference","count":62},{"language":"default","tag":"Documentation","count":22},{"language":"default","tag":"Guides","count":15},{"language":"default","tag":"Odds","count":6},{"language":"default","tag":"Getting Started","count":5},{"language":"default","tag":"Bookmakers","count":4},{"language":"default","tag":"Events","count":4},{"language":"default","tag":"Historical","count":4},{"language":"default","tag":"Examples","count":3},{"language":"default","tag":"Participants","count":3}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/historical/search-historical-events","slug":"/api-reference/historical/search-historical-events","pageMetadata":{"title":"Search Historical Events","description":"Search finished events by team name across all leagues, optionally by sport, over up to 31 days. Returns up to 100 events, newest first, since Dec 2025.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /historical/events/search","href":"/api-reference/historical/search-historical-events","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Search finished events by team name across all leagues, optionally by sport, over up to 31 days. Returns up to 100 events, newest first, since Dec 2025.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Search Historical Events","description":"Search finished events by team name across all leagues, optionally by sport, over up to 31 days. Returns up to 100 events, newest first, since Dec 2025.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /historical/events/search","href":"/api-reference/historical/search-historical-events","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"security":["83c40093-70ad-4f17-bef9-6892d174500a"],"description":"Search finished events by team name across all leagues, optionally by sport, over up to 31 days. Returns up to 100 events, newest first, since Dec 2025.","tags":["Historical"],"summary":"Search Historical Events","parameters":["58f0486d-0de1-40b7-939b-f7f567dfec3c","539a546a-612c-494b-9283-366e6566bbdf","a1bd736c-3021-4a20-ba12-093e27e738f9","e9fe96d0-bbe0-4c6b-b857-e49fe004d597","81d52c53-a86d-4df2-975d-5066efd8847b"],"responses":{"200":"59166fd0-269e-4eed-b916-93b6788339e1","400":"112d73de-ff1b-4d1e-b4d6-68c72e4d5057","401":"b44473fd-94d4-493d-ab7f-bee2e53673b5","500":"765b12db-572b-4543-ba38-b4b353f836d5"},"x-mint":{"metadata":{"description":"Search finished events by team name across all leagues, optionally by sport, over up to 31 days. Returns up to 100 events, newest first, since Dec 2025."}},"method":"get","type":"path","servers":["1b67ada8-af7a-4bab-9997-114d82f00d3f"],"path":"/historical/events/search","baseUrlOptions":["https://api.odds-api.io/v3"],"title":"Search Historical Events","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"58f0486d-0de1-40b7-939b-f7f567dfec3c":{"description":"API key for authentication","name":"apiKey","in":"query","required":true,"schema":{"type":"string","isRequired":true,"description":"API key for authentication","uniqueKey":"","typeLabel":"string"}},"539a546a-612c-494b-9283-366e6566bbdf":{"example":"\"Brann\"","description":"Team name fragment, minimum 3 characters","name":"query","in":"query","required":true,"schema":{"type":"string","isRequired":true,"description":"Team name fragment, minimum 3 characters","uniqueKey":"","typeLabel":"string"}},"a1bd736c-3021-4a20-ba12-093e27e738f9":{"example":"\"football\"","description":"Sport name or slug (e.g. Football or football)","name":"sport","in":"query","required":false,"schema":{"type":"string","isRequired":false,"description":"Sport name or slug (e.g. Football or football)","uniqueKey":"","typeLabel":"string"}},"e9fe96d0-bbe0-4c6b-b857-e49fe004d597":{"example":"\"2026-01-01T00:00:00Z\"","description":"Start date in RFC3339 format","name":"from","in":"query","required":false,"schema":{"type":"string","isRequired":false,"description":"Start date in RFC3339 format","uniqueKey":"","typeLabel":"string"}},"81d52c53-a86d-4df2-975d-5066efd8847b":{"example":"\"2026-01-31T23:59:59Z\"","description":"End date in RFC3339 format","name":"to","in":"query","required":false,"schema":{"type":"string","isRequired":false,"description":"End date in RFC3339 format","uniqueKey":"","typeLabel":"string"}}},"responses":{"59166fd0-269e-4eed-b916-93b6788339e1":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"away":{"type":"string","uniqueKey":"items.[INDEX].away","typeLabel":"string"},"awayId":{"type":"integer","uniqueKey":"items.[INDEX].awayId","typeLabel":"integer"},"bookmakerCount":{"type":"integer","uniqueKey":"items.[INDEX].bookmakerCount","typeLabel":"integer"},"date":{"type":"string","uniqueKey":"items.[INDEX].date","typeLabel":"string"},"home":{"type":"string","uniqueKey":"items.[INDEX].home","typeLabel":"string"},"homeId":{"type":"integer","uniqueKey":"items.[INDEX].homeId","typeLabel":"integer"},"id":{"type":"integer","uniqueKey":"items.[INDEX].id","typeLabel":"integer"},"league":{"type":"object","properties":{"name":{"type":"string","uniqueKey":"items.[INDEX].league.name","typeLabel":"string"},"slug":{"type":"string","uniqueKey":"items.[INDEX].league.slug","typeLabel":"string"}},"uniqueKey":"items.[INDEX].league","typeLabel":"object"},"scores":{"type":"object","properties":{"away":{"type":"integer","uniqueKey":"items.[INDEX].scores.away","typeLabel":"integer"},"home":{"description":"Headline result: includes overtime, never a penalty shootout.","type":"integer","uniqueKey":"items.[INDEX].scores.home","typeLabel":"integer"},"periods":{"description":"Keyed p1..pN (that period only), ft, ot and ap (running totals after regulation, overtime and a penalty shootout), currentgame, mapN, inningN. See https://docs.odds-api.io/guides/live-events#period-scores","type":"object","additionalProperties":{"type":"object","properties":{"away":{"type":"integer","uniqueKey":"items.[INDEX].scores.periods.additionalProperties.away","typeLabel":"integer"},"home":{"type":"integer","uniqueKey":"items.[INDEX].scores.periods.additionalProperties.home","typeLabel":"integer"},"overs":{"type":"object","description":"Cricket only. Overs bowled by each side in this innings.","properties":{"away":{"type":"number","example":20,"uniqueKey":"items.[INDEX].scores.periods.additionalProperties.overs.away","typeLabel":"number"},"home":{"type":"number","example":20,"uniqueKey":"items.[INDEX].scores.periods.additionalProperties.overs.home","typeLabel":"number"}},"uniqueKey":"items.[INDEX].scores.periods.additionalProperties.overs","typeLabel":"object"},"wickets":{"type":"object","description":"Cricket only. Wickets lost by each side in this innings.","properties":{"away":{"type":"integer","example":9,"uniqueKey":"items.[INDEX].scores.periods.additionalProperties.wickets.away","typeLabel":"integer"},"home":{"type":"integer","example":6,"uniqueKey":"items.[INDEX].scores.periods.additionalProperties.wickets.home","typeLabel":"integer"}},"uniqueKey":"items.[INDEX].scores.periods.additionalProperties.wickets","typeLabel":"object"}},"uniqueKey":"items.[INDEX].scores.periods.additionalProperties","typeLabel":"object"},"uniqueKey":"items.[INDEX].scores.periods","typeLabel":"object"}},"uniqueKey":"items.[INDEX].scores","typeLabel":"object"},"sport":{"type":"object","properties":{"name":{"type":"string","uniqueKey":"items.[INDEX].sport.name","typeLabel":"string"},"slug":{"type":"string","uniqueKey":"items.[INDEX].sport.slug","typeLabel":"string"}},"uniqueKey":"items.[INDEX].sport","typeLabel":"object"},"status":{"type":"string","uniqueKey":"items.[INDEX].status","typeLabel":"string"},"clock":{"type":"object","description":"Live match clock (live events only; absent when no clock data is available)","properties":{"minute":{"type":"integer","example":67,"description":"Current match minute","uniqueKey":"items.[INDEX].clock.minute","typeLabel":"integer"},"playedSeconds":{"type":"integer","example":4023,"description":"Seconds of play elapsed","uniqueKey":"items.[INDEX].clock.playedSeconds","typeLabel":"integer"},"period":{"type":"integer","example":2,"description":"Current period number","uniqueKey":"items.[INDEX].clock.period","typeLabel":"integer"},"running":{"type":"boolean","example":true,"description":"Whether the clock is currently running","uniqueKey":"items.[INDEX].clock.running","typeLabel":"boolean"},"statusDetail":{"type":"string","example":"2nd half","description":"Human-readable phase of play","uniqueKey":"items.[INDEX].clock.statusDetail","typeLabel":"string"},"serve":{"type":"string","enum":["home","away"],"description":"Current server (tennis, table tennis, volleyball)","uniqueKey":"items.[INDEX].clock.serve","typeLabel":"enum\u003cstring>"},"injuryTime":{"type":"integer","example":4,"description":"Announced injury/stoppage time in minutes (football)","uniqueKey":"items.[INDEX].clock.injuryTime","typeLabel":"integer"},"periodStartedAt":{"type":"integer","example":1792170000,"description":"Unix timestamp (seconds) when the current period started. Sent only when the feed has no played clock (for example ice hockey games with basic coverage), never alongside playedSeconds. Wall time, not game time: a stopped clock makes the elapsed wall time longer than the time played, so never treat it as playedSeconds. Omitted when the value is missing, in the future, or more than 3 hours old. Also present in WebSocket clock snapshots.","uniqueKey":"items.[INDEX].clock.periodStartedAt","typeLabel":"integer"}},"uniqueKey":"items.[INDEX].clock","typeLabel":"object"},"esports":{"type":"object","description":"Esports events only: game, parent league, region and match format","properties":{"game":{"type":"object","description":"The game being played, e.g. {\"name\": \"Valorant\", \"slug\": \"valorant\"}","properties":{"name":{"type":"string","uniqueKey":"items.[INDEX].esports.game.name","typeLabel":"string"},"slug":{"type":"string","uniqueKey":"items.[INDEX].esports.game.slug","typeLabel":"string"}},"uniqueKey":"items.[INDEX].esports.game","typeLabel":"object"},"league":{"type":"object","description":"Parent league (VCT, LCK, LEC). Its slug stays the same across the league's splits and stages.","properties":{"name":{"type":"string","uniqueKey":"items.[INDEX].esports.league.name","typeLabel":"string"},"slug":{"type":"string","uniqueKey":"items.[INDEX].esports.league.slug","typeLabel":"string"}},"uniqueKey":"items.[INDEX].esports.league","typeLabel":"object"},"region":{"description":"Region of the tournament: Western Europe, Eastern Europe, North America, South America, Asia, Oceania or Middle East. Omitted when unknown.","type":"string","example":"Western Europe","uniqueKey":"items.[INDEX].esports.region","typeLabel":"string"},"format":{"type":"object","description":"Match format. Omitted when unknown.","properties":{"type":{"description":"bestOf or firstTo","type":"string","example":"bestOf","uniqueKey":"items.[INDEX].esports.format.type","typeLabel":"string"},"games":{"description":"Number of games: 3 for a best of 3","type":"integer","example":3,"uniqueKey":"items.[INDEX].esports.format.games","typeLabel":"integer"}},"uniqueKey":"items.[INDEX].esports.format","typeLabel":"object"}},"uniqueKey":"items.[INDEX].esports","typeLabel":"object"}},"uniqueKey":"items.[INDEX]","typeLabel":"object"},"uniqueKey":"","typeLabel":"object[]"},"examples":{"Example":{"title":"Example","value":[{"away":"\u003cstring>","awayId":123,"bookmakerCount":123,"date":"\u003cstring>","home":"\u003cstring>","homeId":123,"id":123,"league":{"name":"\u003cstring>","slug":"\u003cstring>"},"scores":{"away":123,"home":123,"periods":{}},"sport":{"name":"\u003cstring>","slug":"\u003cstring>"},"status":"\u003cstring>","clock":{"minute":67,"playedSeconds":4023,"period":2,"running":true,"statusDetail":"2nd half","serve":"home","injuryTime":4,"periodStartedAt":1792170000},"esports":{"game":{"name":"\u003cstring>","slug":"\u003cstring>"},"league":{"name":"\u003cstring>","slug":"\u003cstring>"},"region":"Western Europe","format":{"type":"bestOf","games":3}}}]}},"exampleType":"generated"}},"exampleType":"generated"},"112d73de-ff1b-4d1e-b4d6-68c72e4d5057":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"Error message","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Error message"}}},"exampleType":"generated"}},"exampleType":"generated"},"b44473fd-94d4-493d-ab7f-bee2e53673b5":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"Error message","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Error message"}}},"exampleType":"generated"}},"exampleType":"generated"},"765b12db-572b-4543-ba38-b4b353f836d5":{"description":"Internal Server Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"Error message","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Error message"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"83c40093-70ad-4f17-bef9-6892d174500a":{"ApiKeyAuth":{"$ref":"669bc79e-b0ea-4849-8c13-193542ba39f0","scopes":[]}}},"servers":{"1b67ada8-af7a-4bab-9997-114d82f00d3f":{"url":"https://api.odds-api.io/v3"}}},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"odds-apiio","siteName":"Odds-API.io","title":"Search Historical Events - Odds-API.io","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-29T12:13:51.674Z","originalFileLocation":"api-reference/historical/search-historical-events.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Search finished events by team name across all leagues, optionally by sport, over up to 31 days. Returns up to 100 events, newest first, since Dec 2025.\">\u003cmeta data-mint-head name=\"keywords\" content=\"odds api, sports betting api, betting odds, real-time odds, bookmaker odds, sports data api, arbitrage betting, value bets\">\u003cmeta data-mint-head name=\"application-name\" content=\"Odds-API.io\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/odds-apiio/8ofph8VBmT-MI39h/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/odds-apiio/8ofph8VBmT-MI39h/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/odds-apiio/8ofph8VBmT-MI39h/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/odds-apiio/8ofph8VBmT-MI39h/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/odds-apiio/8ofph8VBmT-MI39h/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/odds-apiio/8ofph8VBmT-MI39h/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/odds-apiio/8ofph8VBmT-MI39h/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/odds-apiio/8ofph8VBmT-MI39h/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/odds-apiio/8ofph8VBmT-MI39h/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Search Historical Events - Odds-API.io\">\u003cmeta data-mint-head property=\"og:description\" content=\"Search finished events by team name across all leagues, optionally by sport, over up to 31 days. Returns up to 100 events, newest first, since Dec 2025.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Odds-API.io Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.odds-api.io/api-reference/historical/search-historical-events\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://docs.odds-api.io/images/og-image-v2.png\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Search Historical Events - Odds-API.io\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Search finished events by team name across all leagues, optionally by sport, over up to 31 days. Returns up to 100 events, newest first, since Dec 2025.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://docs.odds-api.io/images/og-image-v2.png\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/odds-apiio/8ofph8VBmT-MI39h/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Odds-API.io\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#c084fc\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.odds-api.io/api-reference/historical/search-historical-events\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/historical/search-historical-events.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.odds-api.io/#organization\",\"name\":\"Odds-API.io\",\"url\":\"https://docs.odds-api.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/odds-apiio/7mRBZE8RsajjfMCh/logo/light.svg?fit=max\u0026auto=format\u0026n=7mRBZE8RsajjfMCh\u0026q=85\u0026s=b56a8844d577deb54caa1d89f94deee3\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.odds-api.io#website\",\"name\":\"Odds-API.io\",\"url\":\"https://docs.odds-api.io\",\"publisher\":{\"@id\":\"https://docs.odds-api.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.odds-api.io/api-reference/historical/search-historical-events#webpage\",\"url\":\"https://docs.odds-api.io/api-reference/historical/search-historical-events\",\"name\":\"Search Historical Events\",\"description\":\"Search finished events by team name across all leagues, optionally by sport, over up to 31 days. Returns up to 100 events, newest first, since Dec 2025.\",\"dateModified\":\"2026-10-29T12:13:51.674Z\",\"isPartOf\":{\"@id\":\"https://docs.odds-api.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.odds-api.io/api-reference/historical/search-historical-events#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.odds-api.io/api-reference/historical/search-historical-events#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.odds-api.io/api-reference/arbitrage-bets/get-arbitrage-betting-opportunities\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Historical\",\"item\":\"https://docs.odds-api.io/api-reference/historical/get-historical-events\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Search Historical Events\",\"item\":\"https://docs.odds-api.io/api-reference/historical/search-historical-events\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.odds-api.io/api-reference/historical/search-historical-events#apireference\",\"headline\":\"Search Historical Events\",\"name\":\"Search Historical Events\",\"description\":\"Search finished events by team name across all leagues, optionally by sport, over up to 31 days. Returns up to 100 events, newest first, since Dec 2025.\",\"url\":\"https://docs.odds-api.io/api-reference/historical/search-historical-events\",\"mainEntityOfPage\":{\"@id\":\"https://docs.odds-api.io/api-reference/historical/search-historical-events#webpage\"},\"image\":\"https://docs.odds-api.io/images/og-image-v2.png\",\"dateModified\":\"2026-10-29T12:13:51.674Z\",\"publisher\":{\"@id\":\"https://docs.odds-api.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.odds-api.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Odds-API.io\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Odds-API.io","nav":{"global":{"anchors":[{"anchor":"API Dashboard","icon":"chart-line","href":"https://odds-api.io"},{"anchor":"Get API Key","icon":"key","href":"https://odds-api.io/pricing"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"API Reference","groups":[{"group":"Getting Started","pages":[{"title":"Odds API Reference: Endpoints and Auth","sidebarTitle":"API Introduction","href":"/api-reference/introduction"}]},{"group":"API Reference","pages":[{"group":"Arbitrage Bets","pages":[{"title":"Get arbitrage betting opportunities","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /arbitrage-bets","href":"/api-reference/arbitrage-bets/get-arbitrage-betting-opportunities"}]},{"group":"Bookmakers","pages":[{"title":"Get Bookmakers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /bookmakers","href":"/api-reference/bookmakers/get-bookmakers"},{"title":"Get Selected Bookmakers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /bookmakers/selected","href":"/api-reference/bookmakers/get-selected-bookmakers"},{"title":"Clear Selected Bookmakers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /bookmakers/selected/clear","href":"/api-reference/bookmakers/clear-selected-bookmakers"},{"title":"Select Bookmakers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /bookmakers/selected/select","href":"/api-reference/bookmakers/select-bookmakers"}]},{"group":"Events","pages":[{"title":"Get Events","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /events","href":"/api-reference/events/get-events"},{"title":"Get Live Events","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /events/live","href":"/api-reference/events/get-live-events"},{"title":"Search Events","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /events/search","href":"/api-reference/events/search-events"},{"title":"Get Event by ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /events/{id}","href":"/api-reference/events/get-event-by-id"}]},{"group":"Historical","pages":[{"title":"Get Historical Events","description":"Get finished events for a sport and league in a date range of up to 31 days, to feed historical odds requests. Data is available from December 2025.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /historical/events","href":"/api-reference/historical/get-historical-events"},{"title":"Search Historical Events","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /historical/events/search","href":"/api-reference/historical/search-historical-events"},{"title":"Get Historical Odds","description":"Get closing odds for a finished event from the bookmakers you choose, with final scores included. Filter by market to pull closing lines for backtesting.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /historical/odds","href":"/api-reference/historical/get-historical-odds"},{"title":"Get Historical Closing Lines","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /historical/closing-lines","href":"/api-reference/historical/get-historical-closing-lines"}]},{"group":"Leagues","pages":[{"title":"Get Leagues","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /leagues","href":"/api-reference/leagues/get-leagues"}]},{"group":"Odds","pages":[{"title":"Get Event Odds","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /odds","href":"/api-reference/odds/get-event-odds"},{"title":"Get Odds Movements","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /odds/movements","href":"/api-reference/odds/get-odds-movements"},{"title":"Get Odds for Multiple Events","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /odds/multi","href":"/api-reference/odds/get-odds-for-multiple-events"},{"title":"Get updated event odds since a given timestamp","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /odds/updated","href":"/api-reference/odds/get-updated-event-odds-since-a-given-timestamp"},{"title":"Get Odds Summary","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /odds/summary","href":"/api-reference/odds/get-odds-summary"},{"title":"Get Odds Summary for Multiple Events","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /odds/summary/multi","href":"/api-reference/odds/get-odds-summary-for-multiple-events"}]},{"group":"Participants","pages":[{"title":"Get Participants","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /participants","href":"/api-reference/participants/get-participants"},{"title":"Get Participant by ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /participants/{id}","href":"/api-reference/participants/get-participant-by-id"},{"title":"Get Participant Logo","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /participants/{id}/logo","href":"/api-reference/participants/get-participant-logo"}]},{"group":"Sports","pages":[{"title":"Get Sports","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /sports","href":"/api-reference/sports/get-sports"}]},{"group":"Dropping Odds","pages":[{"title":"Get Dropping Odds","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /dropping-odds","href":"/api-reference/dropping-odds/get-dropping-odds"}]},{"group":"Value Bets","pages":[{"title":"Get Value Bets","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /value-bets","href":"/api-reference/value-bets/get-value-bets"}]},{"group":"Mappings","pages":[{"title":"Get Native ID Mappings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /mappings","href":"/api-reference/mappings/get-native-id-mappings"}]},{"group":"Markets","pages":[{"title":"Get Markets","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /markets","href":"/api-reference/markets/get-markets"}]},{"group":"Settlement","pages":[{"title":"Get Settlements","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /settlements","href":"/api-reference/settlement/get-settlements"},{"title":"Grade Selections","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /settlements/grade","href":"/api-reference/settlement/grade-selections"}]}]},{"group":"WebSocket","pages":[{"title":"WebSocket API","api":"WEBSOCKET wss://api.odds-api.io/v3/ws","href":"/api-reference/websocket"}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Search Historical Events - Odds-API.io","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","Page-m07pfKpT.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DqdKa2R4.js"]}