Race Schedule

To obtain the schedule of races for a specific season use the following URL with the required year:


The schedule for the current season can always be obtained using the following static URL:


To obtain information about a specific race add the round number:


Race lists can be filtered by adding one or more of the following criteria followed by "/races":


For example, to list all races where a specific driver has driven at a particular circuit:


XML Example Response

<?xml version="1.0" encoding="utf-8"?>
<MRData xmlns="http://ergast.com/mrd-1.0" series="f1" limit="30" offset="0" total="18">
    <RaceTable season="2008">
        <Race season="2008" round="1" url="http://en.wikipedia.org/...">
            <RaceName>Australian Grand Prix</RaceName>
            <Circuit circuitId="albert_park" url="http://en.wikipedia.org/...">
                <CircuitName>Albert Park Grand Prix Circuit</CircuitName>
                <Location lat="-37.8497" long="144.968">
        <Race season="2008" round="2" url="http://en.wikipedia.org/...">
            <RaceName>Malaysian Grand Prix</RaceName>
            <Circuit circuitId="sepang" url="http://en.wikipedia.org/...">
                <CircuitName>Sepang International Circuit</CircuitName>
                <Location lat="2.76083" long="101.738">
                    <Locality>Kuala Lumpur</Locality>

JSON Example Response
  “MRData”: {
    “xmlns”: “http:\/\/ergast.com\/mrd\/1.0″,
    “series”: “f1″,
    “limit”: “30″,
    “offset”: “0″,
    “total”: “18″,
    “RaceTable”: {
      “season”: “2008″,
      “Races”: [
          "season": "2008",
          "round": "1",
          "url": "http:\/\/en.wikipedia.org\/wiki\/2008_Australian_Grand_Prix",
          "raceName": "Australian Grand Prix",
          "Circuit": {
            "circuitId": "albert_park",
            "url": "http:\/\/en.wikipedia.org\/wiki\/Melbourne_Grand_Prix_Circuit",
            "circuitName": "Albert Park Grand Prix Circuit",
            "Location": {
              "lat": "-37.8497",
              "long": "144.968",
              "locality": "Melbourne",
              "country": "Australia"
          "date": "2008-03-16",
          "time": "04:30:00Z"

Back to documentation index