The Greenbook API is available on

Additional notes about the API: A RESTful API with json, xml, and csv access, interactive documentation, API keys, and code samples. More information on the API can be found here on

About the Dataset

This dataset is used to produce the "U.S. Overseas Loans and Grants" publication. The annual report to Congress on U.S foreign assistance flows is required by the Foreign Assistance Act, Section 634. To better understand the data it is suggested that first time users visit the "U.S. Overseas Loans and Grants" site at The "U.S. Overseas Loans and Grants" is the authoritative data set of U.S. foreign assistance.

The annual update of the "U.S. Overseas Loans and Grants," informally known as the "Greenbook," contains data of United States Government (USG) foreign assistance since 1945. Foreign assistance is categorized as either economic assistance or military assistance. Foreign assistance is reported by recipient country and organized by geographic region, without distinction between developed and developing countries. Any country which has received cumulative economic or military assistance over $500,000 since 1945 and is considered an "Independent State" by the U.S. Department of State merits an individual country reporting.

Additional notes on the dataset:

Download in CSV format


Response Format:

json, xml




None required

Column IDs:

Assistance Type
Recipient Country
Program Name
Unit Name
Fiscal Year
Obligations ($US)


Data Parameters and Examples

ParameterTypeSample Values
Assistance TypetextEconomic
Recipient CountrytextAfghanistan
Program NametextChild Survival and Health
Unit NametextHistorical $US
Obligations ($US)numerical string with dollar sign2641222.85837744

Interact with the data: