mintapi 1.8

a screen-scraping API for Mint.com

a screen-scraping API for Mint.com. [](https://travis-ci.org/mrooney/mintapi)

Requirements === Ensure you have Python 2 or 3 and pip (easy_install pip) and then:

pip install mintapi

Usage ===

from Python — From python, instantiate the Mint class (from the mintapi package) and you can make calls to retrieve account/budget information. We recommend using the keyring library for persisting credentials.

import mintapi mint = mintapi.Mint(email, password)

# Get basic account information mint.get_accounts()

# Get extended account detail at the expense of speed - requires an # additional API call for each account mint.get_accounts(True)

# Get budget information mint.get_budgets()

# Get transactions mint.get_transactions()

# Initiate an account refresh mint.initiate_account_refresh()

There are, additionally, deprecated wrappers for backward compatibility with old versions of the API.

import mintapi mintapi.get_accounts(email, password) mintapi.get_accounts(email, password, True) mintapi.get_budgets(email, password) mintapi.initiate_account_refresh(email, password)

from anywhere — Run it as a sub-process from your favorite language; pip install mintapi creates a binary in your $PATH. From the command-line, the output is JSON:

Usage: mintapi [options]

Options:

-h, --help

show this help message and exit

--accounts

Retrieve account information (default if nothing else is specified)

--budgets

Retrieve budget information

--extended-accounts

Retrieve extended account information (slower, implies –accounts)

-t, --transactions

Retrieve transactions

-f FILENAME, --filename=FILENAME

write results to file. can be {csv,json} format. default is to write to stdout.

-u USER, --user=USER

mint email login. uses OS keyring to store password info.

>>> mintapi -u [e-mail]
[
  {
    "accountName": "Chase Checking",
    "lastUpdatedInString": "25 minutes",
    "accountType": "bank",
    "currentBalance": 100.12,
    ...
  },
  ...
]

If you need to avoid using pip or setup.py, you can also clone/download this repository and run: python mintapi/api.py