Schedule Information API

Command: special

Inputs

Parameter Description
cmd=special Requests information about the current and upcoming BART Special Schedules. (Required)
key=<key> API registration key. (Required)
l=<number> Specifies whether the legend information should be included. By default it is 0 (not shown), but can be turned on by setting it to 1. (Optional)
json=y Returns API output in JSON format. Default output is XML if parameter not specified. (Optional)

Notes

Occasionally BART has special schedule announcements that affect certain stations (construction, etc.). If a trip is requested from the API, a message will be appended to the trip results stating that a special message may pertain to the trip. This API call provides all current and future special schedule notices. A notice is considered current or future if the end date is greater than or equal to the date the call is made.

Results

XML Sample

<?xml version="1.0" encoding="utf-8"?>
<root>
  <uri>
    <![CDATA[http://api.bart.gov/api/sched.aspx?cmd=special&l=1]]>
  </uri>
  <special_schedules>
    <special_schedule>
      <start_date>09/19/2016</start_date>
      <end_date>09/23/2016</end_date>
      <start_time></start_time>
      <end_time></end_time>
      <text>
        <![CDATA[Elevators out at Daly City 1 parking and 1 to southbound platform.]]>
      </text>
      <link>
        <![CDATA[http://www.bart.gov/news/articles/2016/news20160913-0]]>
      </link>
      <orig></orig>
      <dest></dest>
      <day_of_week></day_of_week>
      <routes_affected>ROUTE 1, ROUTE 2, ROUTE 7, ROUTE 8</routes_affected>
    </special_schedule>
    <special_schedule>
      <start_date>09/26/2016</start_date>
      <end_date>09/28/2016</end_date>
      <start_time></start_time>
      <end_time></end_time>
      <text>
        <![CDATA[One elevator out at the 13th St. end of the station.]]>
      </text>
      <link>
        <![CDATA[http://www.bart.gov/news/articles/2016/news20160919]]>
      </link>
      <orig></orig>
      <dest></dest>
      <day_of_week></day_of_week>
      <routes_affected></routes_affected>
    </special_schedule>
  </special_schedules>
  <message>
    <legend>day_of_week: 0 = Sunday, 1 = Monday, 2 = Tuesday, 3 = Wednesday, 4 = Thursday, 5 = Friday, 6 = Saturday, blank = all days</legend>
  </message>
</root>

JSON Sample

{
   "?xml":{
      "@version":"1.0",
      "@encoding":"utf-8"
   },
   "root":{
      "uri":{
         "#cdata-section":"http://api.bart.gov/api/sched.aspx?cmd=special&l=1&json=y"
      },
      "special_schedules":{
         "special_schedule":[
            {
               "start_date":"07/01/2017",
               "end_date":"07/02/2017",
               "start_time":"",
               "end_time":"",
               "text":{
                  "#cdata-section":"Expect delays of 20 to 40 minutes because of bus bridge between Fruitvale & 19th St."
               },
               "link":{
                  "#cdata-section":"http://www.bart.gov/news/articles/2017/news20170302-1"
               },
               "orig":"",
               "dest":"",
               "day_of_week":"",
               "routes_affected":"ROUTE 3, ROUTE 4, ROUTE 5, ROUTE 6, ROUTE 11, ROUTE 12, ROUTE 19, ROUTE 20"
            },
            {
               "start_date":"07/02/2017",
               "end_date":"07/02/2017",
               "start_time":"",
               "end_time":"",
               "text":{
                  "#cdata-section":"Single-tracking between Balboa Park & Daly City Sunday 7/2"
               },
               "link":{
                  "#cdata-section":"http://www.bart.gov/news/articles/2017/news20170623"
               },
               "orig":"",
               "dest":"",
               "day_of_week":"",
               "routes_affected":"ROUTE 1, ROUTE 2, ROUTE 5, ROUTE 6, ROUTE 7, ROUTE 8, ROUTE 11, ROUTE 12"
            },
            {
               "start_date":"11/30/2016",
               "end_date":"09/29/2017",
               "start_time":"",
               "end_time":"",
               "text":{
                  "#cdata-section":"Some Pleasant Hill parking garage elevators will be out of service through 2017."
               },
               "link":{
                  "#cdata-section":"http://www.bart.gov/news/articles/2016/news20161130"
               },
               "orig":"",
               "dest":"",
               "day_of_week":"",
               "routes_affected":""
            }
         ]
      },
      "message":{
         "legend":"day_of_week: 0 = Sunday, 1 = Monday, 2 = Tuesday, 3 = Wednesday, 4 = Thursday, 5 = Friday, 6 = Saturday, blank = all days"
      }
   }
}

Notes

If there is a related news article, then the link element will provide a URL to a BART news story.

Usage

XML: http://api.bart.gov/api/sched.aspx?cmd=special&key=MW9S-E7SL-26DU-VV8V&l=1
JSON: http://api.bart.gov/api/sched.aspx?cmd=special&key=MW9S-E7SL-26DU-VV8V&l=1&json=y