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, which this API does not support. Setting this value to true or false will not impact the fare cost.

/api/v1/stations/listAllStations

No parameters. Lists off all stations and their respective IDs.

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"
    }
  }
}