This API is utilized by USAspending.gov to obtain all federal spending data which is open source and provided to the public as part of the DATA Act.

Install

Ensure the following dependencies are installed and working prior to continuing:

Requirements

• python3
• pyenv using Python 3.5.x
  • NOTE: Read full install. brew install needs to be followed by additional steps to modify and source your ~/.bash_profile
• PostgreSQL 10.x (with a dedicated data_store_api database)
• direnv
  • For Mac OSX, be sure to put the hook in your ~/.bash_profile, not ~/.bashrc
• Bash or another Unix Shell equivalent
  • Bash is available on Windows as Windows Subsystem for Linux
• Command line package manager
  • Windows' WSL bash uses apt-get
  • OSX users will use Homebrew

Setup

Navigate to the base file directory for the USAspending repositories

$ mkdir -p usaspending && cd usaspending
$ git clone https://github.com/fedspendingtransparency/usaspending-api.git
$ cd usaspending-api

Create and activate the virtual environment using venv, and ensure the right version of Python 3.5.x is being used (the latest RHEL package available for python35u, currently 3.5.5)

$ pyenv install 3.5.5
$ pyenv local 3.5.5
$ python -m venv .venv/usaspending-api
$ source .venv/usaspending-api/bin/activate

Your prompt should then look as below to show you are in the virtual environment named usaspending-api (to exit that virtual environment, simply type deactivate at the prompt).

(usaspending-api) $ 

pip install application dependencies

💡 (try a different WiFi if you're current one blocks dependency downloads)

(usaspending-api) $ pip install -r requirements/requirements.txt

Set environment variables (fill in the connection string placeholders, e.g. USER, PASSWORD, HOST, PORT) *note: default port for PostgreSQL is 5432

(usaspending-api) $ echo "export DATABASE_URL='postgres://USER:PASSWORD@HOST:PORT/data_store_api'" >> .envrc

Test the database connection and upate the data_store_api schema

(usaspending-api) $ ./manage.py migrate

Start up the site

(usaspending-api) $ ./manage.py runserver

The application will be available at http://localhost:8000

API

In your local development environment, available API endpoints may be found at http://localhost:8000/docs/endpoints

Deployed production API endpoints and docs are found by following links here: https://api.usaspending.gov

Loading Data

For details on loading reference data, DATA Act Broker submissions, and current USAspending data into the API, see loading_data.md.

For details on how our data loaders modify incoming data, see data_changes.md.

Public Domain License

This project is in the public domain within the United States, and copyright and related rights in the work worldwide are waived through the CC0 1.0 Universal public domain dedication.

All contributions to this project will be released under the CC0 dedication. By submitting a pull request, you are agreeing to comply with this waiver of copyright interest.