{"openapi":"3.1.0","info":{"title":"Sportradar NASCAR (BYOK) API","version":"0.1.0","description":"Sportradar NASCAR (BYOK) lets an AI assistant read your own Sportradar NASCAR data through the Sportradar NASCAR API with a key you supply (Sportradar NASCAR API key (trial or production)). Read-only: 10 tools (get_season_schedule, list_drivers, get_driver_standings, get_owner_standings, get_manufacturer_standings, get_rookie_standings, get_race_results, get_starting_grid, get_qualifying,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-sportradar-nascar.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-sportradar-nascar/docs"},"termsOfService":"https://connectorbay.com/byok-sportradar-nascar/terms"},"servers":[{"url":"https://byok-sportradar-nascar.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-sportradar-nascar/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/get_season_schedule":{"post":{"operationId":"get_season_schedule","summary":"List the NASCAR events of a series and season with track, start date and the races (practice, qualifying, heats and main","description":"List the NASCAR events of a series and season with track, start date and the races (practice, qualifying, heats and main race) of each event. Use for \"What is the 2025 NASCAR Cup Series schedule\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"access_level":{"description":"Access level of your Sportradar key: ot or o.","enum":["ot","o"],"title":"Access Level","type":"string"},"nascar_series":{"description":"NASCAR series code: mc (Cup), or (O'Reilly Auto Parts) or cw (Trucks).","enum":["mc","or","cw"],"title":"Nascar Series","type":"string"},"season_year":{"description":"Four-digit season year, for example 2025.","maxLength":200,"title":"Season Year","type":"string"}},"required":["access_level","nascar_series","season_year"],"title":"get_season_scheduleArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_drivers":{"post":{"operationId":"list_drivers","summary":"List the drivers of a NASCAR series and season with id, name, status and country. Use for \"Which drivers are in the 2025","description":"List the drivers of a NASCAR series and season with id, name, status and country. Use for \"Which drivers are in the 2025 NASCAR Cup Series\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"access_level":{"description":"Access level of your Sportradar key: ot or o.","enum":["ot","o"],"title":"Access Level","type":"string"},"nascar_series":{"description":"NASCAR series code: mc (Cup), or (O'Reilly Auto Parts) or cw (Trucks).","enum":["mc","or","cw"],"title":"Nascar Series","type":"string"},"season_year":{"description":"Four-digit season year, for example 2025.","maxLength":200,"title":"Season Year","type":"string"}},"required":["access_level","nascar_series","season_year"],"title":"list_driversArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_driver_standings":{"post":{"operationId":"get_driver_standings","summary":"Get the NASCAR driver points standings for a series and season with rank, points, wins, poles, stage wins, top-5 and top","description":"Get the NASCAR driver points standings for a series and season with rank, points, wins, poles, stage wins, top-5 and top-10 finishes. Use for \"Who leads the NASCAR Cup Series driver standings\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"access_level":{"description":"Access level of your Sportradar key: ot or o.","enum":["ot","o"],"title":"Access Level","type":"string"},"nascar_series":{"description":"NASCAR series code: mc (Cup), or (O'Reilly Auto Parts) or cw (Trucks).","enum":["mc","or","cw"],"title":"Nascar Series","type":"string"},"season_year":{"description":"Four-digit season year, for example 2025.","maxLength":200,"title":"Season Year","type":"string"}},"required":["access_level","nascar_series","season_year"],"title":"get_driver_standingsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_owner_standings":{"post":{"operationId":"get_owner_standings","summary":"Get the NASCAR owner points standings for a series and season by car with rank, points, wins and finishes. Use for \"Whic","description":"Get the NASCAR owner points standings for a series and season by car with rank, points, wins and finishes. Use for \"Which car leads the NASCAR owner standings\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"access_level":{"description":"Access level of your Sportradar key: ot or o.","enum":["ot","o"],"title":"Access Level","type":"string"},"nascar_series":{"description":"NASCAR series code: mc (Cup), or (O'Reilly Auto Parts) or cw (Trucks).","enum":["mc","or","cw"],"title":"Nascar Series","type":"string"},"season_year":{"description":"Four-digit season year, for example 2025.","maxLength":200,"title":"Season Year","type":"string"}},"required":["access_level","nascar_series","season_year"],"title":"get_owner_standingsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_manufacturer_standings":{"post":{"operationId":"get_manufacturer_standings","summary":"Get the NASCAR manufacturer standings for a series and season with rank, points and wins. Use for \"Which manufacturer le","description":"Get the NASCAR manufacturer standings for a series and season with rank, points and wins. Use for \"Which manufacturer leads the NASCAR Cup Series\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"access_level":{"description":"Access level of your Sportradar key: ot or o.","enum":["ot","o"],"title":"Access Level","type":"string"},"nascar_series":{"description":"NASCAR series code: mc (Cup), or (O'Reilly Auto Parts) or cw (Trucks).","enum":["mc","or","cw"],"title":"Nascar Series","type":"string"},"season_year":{"description":"Four-digit season year, for example 2025.","maxLength":200,"title":"Season Year","type":"string"}},"required":["access_level","nascar_series","season_year"],"title":"get_manufacturer_standingsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_rookie_standings":{"post":{"operationId":"get_rookie_standings","summary":"Get the NASCAR rookie-of-the-year standings for a series and season with rank, points and wins. Use for \"Who leads the N","description":"Get the NASCAR rookie-of-the-year standings for a series and season with rank, points and wins. Use for \"Who leads the NASCAR rookie standings\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"access_level":{"description":"Access level of your Sportradar key: ot or o.","enum":["ot","o"],"title":"Access Level","type":"string"},"nascar_series":{"description":"NASCAR series code: mc (Cup), or (O'Reilly Auto Parts) or cw (Trucks).","enum":["mc","or","cw"],"title":"Nascar Series","type":"string"},"season_year":{"description":"Four-digit season year, for example 2025.","maxLength":200,"title":"Season Year","type":"string"}},"required":["access_level","nascar_series","season_year"],"title":"get_rookie_standingsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_race_results":{"post":{"operationId":"get_race_results","summary":"Get the finishing order of one NASCAR race: race details, track, and each driver's start and finish position, laps led, ","description":"Get the finishing order of one NASCAR race: race details, track, and each driver's start and finish position, laps led, laps completed, points and status. Use for \"Who won this NASCAR race and how did the field finish\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"access_level":{"description":"Access level of your Sportradar key: ot or o.","enum":["ot","o"],"title":"Access Level","type":"string"},"nascar_series":{"description":"NASCAR series code: mc (Cup), or (O'Reilly Auto Parts) or cw (Trucks).","enum":["mc","or","cw"],"title":"Nascar Series","type":"string"},"race_id":{"description":"Race id (UUID) as returned by get_season_schedule (races inside each event).","maxLength":200,"title":"Race Id","type":"string"}},"required":["access_level","nascar_series","race_id"],"title":"get_race_resultsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_starting_grid":{"post":{"operationId":"get_starting_grid","summary":"Get the starting grid of one NASCAR race with each starting position, driver and car. Use for \"Who starts on the pole fo","description":"Get the starting grid of one NASCAR race with each starting position, driver and car. Use for \"Who starts on the pole for this NASCAR race\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"access_level":{"description":"Access level of your Sportradar key: ot or o.","enum":["ot","o"],"title":"Access Level","type":"string"},"nascar_series":{"description":"NASCAR series code: mc (Cup), or (O'Reilly Auto Parts) or cw (Trucks).","enum":["mc","or","cw"],"title":"Nascar Series","type":"string"},"race_id":{"description":"Race id (UUID) as returned by get_season_schedule (races inside each event).","maxLength":200,"title":"Race Id","type":"string"}},"required":["access_level","nascar_series","race_id"],"title":"get_starting_gridArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_qualifying":{"post":{"operationId":"get_qualifying","summary":"Get the qualifying results of one NASCAR race with position, speed, lap time, driver and car. Use for \"Who was fastest i","description":"Get the qualifying results of one NASCAR race with position, speed, lap time, driver and car. Use for \"Who was fastest in qualifying for this NASCAR race\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"access_level":{"description":"Access level of your Sportradar key: ot or o.","enum":["ot","o"],"title":"Access Level","type":"string"},"nascar_series":{"description":"NASCAR series code: mc (Cup), or (O'Reilly Auto Parts) or cw (Trucks).","enum":["mc","or","cw"],"title":"Nascar Series","type":"string"},"race_id":{"description":"Race id (UUID) as returned by get_season_schedule (races inside each event).","maxLength":200,"title":"Race Id","type":"string"}},"required":["access_level","nascar_series","race_id"],"title":"get_qualifyingArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_driver_profile":{"post":{"operationId":"get_driver_profile","summary":"Get one NASCAR driver's profile: name, country, rookie year and status. Use for \"What is this NASCAR driver's rookie yea","description":"Get one NASCAR driver's profile: name, country, rookie year and status. Use for \"What is this NASCAR driver's rookie year and country\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"access_level":{"description":"Access level of your Sportradar key: ot or o.","enum":["ot","o"],"title":"Access Level","type":"string"},"nascar_series":{"description":"NASCAR series code: mc (Cup), or (O'Reilly Auto Parts) or cw (Trucks).","enum":["mc","or","cw"],"title":"Nascar Series","type":"string"},"driver_id":{"description":"Driver id (UUID) as returned by get_driver_standings or list_drivers.","maxLength":200,"title":"Driver Id","type":"string"}},"required":["access_level","nascar_series","driver_id"],"title":"get_driver_profileArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}