Introduction
01/31/2001 — 04/30/2024Released MonthlyLast Updated 05/06/2024
The U.S. Treasury Monthly Statement of the Public Debt (MSPD) dataset details the Treasury's outstanding debts and the statutory debt limit. Debt is categorized by whether it is marketable or non-marketable and whether it is debt held by the public or debt held by government agencies. All amounts are reported in millions of U.S. dollars. Data is published on the fourth business day of each month, detailing the debt as of the end of the previous month.
Preview
Data Table:
N/A
Date Range:
Dataset Properties
Data Table Name | Field Name | Display Name | Description | Data Type | Is Required |
|---|---|---|---|---|---|
| Summary of Treasury Securities Outstanding | record_date | Record Date | The date that data was published. | DATE | 1 |
| Summary of Treasury Securities Outstanding | security_type_desc | Security Type Description | Tier one of a two-tier hierarchy for categorizing Treasury securities. Indicates whether a security type is marketable or nonmarketable. | STRING | 1 |
| Summary of Treasury Securities Outstanding | security_class_desc | Security Class Description | Tier two of a two-tier hierarchy for categorizing Treasury securities. | STRING | 1 |
| Summary of Treasury Securities Outstanding | debt_held_public_mil_amt | Debt Held by the Public (in Millions) | All federal debt held by individuals, corporations, state or local governments, Federal Reserve Banks, foreign governments, and other entities outside the United States Government less Federal Financing Bank securities. All figures are rounded to the nearest million. | CURRENCY0 | 1 |
| Summary of Treasury Securities Outstanding | intragov_hold_mil_amt | Intragovernmental Holdings (in Millions) | Government Account Series securities held by Government trust funds, revolving funds, and special funds; and Federal Financing Bank securities. A small amount of marketable securities are held by government accounts. All figures are rounded to the nearest million. | CURRENCY0 | 1 |
Showing 1 - 5
rows
of
rows
| Table Name | Description | Row Description | Row Count |
|---|
| Name | Definition |
|---|
Notes & Known Limitations
Total Public Debt Outstanding Disclaimer
There are six datasets on Fiscal Data which include the national debt, which is referred to as Total Public Debt Outstanding (TPDO). TPDO is the sum of Debt Held by the Public and Intragovernmental (Intragov) Holdings. Some datasets include debt issued by the Federal Financing Bank (FFB). The datasets listed below only include debt issued by the Treasury Department. The list below provides information on where there are differences in debt calculations related to the national debt.
Debt to the Penny contains TPDO, as well as a breakout of Debt Held by the Public and Intragov Holdings. In this dataset, Intragov Holdings includes debt issued by the FFB.
Historical Debt Outstanding contains TPDO, but no breakout of Debt Held by the Public and Intragov Holdings. In this dataset, TPDO includes debt issued by the FFB.
Daily Treasury Statement (DTS) contains Debt Held by the Public and Intragov Holdings, but does not aggregate these two categories into TPDO. In this dataset, Intragov Holdings includes debt issued by the FFB. Dollar values for Debt Held by the Public and Intragov Holdings are rounded in millions to cohere with other data in the dataset. Please note that the published reports on the Fiscal Service site contain TPDO values.
Monthly Treasury Statement (MTS) contains TPDO, as well as a breakout of Debt Held by the Public and Intragov Holdings. In this dataset, Intragov Holdings includes debt issued by the FFB.
Monthly Statement of the Public Debt (MSPD) contains TPDO, as well as a breakout of Debt Held by the Public and Intragov Holdings. In this dataset, Intragov Holdings includes debt issued by the FFB. Dollar values are rounded in millions to cohere with other data in the dataset.
Schedules of Federal Debt contains Debt Held by the Public and Intragov Holdings, but does not aggregate these two categories into TPDO. In this dataset, Intragov Holdings do not include debt issued by the FFB. Dollar values are rounded in millions to cohere with other data in the dataset.
End Total Public Debt Outstanding Disclaimer
The Statutory Debt Limit is the maximum amount, established by law, of public debt that can be outstanding at a given time. In the Detail of Non-Marketable Treasury Securities Outstanding table, values with an asterisk (*) denote values less than $500,000. Also for data in this table before 2007, redemptions (retired) and inflation adjustments are combined in one field: inflation_adj_amt. Some columns in this dataset overlap with the Historical Debt Outstanding, Gift Contributions to Reduce the Public Debt, Debt to the Penny, Monthly Treasury Statement (MTS), Schedules of Federal Debt, Daily Treasury Statement (DTS), and Savings Bonds Securities datasets.
Debt issued by the Federal Financing Bank is included in the intragovernmental holdings and total public debt outstanding on the MSPD, 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 securities outstanding. Total savings bonds outstanding reported in the MSPD will not match total savings bonds outstanding in the Savings Bonds Securities dataset due to a difference in the timing of when reversals and reconciliation transactions are recorded. Gifts to Reduce the Public Debt on the MSPD are reported with a one month lag.
Total Public Debt Outstanding = Debt Held by the Public + Intragovernmental Holdings
Please note that Total Public Debt Outstanding may be calculated differently within different datasets. See those datasets Notes & Known Limitations section for more details.
API Quick Guide
Check out our more detailed API Documentation.
API Documentation
Endpoints
BASE URL:
https://api.fiscaldata.treasury.gov/services/api/fiscal_service/
| Table Name | Endpoint |
|---|
Showing 1 - 7 rows of 7 rows
FULL URL:
https://api.fiscaldata.treasury.gov/services/api/fiscal_service/
Fields
Refer to Dataset Properties above for a data dictionary with field names and descriptions, as well as notes and known limitations. known limitations.
| Field Name | Display Name | Data Type | Data Table Name |
|---|
Showing 1 - 5 rows of 129 rows
Data Types
All data is returned as a string, including nulls. Refer to the chart above for the intended data type of each field.
Parameters
Refer to Dataset Properties above for a data dictionary with field names and descriptions as well as notes and known limitations
Fields
toggle contents
- 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.
EXAMPLE
?fields=
Filters
toggle contents
Sorting
toggle contents
Format
toggle contents
Pagination
toggle contents
Methods
Our APIs accept the GET method, one of the most common HTTP methods.
Example Request & Response
In this example, we are...
- Specifying the endpoint
- Requesting the JSON response format
- Sorting the data by
in descending order - Setting pagination parameters
EXAMPLE REQUEST
https://api.fiscaldata.treasury.gov/services/api/fiscal_service/undefined?sort=-undefined&format=json&page[number]=1&page[size]=1
EXPECTED RESPONSE
Loading...
For More API Information
Visit our full API documentation to find out more about:
- Aggregation and sums
- Pivoting
- Response codes
- Meta object
- ...and more!
API Documentation
