Shore Line East API Documentation

Base URL: https://sle-api.trentwiles.com

Information

Welcome to the unofficial Shore Line East API! Source code is available on GitHub.

Ratelimits

As of right now, the API is not ratelimted. I assume that everyone will respect the service (and indirectly CT Transit's infrastructure), but if excessive requests are made by a certain IP address, I reserve the right to throttle/block it. If this becomes a widespread issue, I will add ratelimits.

GET /api/v1/stations/convertIDToStation/<id>

Name Data Type Example
id int A station number (1-9)

Example

curl BASE_URL/api/v1/stations/convertIDToStation/9

{
  "success": true,
  "stationName": "New Haven Union Station"
}

GET /api/v1/stations/convertStationToID/<name>

Name Data Type Example
name String Full name of a station (ex. Madison, New-Haven-Union-Station, Old-Saybrook)

Example

curl BASE_URL/api/v1/stations/convertStationToID/New-Haven-State-Street

{
  "success": true,
  "stationID": "2"
}

POST /api/v1/fares/getRideFare

Name Data Type Example
start String Any valid station, in English (New London, Old Saybrook, Madison, etc.)
end String Same as above
isSenior boolean true/false, applies the senior citizen discount if true
isOffPeak boolean true/false*
ticketType String one_way, ten_trip, monthly, monthly_bus, school_monthly

Example

curl -X POST BASE_URL/api/v1/fares/getRideFare \
-H "Content-Type: application/x-www-form-urlencoded" \
--data-urlencode "start=New London" \
--data-urlencode "end=Madison" \
--data-urlencode "isSenior=false" \
--data-urlencode "isOffPeak=false" \
--data-urlencode "ticketType=one_way"

{
  "fare": "7.50",
  "comment": null,
  "currency": "USD"
}

* this parameter only applies to trips that involve Metro North. Metro North stations supported by the Shore Line East fare calculation scheme are West Haven, Bridgeport, South Norwalk, Stamford, Harlem-125th St, and Grand Central.

/api/v1/stations/listAllStations

No parameters. Lists off all stations and their respective IDs. Metro North stations are not listed under this endpoint, as they are only displayed on the fare calculation page.

Example

{
  "New London": "1",
  "Old Saybrook": "2",
  "Westbrook": "3",
  "Clinton": "4",
  "Madison": "5",
  "Guilford": "6",
  "Branford": "7",
  "New Haven State Street": "8",
  "New Haven Union Station": "9"
}

/api/v1/trains/getStationByID/<id>

Name Data Type Example
id String ID of a station, ie. 1, 4

Example

GET /api/v1/trains/getStationByID/5

{
  "generatedAt": 1730393603,
  "showingPastTrains": false,
  "eastbound": {
    "times": [
      {
        "epochTime": 1730400000,
        "humanReadable": "2:40 PM",
        "minutesUntil": 107,
        "inPast": false
      },
      {
        "epochTime": 1730408280,
        "humanReadable": "4:58 PM",
        "minutesUntil": 245,
        "inPast": false
      },
      {
        "epochTime": 1730410920,
        "humanReadable": "5:42 PM",
        "minutesUntil": 289,
        "inPast": false
      },
      {
        "epochTime": 1730419740,
        "humanReadable": "8:09 PM",
        "minutesUntil": 436,
        "inPast": false
      },
      {
        "epochTime": 1730423340,
        "humanReadable": "9:09 PM",
        "minutesUntil": 496,
        "inPast": false
      }
    ],
    "stops": {
      "currentStation": "Madison",
      "direction": "eastbound",
      "callingAt": [
        "Clinton",
        "Westbrook",
        "Old Saybrook",
        "New London"
      ],
      "terminatesAt": "New London"
    }
  },
  "westbound": {
    "times": [],
    "stops": {
      "currentStation": "Madison",
      "direction": "westbound",
      "callingAt": [
        "Guilford",
        "Branford",
        "New Haven State Street",
        "New Haven Union Station"
      ],
      "terminatesAt": "New Haven Union Station"
    }
  }
}

/api/v1/trains/getStationByName/

Name Data Type Example
name String Name of a station, ie. Madison or New-Haven-State-Street 
GET /api/v1/trains/getStationByName/Guilford

{
  "generatedAt": 1730393564,
  "showingPastTrains": false,
  "eastbound": {
    "times": [
      {
        "epochTime": 1730399700,
        "humanReadable": "2:35 PM",
        "minutesUntil": 102,
        "inPast": false
      },
      {
        "epochTime": 1730407740,
        "humanReadable": "4:49 PM",
        "minutesUntil": 236,
        "inPast": false
      },
      {
        "epochTime": 1730410620,
        "humanReadable": "5:37 PM",
        "minutesUntil": 284,
        "inPast": false
      },
      {
        "epochTime": 1730419440,
        "humanReadable": "8:04 PM",
        "minutesUntil": 431,
        "inPast": false
      },
      {
        "epochTime": 1730423040,
        "humanReadable": "9:04 PM",
        "minutesUntil": 491,
        "inPast": false
      }
    ],
    "stops": {
      "currentStation": "Guilford",
      "direction": "eastbound",
      "callingAt": [
        "Madison",
        "Clinton",
        "Westbrook",
        "Old Saybrook",
        "New London"
      ],
      "terminatesAt": "New London"
    }
  },
  "westbound": {
    "times": [
      {
        "epochTime": 1730406240,
        "humanReadable": "4:24 PM",
        "minutesUntil": 211,
        "inPast": false
      },
      {
        "epochTime": 1730414340,
        "humanReadable": "6:39 PM",
        "minutesUntil": 346,
        "inPast": false
      },
      {
        "epochTime": 1730419080,
        "humanReadable": "7:58 PM",
        "minutesUntil": 425,
        "inPast": false
      },
      {
        "epochTime": 1730425560,
        "humanReadable": "9:46 PM",
        "minutesUntil": 533,
        "inPast": false
      },
      {
        "epochTime": 1730429640,
        "humanReadable": "10:54 PM",
        "minutesUntil": 601,
        "inPast": false
      }
    ],
    "stops": {
      "currentStation": "Guilford",
      "direction": "westbound",
      "callingAt": [
        "Branford",
        "New Haven State Street",
        "New Haven Union Station"
      ],
      "terminatesAt": "New Haven Union Station"
    }
  }
}