Introduction
04/01/1993 — 05/22/2024Released DailyLast Updated 05/23/2024
The Debt to the Penny dataset provides information about the total outstanding public debt and is reported each day. Debt to the Penny is made up of intragovernmental holdings and debt held by the public, including securities issued by the U.S. Treasury. Total public debt outstanding is composed of Treasury Bills, Notes, Bonds, Treasury Inflation-Protected Securities (TIPS), Floating Rate Notes (FRNs), and Federal Financing Bank (FFB) securities, as well as Domestic Series, Foreign Series, State and Local Government Series (SLGS), U.S. Savings Securities, and Government Account Series (GAS) securities. Debt to the Penny is updated at the end of each business day with data from the previous business day.
Preview
Data Table:
N/A
Date Range:
Dataset Properties
Data Table Name | Field Name | Display Name | Description | Data Type | Is Required |
|---|---|---|---|---|---|
| Debt to the Penny | record_date | Record Date | The date that data was published. | DATE | 1 |
| Debt to the Penny | debt_held_public_amt | Debt Held by the Public | 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 (FFB) securities. Debt held by the public is composed of Treasury Bills, Notes, Bonds, Treasury Inflation-Protected Securities (TIPS), Floating Rate Notes (FRNs), Domestic Series, Foreign Series, State and Local Government Series (SLGS), United States Savings Securities, and a portion of Government Account Series (GAS) securities. | CURRENCY | 1 |
| Debt to the Penny | intragov_hold_amt | Intragovernmental Holdings | Government Account Series (GAS) securities held by Government trust funds, revolving funds, and special funds; and Federal Financing Bank (FFB) securities. | CURRENCY | 1 |
| Debt to the Penny | tot_pub_debt_out_amt | Total Public Debt Outstanding | Total of intragovernmental holdings and debt held by the public. | CURRENCY | 1 |
| Debt to the Penny | src_line_nbr | Source Line Number | Indicates the row of the corresponding table where a data point can be found. This can assist in structuring the data in a similar format to the published report and in understanding potential hierarchies within the table. | INTEGER | 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
Debt broken out by intragovernmental holdings and debt held by the public has not always been provided. Where this occurred, the dataset shows a value of $0.00 instead of a null value. Debt held by the public and intragovernmental holdings data is available yearly (on a fiscal basis) from 9/30/1997 through 9/30/2001, monthly from 9/30/2001 through 3/31/2005, and daily from 4/4/2005 to today. Some columns in this dataset overlap with the Monthly Statement of the Public Debt (MSPD), Monthly Treasury Statement (MTS), Daily Treasury Statement (DTS), and Schedules of Federal Debt datasets. Debt issued by the Federal Financing Bank (FFB) is included in the intragovernmental holdings in the Debt to the Penny dataset, but not in the Schedules of Federal Debt dataset because it is not debt managed by the Bureau of the Fiscal Service. The difference between these datasets is equal to the amount of debt issued by the FFB.
Downloaded CSV files with values greater than $10 trillion may have the final two digits (cents) excluded due to digit limits enforced by the application used to access the file. The JSON and XML file downloads are not impacted by this limitation.
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 calculation details.
API Quick Guide
Check out our more detailed API Documentation.
API Documentation
Endpoint
BASE URL:
https://api.fiscaldata.treasury.gov/services/api/fiscal_service/
ENDPOINT:
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 |
|---|
Showing 1 - 5 rows of 11 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
