RubyMint

RubyMint is a gem to assist you with getting information from Mint.com's API.

Installation

Add this line to your application's Gemfile:

gem 'ruby_mint'

And then execute:

$ bundle

Or install it yourself as:

$ gem install ruby_mint

Usage

Initiate the Gem

RubyMint must be initiated using an email address and password. Prior to making any calls to the API, you must also login.

ruby_mint = RubyMint.new('myemail@foobar.com', 'mysecretpassword')
ruby_mint.login

Refreshing Data

Mint.com does not keep financial data 100% up to date, so if you want to get the most recent account and transaction data you must first refresh the data. Once a refresh has been initiated, it takes at least a few seconds for Mint.com to complete. There is also a method to check refresh status.

ruby_mint.initiate_account_refresh
ruby_mint.refreshing?

For convenience, you can also include a block to execute once refreshing is complete. There is an optional parameter to indicate how many seconds to wait between calls to check if the Mint.com is still refreshing.

ruby_mint.initiate_account_refresh(3) do
  # Get your mint data once refresh is complete
  puts "Refresh complete!"
end

Account Data

Account data is returned as a hash.

accounts = ruby_mint.accounts

Transaction Data

Mint.com returns transactions as CSV.

transactions = ruby_mint.transactions

Contributing

1. Fork it ( https://github.com/nickmarrone/ruby_mint/fork )
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request