Public transportation

BasicStartupBusiness

Response attributes

Name	Type	Description
providers.name.full	String	Full name of the provider. Note: if there is only one name of the provider it will be filled in this field.
providers.name.short	String	Short name of the provider. Note: not always available.
providers.logo.png	String	Link to the provider's logo in `PNG` format
providers.logo.svg	String	Link to the provider's logo in `SVG` format
providers.website.url	String	URL of the provider's website
providers.website.languages	String[]	List of available languages (alpha3code) on the site, excluding any machine translation (eg. Google Translate)
providers.modes.type	String	Public transportation mode of transport (`TAXI`, `METRO`, `BUS`, `TRAM`, `TRAIN`, `BOAT`, `FUNICULAR`, `TROLLEY_BUS`, `CHAIRLIFT`, `CABLE_CAR`)
providers.modes.name	String	Special name, if available (eg. "Staten Island Ferry")
providers.modes.timetable	String	URL to the timetable for this mode of transport
providers.modes.map	String	URL to the map for this mode of transport (can be a website, PDF or interactive map)
tickets.prices.type	String	Type of the ticket (`SINGLE` or `MONTHLY`)
tickets.prices.price	Object	Money object
thirdPartyApps.id	String	ID of the third party app (`TRANSIT`, `CITYMAPPER`, `MOOVIT`, `GOOGLE_TRANSIT`)
thirdPartyApps.name	String	Name of the third party app
thirdPartyApps.website	String	Website of the app (when possible it is city specific - deep linked into the website)

Response text attributes

BasicStartupBusiness

Name	Type	Description
textual.title	String	Category name
textual.sections.id[MODES].body	String	List of all modes of transport
textual.sections.id[SUMMARY].body	String	Public transportation description
textual.sections.id[TICKETS].body	String	Ticket prices description
textual.sections.id[APPS].body	String	Third-party apps description

Example response

{
  "providers": [
    {
      "name": {
        "full": "Metropolitan Transit Authority",
        "short": "MTA"
      },
      "logo": {
        "png": "https://s3.amazonaws.com/basetrip/api/v3/public-transportation/us-new-york-mta.png",
        "svg": "https://s3.amazonaws.com/basetrip/api/v3/public-transportation/us-new-york-mta.svg"
      },
      "website": {
        "url": "http://www.mta.info/",
        "languages": [
          "eng"
        ]
      },
      "modes": [
        {
          "type": "METRO",
          "timetable": "http://www.mta.info/schedules",
          "map": "http://web.mta.info/maps/"
        },
        {
          "type": "BUS",
          "timetable": "http://www.mta.info/schedules",
          "map": "http://web.mta.info/maps/"
        },
        {
          "type": "TRAIN",
          "timetable": "http://www.mta.info/schedules",
          "map": "http://web.mta.info/maps/"
        }
      ]
    },
    {
      "name": {
        "full": "New York City Department of Transportation",
        "short": "NYC DOT"
      },
      "logo": {
        "png": "https://s3.amazonaws.com/basetrip/api/v3/public-transportation/us-new-york-dot.png",
        "svg": "https://s3.amazonaws.com/basetrip/api/v3/public-transportation/us-new-york-dot.svg"
      },
      "website": {
        "url": "http://www.nyc.gov/html/dot/html/home/home.shtml",
        "languages": [
          "eng"
        ]
      },
      "modes": [
        {
          "type": "BOAT",
          "name": "Staten Island Ferry",
          "timetable": "http://www.nyc.gov/html/dot/html/ferrybus/staten-island-ferry.shtml#schedule"
        }
      ]
    },
    {
      "name": {
        "full": "Port Authority Trans-Hudson Corporation",
        "short": "PATH"
      },
      "logo": {
        "png": "https://s3.amazonaws.com/basetrip/api/v3/public-transportation/us-new-york-path.png",
        "svg": "https://s3.amazonaws.com/basetrip/api/v3/public-transportation/us-new-york-path.svg"
      },
      "website": {
        "url": "http://www.panynj.gov/path/",
        "languages": [
          "eng"
        ]
      },
      "modes": [
        {
          "type": "TRAIN",
          "timetable": "http://www.panynj.gov/path/full-schedules.cfm",
          "map": "http://www.panynj.gov/path/maps.html"
        }
      ]
    }
  ],
  "tickets": {
    "prices": [
      {
        "type": "SINGLE",
        "price": {
          "amount": 3,
          "amountInteger": 300,
          "currency": "USD",
          "displayAs": "$3.00"
        }
      },
      {
        "type": "MONTHLY",
        "price": {
          "amount": 121,
          "amountInteger": 12100,
          "currency": "USD",
          "displayAs": "$121.00"
        }
      }
    ]
  },
  "thirdPartyApps": [
    {
      "id": "TRANSIT",
      "name": "Transit",
      "link": "https://transitapp.com/region/new-york"
    },
    {
      "id": "CITYMAPPER",
      "name": "Citymapper",
      "link": "https://citymapper.com/nyc"
    },
    {
      "id": "MOOVIT",
      "name": "Moovit",
      "link": "https://moovit.com/?metroId=121"
    },
    {
      "id": "GOOGLE_TRANSIT",
      "name": "Google Transit (Maps)",
      "link": "https://maps.google.com"
    }
  ],
  "textual": {
    "title": "Public transportation",
    "sections": [
      {
        "id": "MODES",
        "body": [
          "Metro, bus, train & boat"
        ]
      },
      {
        "id": "SUMMARY",
        "body": [
          "There are metro, bus, train & boat lines available in New York which are provided by MTA (Metropolitan Transit Authority), NYC DOT (New York City Department of Transportation) & PATH (Port Authority Trans-Hudson Corporation)."
        ]
      },
      {
        "id": "TICKETS",
        "body": [
          "Single ticket costs $3.00 while 30-day pass costs $121.00."
        ]
      },
      {
        "id": "APPS",
        "body": [
          "Transit routes are available via Transit, Citymapper, Moovit & Google Transit (Maps)."
        ]
      }
    ]
  }
}