Monthly Treasury Statement (MTS)
This dataset contains a monthly summary of the federal government's receipts and outlays, as well as the resulting surpluses and deficits.
About This Dataset
Description:
The Monthly Treasury Statement (MTS) dataset provides information on the flow of money into and out of the U.S. Department of the Treasury. It includes how deficits are funded, such as borrowing from the public or reducing operating cash, and how surpluses are distributed. Further tables categorize spending (outlays) by department and agency, revenue (receipts) by specific taxes or other government sources of income, and transactions with trust funds such as Social Security or Medicare. All values are reported in millions of U.S. dollars.
| Data Table Name | Field Name | Display Name | Description | Data Type | Is Required |
|---|
- 5
- 10
- 20
- 50
- 100
| Table Name | Description | Row Description | File Sizes | Row Count |
|---|
| Name | Definition |
|---|
Notes & Known Limitations
MTS datasets include total and subtotal rows that should be excluded when aggregating data. Some rows represent elements of a given dataset's hierarchy, but are not assigned values. The classification_id for each of these elements can be used as the parent_id for underlying data elements to calculate their implied values. Subtotal rows will often be available to access this same information.
Money flowing into the Treasury is known as receipts, and money flowing out is known as outlays. A surplus occurs if the total value of receipts exceeds the value of outlays, and a deficit occurs when the value of outlays exceeds the value of receipts. All values are reported in millions of U.S. dollars. Some columns in this dataset overlap with the Historical Debt Outstanding, Daily Treasury Statement (DTS), Schedules of Federal Debt, Interest Expense on the Debt Outstanding, and Debt to the Penny datasets.
Debt issued by the Federal Financing Bank is included in the intragovernmental holdings on the MTS, but not in the Schedules of Federal Debt because it is not debt managed by the Bureau of the Fiscal Service. The difference between these datasets is equal to the amount of the Federal Financing Bank amount. The MTS only reports interest that has been paid out of the Treasury Account Symbol 20X0550 - Interest on the Public Debt. This does not align with the Total Interest on the Public Debt in the Interest Expense on the Public Debt Outstanding dataset because it does not include the restoration of foregone interest due the Debt Issuance Suspension Period.
Preview
API Quick Guide
https://www.transparency.treasury.gov/services/api/fiscal_service| Table Name | Endpoint |
|---|
- 5
- 10
- 20
- 50
- 100
https://www.transparency.treasury.gov/services/api/fiscal_service/| Field Name | Display Name | Data Type | Data Table Name |
|---|
- 5
- 10
- 20
- 50
- 100
- Parameter:
fields= - Definition: The fields parameter allows you to select which field(s) should be included in the response.
- Accepts: The
fields=parameter accepts a comma-separated list of field names (no parentheses). - Required: No, specifying fields is not required to make an API request.
- Default: If desired fields are not specified, all fields will be returned.
- Notes: When a field named passed to the
fields=parameter is not available for the endpoint accessed, an error will occur. Note that omitting fields can result in automatically aggregated and summed data results. For more information, view the full documentation on Aggregation and Sums.
?fields=- Parameter:
filter= - Definition: Filters are used to view a subset of the data based on specific criteria. For example, you may want to find data that falls within a certain date range, or only show records which contain a value larger than a certain threshold.
- Accepts: The filter parameter
filter=accepts filters from the list below, as well as specified filter criteria. Use a colon at the end of a filter parameter to pass a value or list of values. For lists passed as filter criteria, use a comma-separated list within parentheses. Filter for specific dates using the formatYYYY-MM-DD. - Required: No, filters are not required to make an API request.
- Default: When no filters are provided, the default response will return all fields and all data.
lt= Less thanlte= Less than or equal togt= Greater thangte= Greater than or equal toeq= Equal toin= Contained in a given set
?filter=undefined:eq:undefinedhttps://www.transparency.treasury.gov/services/api/fiscal_service/undefined?filter=undefined:eq:undefined- Parameter:
sort= - Definition: The sort parameter allows a user to sort a field in ascending (least to greatest) or descending (greatest to least) order.
- Accepts: The sort parameter
sort=accepts a comma-separated list of field names. - Required: No, sorting is not required to make an API request.
- Default: When no sort parameter is specified, the default is to sort by the first column listed. Most API endpoints are thus sorted by date in ascending order (historical to most current).
- Notes: You can nest sorting by passing the
sort=parameter a comma-separated list.
?sort=-undefinedhttps://www.transparency.treasury.gov/services/api/fiscal_service/undefined?sort=-undefined- Parameter:
format= - Definition: The format parameter allows a user to define the output method of the response (CSV, JSON, XML).
- Accepts: The
format=parameter acceptsxml,json, orcsvas an input. - Required: No, the format parameter is not required to make an API request.
- Default: When no format is specified, the default response format is JSON.
?format=csv- Parameter:
page[size]=andpage[number]= - Definition: The page size will set the number of rows that are returned on a request, and page number will set the index for the pagination, starting at 1. This allows the user to paginate through the records returned from an API request.
- Accepts: The
page[number]=andpage[size]=parameters both accept integers. - Required: No, neither pagination parameters are required to make an API request.
- Default: When no page number or page size parameter is specified, the default response is
- Page number: 1
- Page size: 100
- Specifying the endpoint
- Requesting the JSON response format
- Sorting the data by
in descending order - Setting pagination parameters
https://www.transparency.treasury.gov/services/api/fiscal_service/undefined?sort=-undefined&format=json&page[number]=1&page[size]=1 Loading...For More API Information
- Aggregation and sums
- Pivoting
- Response codes
- Meta object
- ...and more!
Related Datasets
