Transport for London API Client

This gem aims to provide a simple, programmatic ruby client that allows native ruby applications to seamlessly interact with Transport for London's live APIs.

Build Status Dependency Status Code Climate Coverage Status


Add this line to your application's Gemfile:

gem 'tfl_api_client'

And then install via bundler:

$ bundle install

Or install it yourself as:

$ gem install tfl_api_client

Supported Ruby Versions

The TFL API Client supports Ruby 2.0.0 or higher.


TFL API Client has been designed to be as simple as possible to work with.

To use the TFL API, developers should register for a set of API credentials (an Application ID and Application Key).

Once valid API credentials have been obtained, you will need to pass the Application ID and Application Key upon initialisation of the client:

@client = TFL_APP_ID, app_key: TFL_APP_KEY)

In addition to the above mandatory parameters, a number of optional parameters can be passed:

Option Default Value Description
host TFL API's host url
logger a new Logger instance Logger object to log into
log_level INFO The log level to logging at
log_location STDOUT Location to send all logs (can be a file or STDOUT)

Full documentation can be found on the project's ruby docs.


See the CHANGELOG for a list of changes.


This project started in order to fill a gap in the current offers for gems that provide a programmatic interface to TFL's API.

The TFL API Client gem was originally developed by Luke Hackett, and is not an official TFL client.

In the spirit of free software, everyone is encouraged to help improve this project.

Here are some ways in which you can contribute:

  • by using prerelease versions
  • by reporting bugs
  • by suggesting new features
  • by writing or editing documentation
  • by writing code ( no patch is too small : fix typos, add comments, clean up inconsistent whitespace )
  • by refactoring code
  • by reviewing code

Submitting an Issue

I utilise the GitHub issue tracking to track bugs and features. Before submitting a bug report or feature request, check to make sure it hasn't already been submitted.

When submitting a bug report, please include a Gist that includes a stack trace and any details that may be necessary to reproduce the bug, including your gem version, Ruby version, and operating system.

Ideally, a bug report should include a pull request with failing specs.

Submitting a Pull Request

  1. Fork the repository.
  2. Create a feature branch using the gitflow naming convention e.g. feature/my-new-feature.
  3. Implement your feature or bug fix.
  4. Add, commit, and push your changes.
  5. Submit a pull request.


  • Please add tests if you changed code - contributions without tests won't be accepted.
  • Please don't update the Gem version.

The contributing guidelines was inspired by Middleman-Heroku and Factory Girl.


Copyright (c) 2015 - 2018 Luke Hackett. MIT Licensed, see LICENSE for details.