openapi: 3.0.0
info:
  title: NASCAR v3
  description: >-
    Sportradar is the official data provider of real-time NASCAR data! We
    combine on-track speed and accuracy with in-depth race and seasonal driver
    statistics. All three NASCAR series (Cup, Xfinity, and Trucks) are covered
    in full.


    The NASCAR API is consistent in structure, format, and behavior with our
    other League Specific APIs. Our primary feeds return schedules, standings,
    team and driver data, and real-time race leaderboards.


    Our other feeds provide a host of complimentary statistics and information,
    including:

    * Entry lists

    * Practice leaderboards

    * Qualifying leaderboards

    * Seasonal driver statistics

    * Detailed track profiles


    The easiest way to get started with the API is to click the fork button to
    fork this collection to your own workspace and use Postman to send requests.


    # Overview


    1.  You need a valid API Key to send requests to the API endpoints. You can
    get your free trial key by registering an account and creating an
    application from our [Developer Portal](https://developer.sportradar.com/).

    2.  Once you have your sport specific key, replace the value `{Your API
    Key}` with your API key and click the save icon (or click the Meatballs Menu
    and select "Save")

    3.  By default, responses to every request are sent in JSON. If you prefer
    XML, you can change the variable by clicking the "Variables" tab and
    replacing the Current Value for format to xml.

    4.  Select an endpoint from the NASCAR v3 menu on the left, then click
    "Send" on the resulting screen.

    5.  The API calls will respond with appropriate [HTTP response
    codes](https://developer.sportradar.com/docs/read/Home#http-response-codes)
    for all requests. Within Postman Client, when a response is received, the
    status code is highlighted and is accompanied by a help text that indicates
    the possible meaning of the response code. A 200 OK indicates all went well,
    while 4XX or 5XX response codes indicate an error from the requesting client
    or our API servers respectively.

    6.  Data for the requested endpoint is displayed in the Body section below.


    # Other Resources


    The [API
    Map](https://developer.sportradar.com/docs/read/racing/NASCAR_v3#nascar-v3-api-map)
    on our Developer Portal illustrates how to obtain the parameters you will
    need to access the API.


    The [Statistics
    Summary](https://developer.sportradar.com/files/Sportradar_NASCAR_v3_Statistics_Summary.pdf)
    provides a high-level overview of all the data points provided within the
    whole API, giving you an “at a glance” view of the data we offer.


    The
    [Documentation](https://developer.sportradar.com/files/Sportradar_NASCAR_v3_Statistics_Feeds.pdf)
    provides a list of endpoints for the API with basic descriptions. When
    applicable, we include information on the Coverage Levels provided for the
    API. This document also includes descriptions of each data point and
    information about where each data point can be found within the API.


    [Frequently Asked
    Questions](https://developer.sportradar.com/docs/read/racing/NASCAR_v3#frequently-asked-questions)
    about the API can be found on the Developer Portal and in the Documentation
    mentioned above.


    The [Change
    Log](https://developer.sportradar.com/files/NASCAR_API_v3_Change_Log.pdf)
    provides a list of changes and updates to this version of the API since the
    initial release of the API version.


    If you need further information, contact our support team:  

    Email: [support@sportradar.com](mailto:support@sportradar.com)
  version: 1.0.0
servers:
  - url: http://{{baseurl}}
components:
  securitySchemes:
    apikeyAuth:
      type: http
      scheme: apikey
security:
  - apikeyAuth: []
paths:
  /{year}/{month}/{day}/changes.{format}:
    get:
      tags:
        - General
      summary: Daily Change Log
      description: >-
        Provides IDs and timestamps for race information, race results, driver
        information, track information, or standings that have been modified on
        a given date. To receive the data updates, use these unique IDs to pull
        relevant API feeds.
      parameters:
        - name: year
          in: path
          schema:
            type: integer
          required: true
          description: (Required) Year in 4 digit format
          example: '2021'
        - name: month
          in: path
          schema:
            type: integer
          required: true
          description: (Required) Month in 2 digit format
          example: '05'
        - name: day
          in: path
          schema:
            type: integer
          required: true
          description: (Required) Day in 2 digit format
          example: '08'
        - name: format
          in: path
          schema:
            type: string
          required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json: {}
  /{nascar_series}/{season_year}/standings/drivers.{format}:
    get:
      tags:
        - General
      summary: Driver Standings
      description: Provides detailed standings info for drivers.
      parameters:
        - name: nascar_series
          in: path
          schema:
            type: string
          required: true
          description: (Required) Cup (sc or mc), Xfinity (xf), or Trucks (cw or go)
          example: mc
        - name: season_year
          in: path
          schema:
            type: integer
          required: true
          description: (Required) Year in 4 digit format
          example: '2021'
        - name: format
          in: path
          schema:
            type: string
          required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json: {}
  /{nascar_series}/drivers/{season_year}/drivers.{format}:
    get:
      tags:
        - General
      summary: Driver Statistics
      description: >-
        Provides seasonal statistics for all drivers, catalogued by track type,
        track name, and race name.
      parameters:
        - name: nascar_series
          in: path
          schema:
            type: string
          required: true
          description: (Required) Cup (sc or mc), Xfinity (xf), or Trucks (cw or go)
          example: mc
        - name: season_year
          in: path
          schema:
            type: integer
          required: true
          description: (Required) Year in 4 digit format
          example: '2021'
        - name: format
          in: path
          schema:
            type: string
          required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json: {}
  /{nascar_series}/{season_year}/drivers/list.{format}:
    get:
      tags:
        - General
      summary: Drivers
      description: >-
        Provides detailed driver biographical information for a given season,
        including information regarding their cars and teams.
      parameters:
        - name: nascar_series
          in: path
          schema:
            type: string
          required: true
          description: (Required) Cup (sc or mc), Xfinity (xf), or Trucks (cw or go)
          example: mc
        - name: season_year
          in: path
          schema:
            type: integer
          required: true
          description: (Required) Year in 4 digit format
          example: '2021'
        - name: format
          in: path
          schema:
            type: string
          required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json: {}
  /{nascar_series}/races/{race_id}/entry_list.{format}:
    get:
      tags:
        - General
      summary: Entry List
      description: >-
        Provides information regarding all drivers scheduled to attempt to
        qualify for a race.
      parameters:
        - name: nascar_series
          in: path
          schema:
            type: string
          required: true
          description: (Required) Cup (sc or mc), Xfinity (xf), or Trucks (cw or go)
          example: mc
        - name: race_id
          in: path
          schema:
            type: string
          required: true
          description: (Required) ID of a race
          example: 90fc5b0c-4ac5-44de-a4de-ae2d6d3f328a
        - name: format
          in: path
          schema:
            type: string
          required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json: {}
  /{nascar_series}/{season_year}/standings/manufacturers.{format}:
    get:
      tags:
        - General
      summary: Manufacturer Standings
      description: Provides detailed standings info for manufacturers.
      parameters:
        - name: nascar_series
          in: path
          schema:
            type: string
          required: true
          description: (Required) Cup (sc or mc), Xfinity (xf), or Trucks (cw or go)
          example: mc
        - name: season_year
          in: path
          schema:
            type: integer
          required: true
          description: (Required) Year in 4 digit format
          example: '2021'
        - name: format
          in: path
          schema:
            type: string
          required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json: {}
  /{nascar_series}/{season_year}/standings/owners.{format}:
    get:
      tags:
        - General
      summary: Owner Standings
      description: Provides detailed standings info for owners.
      parameters:
        - name: nascar_series
          in: path
          schema:
            type: string
          required: true
          description: (Required) Cup (sc or mc), Xfinity (xf), or Trucks (cw or go)
          example: mc
        - name: season_year
          in: path
          schema:
            type: integer
          required: true
          description: (Required) Year in 4 digit format
          example: '2021'
        - name: format
          in: path
          schema:
            type: string
          required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json: {}
  /{nascar_series}/{season_year}/playoff/schedule.{format}:
    get:
      tags:
        - General
      summary: Playoff Schedule
      description: >-
        Provides detailed schedule info for all playoff events associated with a
        given series.
      parameters:
        - name: nascar_series
          in: path
          schema:
            type: string
          required: true
          description: (Required) Cup (sc or mc), Xfinity (xf), or Trucks (cw or go)
          example: mc
        - name: season_year
          in: path
          schema:
            type: integer
          required: true
          description: (Required) Year in 4 digit format
          example: '2021'
        - name: format
          in: path
          schema:
            type: string
          required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json: {}
  /{nascar_series}/races/{race_id}/practices.{format}:
    get:
      tags:
        - General
      summary: Practice Leaderboard
      description: >-
        Provides practice information for all drivers entered in the field
        including sequence, speed, time, and finish position.
      parameters:
        - name: nascar_series
          in: path
          schema:
            type: string
          required: true
          description: (Required) Cup (sc or mc), Xfinity (xf), or Trucks (cw or go)
          example: mc
        - name: race_id
          in: path
          schema:
            type: string
          required: true
          description: (Required) ID of a race
          example: 90fc5b0c-4ac5-44de-a4de-ae2d6d3f328a
        - name: format
          in: path
          schema:
            type: string
          required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json: {}
  /{nascar_series}/races/{race_id}/qualifying.{format}:
    get:
      tags:
        - General
      summary: Qualifying Leaderboard
      description: >-
        Provides qualifying information for all drivers entered in the field
        including fastest speed, time, and finish position.
      parameters:
        - name: nascar_series
          in: path
          schema:
            type: string
          required: true
          description: (Required) Cup (sc or mc), Xfinity (xf), or Trucks (cw or go)
          example: mc
        - name: race_id
          in: path
          schema:
            type: string
          required: true
          description: (Required) ID of a race
          example: 90fc5b0c-4ac5-44de-a4de-ae2d6d3f328a
        - name: format
          in: path
          schema:
            type: string
          required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json: {}
  /{nascar_series}/races/{race_id}/results.{format}:
    get:
      tags:
        - General
      summary: Race Leaderboard
      description: >-
        Provides detailed information concerning a drivers race performance
        during and after the race.
      parameters:
        - name: nascar_series
          in: path
          schema:
            type: string
          required: true
          description: (Required) Cup (sc or mc), Xfinity (xf), or Trucks (cw or go)
          example: mc
        - name: race_id
          in: path
          schema:
            type: string
          required: true
          description: (Required) ID of a race
          example: 90fc5b0c-4ac5-44de-a4de-ae2d6d3f328a
        - name: format
          in: path
          schema:
            type: string
          required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json: {}
  /{nascar_series}/{season_year}/standings/rookies.{format}:
    get:
      tags:
        - General
      summary: Rookie Standings
      description: Provides detailed standings info for rookies.
      parameters:
        - name: nascar_series
          in: path
          schema:
            type: string
          required: true
          description: (Required) Cup (sc or mc), Xfinity (xf), or Trucks (cw or go)
          example: mc
        - name: season_year
          in: path
          schema:
            type: integer
          required: true
          description: (Required) Year in 4 digit format
          example: '2021'
        - name: format
          in: path
          schema:
            type: string
          required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json: {}
  /{nascar_series}/{season_year}/races/schedule.{format}:
    get:
      tags:
        - General
      summary: Schedule
      description: Provides detailed schedule info for all events in a given series.
      parameters:
        - name: nascar_series
          in: path
          schema:
            type: string
          required: true
          description: (Required) Cup (sc or mc), Xfinity (xf), or Trucks (cw or go)
          example: mc
        - name: season_year
          in: path
          schema:
            type: integer
          required: true
          description: (Required) Year in 4 digit format
          example: '2023'
        - name: format
          in: path
          schema:
            type: string
          required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json: {}
  /{nascar_series}/races/{race_id}/starting_grid.{format}:
    get:
      tags:
        - General
      summary: Starting Grid
      description: Provides the official start order of a race.
      parameters:
        - name: nascar_series
          in: path
          schema:
            type: string
          required: true
          description: (Required) Cup (sc or mc), Xfinity (xf), or Trucks (cw or go)
          example: mc
        - name: race_id
          in: path
          schema:
            type: string
          required: true
          description: (Required) ID of a race
          example: 90fc5b0c-4ac5-44de-a4de-ae2d6d3f328a
        - name: format
          in: path
          schema:
            type: string
          required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json: {}
  /tracks/list.{format}:
    get:
      tags:
        - General
      summary: Tracks
      description: >-
        Provides detailed information regarding all tracks within the Cup,
        Xfinity, and Craftsman race series.
      parameters:
        - name: format
          in: path
          schema:
            type: string
          required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json: {}
