Federal Reserve Economic Data

Terms of Use

fred/v2/release/observations


Description

Get the observations for all series on a release of economic data. If the requested data exceeds the default or user specified observation limit, next_cursor can be used to make subsequent requests and obtain a complete dataset.

Examples

This request can return either JSON or XML by setting the format parameter to xml or json. Note that the default value of format is json. This example includes results that are paginated across multiple requests for demonstration purposes. Requests assume an API key is set in a HTTP header.

JSON

Initial Request (HTTPS GET)

https://api.stlouisfed.org/fred/v2/release/observations?release_id=52&format=json

Initial Response


{
    "has_more": true,
    "next_cursor": "ABSITCMDODFS,1995-01-01",
    "release": {
        "release_id": 52,
        "name": "Z.1 Financial Accounts of the United States",
        "url": "https://www.federalreserve.gov/releases/z1/",
        "sources": [
            {
                "name": "Board of Governors of the Federal Reserve System (US)",
                "url": "https://www.federalreserve.gov/"
            }
        ]
    },
    "series": [
        {
            "series_id": "ABSITCMAHDFS",
            "title": "Issuers of Asset-Backed Securities; Debt Securities and Loans; Asset, Level",
            "frequency": "Quarterly",
            "units": "Billions of Dollars",
            "seasonal_adjustment": "Not Seasonally Adjusted",
            "last_updated": "2025-09-12T18:44:53Z",
            "copyright_id": "public domain: citation requested",
            "notes": "Source ID: FL674004005.Q\n\nFor more information about the Flow of Funds tables...",
            "observations": [
                {
                    "date": "1945-10-01",
                    "value": "0"
                },
                {
                    "date": "1946-01-01",
                    "value": "."
                },
                ...
                {
                    "date": "2024-10-01",
                    "value": "1371.116"
                },
                {
                    "date": "2025-01-01",
                    "value": "1404.392"
                },
                {
                    "date": "2025-04-01",
                    "value": "1413.048"
                }
            ]
        },
        {
            "series_id": "ABSITCMDODFS",
            "title": "Issuers of Asset-Backed Securities; Total Liabilities (DISCONTINUED)",
            "frequency": "Quarterly",
            "units": "Billions of Dollars",
            "seasonal_adjustment": "Not Seasonally Adjusted",
            "last_updated": "2015-06-11T19:01:33Z",
            "copyright_id": "public domain: citation requested",
            "notes": "Source ID: FL674190005.Q\n\nFor more information about the Flow of Funds tables...",
            "observations": [
                {
                    "date": "1949-10-01",
                    "value": "0"
                },
                ...
                {
                    "date": "1994-04-01",
                    "value": "504.22"
                },
                {
                    "date": "1994-07-01",
                    "value": "521.25"
                },
                {
                    "date": "1994-10-01",
                    "value": "538.29"
                }
            ]
        }
    ]
}

Second Page Request (HTTPS GET)

https://api.stlouisfed.org/fred/v2/release/observations?release_id=52&format=json&next_cursor=ABSITCMDODFS,1995-01-01

Second Page Response


{
    "has_more": true,
    "next_cursor": "ADSCFXA027N,1967-01-01",
    "release": {
        "release_id": 52,
        "name": "Z.1 Financial Accounts of the United States",
        "url": "https://www.federalreserve.gov/releases/z1/",
        "sources": [
            {
                "name": "Board of Governors of the Federal Reserve System (US)",
                "url": "https://www.federalreserve.gov/"
            }
        ]
    },
    "series": [
        {
            "series_id": "ABSITCMDODFS",
            "title": "Issuers of Asset-Backed Securities; Total Liabilities (DISCONTINUED)",
            "frequency": "Quarterly",
            "units": "Billions of Dollars",
            "seasonal_adjustment": "Not Seasonally Adjusted",
            "last_updated": "2015-06-11T19:01:33Z",
            "copyright_id": "public domain: citation requested",
            "notes": "Source ID: FL674190005.Q\n\nFor more information about the Flow of Funds tables...",
            "observations": [
                {
                    "date": "1995-01-01",
                    "value": "552.22"
                },
                ...
                {
                    "date": "2014-07-01",
                    "value": "1393.99"
                },
                {
                    "date": "2014-10-01",
                    "value": "1385.63"
                },
                {
                    "date": "2015-01-01",
                    "value": "1359.71"
                }
            ]
        },
        ...
        {
            "series_id": "ADSCFXA027N",
            "title": "All Domestic Sectors; Consumption of Fixed Capital, Equipment, Software, and Structures, Current Cost Basis (IMA), Transactions",
            "frequency": "Annual",
            "units": "Millions of Dollars",
            "seasonal_adjustment": "Seasonally Adjusted Annual Rate",
            "last_updated": "2025-06-12T16:46:22Z",
            "copyright_id": "public domain: citation requested",
            "notes": "Source ID: FA886300091.A\n\nFor more information about the Flow of Funds tables, see the Financial Accounts Guide...",
            "observations": [
                {
                    "date": "1946-01-01",
                    "value": "25690"
                },
                ...
                {
                    "date": "1964-01-01",
                    "value": "82389"
                },
                {
                    "date": "1965-01-01",
                    "value": "88006"
                },
                {
                    "date": "1966-01-01",
                    "value": "95309"
                }
            ]
        }
    ]
}

Final Page Request (HTTPS GET)

https://api.stlouisfed.org/fred/v2/release/observations?release_id=52&format=json&next_cursor=WCMITCMFODNS,1962-01-01

Final Page Response


{
    "has_more": false,
    "release": {
        "release_id": 52,
        "name": "Z.1 Financial Accounts of the United States",
        "url": "https://www.federalreserve.gov/releases/z1/",
        "sources": [
            {
                "name": "Board of Governors of the Federal Reserve System (US)",
                "url": "https://www.federalreserve.gov/"
            }
        ]
    },
    "series": [
        {
            "series_id": "WCMITCMFODNS",
            "title": "Rest of the World; Debt Securities and Loans; Liability, Level",
            "frequency": "Quarterly",
            "units": "Billions of Dollars",
            "seasonal_adjustment": "Not Seasonally Adjusted",
            "last_updated": "2025-09-12T18:48:37Z",
            "copyright_id": "public domain: citation requested",
            "notes": "Source ID: FL264104005.Q\n\nFor more information about the Flow of Funds tables...",
            "observations": [
                {
                    "date": "1962-01-01",
                    "value": "25.165"
                },
                ...
                {
                    "date": "2024-10-01",
                    "value": "5116.855"
                },
                {
                    "date": "2025-01-01",
                    "value": "5349.513"
                },
                {
                    "date": "2025-04-01",
                    "value": "5553.595"
                }
            ]
        }
    ]
}

XML

Initial Request (HTTPS GET)

https://api.stlouisfed.org/fred/v2/release/observations?release_id=52&format=xml

Initial Response


<release_observations>
    <has_more>true</has_more>
    <next_cursor>ABSITCMDODFS,1995-01-01</next_cursor>
    <release>
        <release_id>52</release_id>
        <name>Z.1 Financial Accounts of the United States</name>
        <url>https://www.federalreserve.gov/releases/z1/</url>
        <source_collection>
            <source>
                <name>Board of Governors of the Federal Reserve System (US)</name>
                <url>https://www.federalreserve.gov/</url>
            </source>
        </source_collection>
    </release>
    <series_collection>
        <series>
            <series_id>ABSITCMAHDFS</series_id>
            <title>Issuers of Asset-Backed Securities; Debt Securities and Loans; Asset, Level</title>
            <frequency>Quarterly</frequency>
            <units>Billions of Dollars</units>
            <seasonal_adjustment>Not Seasonally Adjusted</seasonal_adjustment>
            <last_update>2025-09-12T18:44:53Z</last_update>
            <copyright_id>public domain: citation requested</copyright_id>
            <notes>Source ID: FL674004005.Q\n\nFor more information about the Flow of Funds tables...
            </notes>
            <observations>
                <observation>
                    <date>1945-10-01</date>
                    <value>0</value>
                </observation>
                <observation>
                    <date>1946-01-01</date>
                    <value>.</value>
                </observation>
                ...
                <observation>
                    <date>2024-10-01</date>
                    <value>1371.116</value>
                </observation>
                <observation>
                    <date>2025-01-01</date>
                    <value>1404.392</value>
                </observation>
                <observation>
                    <date>2025-04-01</date>
                    <value>1413.048</value>
                </observation>
            </observations>
        </series>
        <series>
            <series_id>ABSITCMDODFS</series_id>
            <title>Issuers of Asset-Backed Securities; Total Liabilities (DISCONTINUED)</title>
            <frequency>Quarterly</frequency>
            <units>Billions of Dollars</units>
            <seasonal_adjustment>Not Seasonally Adjusted</seasonal_adjustment>
            <last_update>2015-06-11T19:01:33Z</last_update>
            <copyright_id>public domain: citation requested</copyright_id>
            <notes>Source ID: FL674190005.Q\n\nFor more information about the Flow of Funds tables...
            </notes>
            <observations>
                <observation>
                    <date>1949-10-01</date>
                    <value>0</value>
                </observation>
                ...
                <observation>
                    <date>1994-04-01</date>
                    <value>504.22</value>
                </observation>
                <observation>
                    <date>1994-07-01</date>
                    <value>521.25</value>
                </observation>
                <observation>
                    <date>1994-10-01</date>
                    <value>538.29</value>
                </observation>
            </observations>
        </series>
    </series_collection>
</release_observations>

Second Page Request (HTTPS GET)

https://api.stlouisfed.org/fred/v2/release/observations?release_id=52&format=xml&next_cursor=ABSITCMDODFS,1995-01-01

Second Page Response


<release_observations>
    <has_more>true</has_more>
    <next_cursor>ADSCFXA027N,1967-01-01</next_cursor>
    <release>
        <release_id>52</release_id>
        <name>Z.1 Financial Accounts of the United States</name>
        <url>https://www.federalreserve.gov/releases/z1/</url>
        <source_collection>
            <source>
                <name>Board of Governors of the Federal Reserve System (US)</name>
                <url>https://www.federalreserve.gov/</url>
            </source>
        </source_collection>
    </release>
    <series_collection>
        <series>
            <series_id>ABSITCMDODFS</series_id>
            <title>Issuers of Asset-Backed Securities; Total Liabilities (DISCONTINUED)</title>
            <frequency>Quarterly</frequency>
            <units>Billions of Dollars</units>
            <seasonal_adjustment>Not Seasonally Adjusted</seasonal_adjustment>
            <last_update>2015-06-11T19:01:33Z</last_update>
            <copyright_id>public domain: citation requested</copyright_id>
            <notes>Source ID: FL674190005.Q\n\nFor more information about the Flow of Funds tables...
            </notes>
            <observations>
                <observation>
                    <date>1995-01-01</date>
                    <value>552.22</value>
                </observation>
                ...
                <observation>
                    <date>2014-07-01</date>
                    <value>1393.99</value>
                </observation>
                <observation>
                    <date>2014-10-01</date>
                    <value>1385.63</value>
                </observation>
                <observation>
                    <date>2015-01-01</date>
                    <value>1359.71</value>
                </observation>
            </observations>
        </series>
        ...
        <series>
            <series_id>ADSCFXA027N</series_id>
            <title>All Domestic Sectors; Consumption of Fixed Capital, Equipment, Software, and Structures, Current Cost
                Basis (IMA), Transactions
            </title>
            <frequency>Annual</frequency>
            <units>Millions of Dollars</units>
            <seasonal_adjustment>Seasonally Adjusted Annual Rate</seasonal_adjustment>
            <last_update>2025-06-12T16:46:22Z</last_update>
            <copyright_id>public domain: citation requested</copyright_id>
            <notes>Source ID: FA886300091.A\n\nFor more information about the Flow of Funds tables...
            </notes>
            <observations>
                <observation>
                    <date>1946-01-01</date>
                    <value>25690</value>
                </observation>
                ...
                <observation>
                    <date>1964-01-01</date>
                    <value>82389</value>
                </observation>
                <observation>
                    <date>1965-01-01</date>
                    <value>88006</value>
                </observation>
                <observation>
                    <date>1966-01-01</date>
                    <value>95309</value>
                </observation>
            </observations>
        </series>
    </series_collection>
</release_observations>

Final Page Request (HTTPS GET)

https://api.stlouisfed.org/fred/v2/release/observations?release_id=52&format=xml&next_cursor=WCMITCMFODNS,1962-01-01

Final Page Response


<release_observations>
    <has_more>false</has_more>
    <release>
        <release_id>52</release_id>
        <name>Z.1 Financial Accounts of the United States</name>
        <url>https://www.federalreserve.gov/releases/z1/</url>
        <source_collection>
            <source>
                <name>Board of Governors of the Federal Reserve System (US)</name>
                <url>https://www.federalreserve.gov/</url>
            </source>
        </source_collection>
    </release>
    <series_collection>
        <series>
            <series_id>WCMITCMFODNS</series_id>
            <title>Rest of the World; Debt Securities and Loans; Liability, Level</title>
            <frequency>Quarterly</frequency>
            <units>Billions of Dollars</units>
            <seasonal_adjustment>Not Seasonally Adjusted</seasonal_adjustment>
            <last_update>2025-09-12T18:48:37Z</last_update>
            <copyright_id>public domain: citation requested</copyright_id>
            <notes>Source ID: FL264104005.Q\n\nFor more information about the Flow of Funds tables...
            </notes>
            <observations>
                <observation>
                    <date>1962-01-01</date>
                    <value>25.165</value>
                </observation>
                ...
                <observation>
                    <date>2024-10-01</date>
                    <value>5116.855</value>
                </observation>
                <observation>
                    <date>2025-01-01</date>
                    <value>5349.513</value>
                </observation>
                <observation>
                    <date>2025-04-01</date>
                    <value>5553.595</value>
                </observation>
            </observations>
        </series>
    </series_collection>
</release_observations>

Parameters

release_id

The id for a release.

format

Set the format for the HTTP response.

limit

The maximum number of observations to return.

next_cursor

The cursor for the next observations to retrieve.

Variables Returned with API

has_more

Whether subsequent requests are available to obtain a complete dataset.

next_cursor

A combination of the last series_id and observation date retrieved. Used in the next request to continue with subsequent pages to obtain additional data from the release.

release

Details about the release.

release_id

Unique ID of the requested release.

  • integer greater than 0

name

Name of the requested release.

  • string

url

Originating URL of the requested release.

  • string

sources

Agencies that publish the release.

name

Name of the agency publishing the release

  • string

url

Originating URL of the source.

  • string

notes

Notes about the source.

  • string, only available if a note has been recorded for the source

series

Details about the series.

series_id

Unique ID of the series in the release.

  • string

title

Title of the series.

  • string

frequency

Data frequency of the series.

  • string

units

Units of the series.

  • string

seasonal_adjustment

Seasonality of the series.

  • string

last_updated

Date and time when series was last updated. Please note during times that data is being updated in FRED, it's possible that a mix of series with updated and non-updated data can be retrieved within the same request. You can use the last_updated date for each series to detect whether an update has occurred during your requests. When encountered, we recommend reprocessing all requests for the release to obtain the most recent information.

  • string

copyright_id

Information on use of data with copyright restrictions. For more information see Terms of Use.

  • string

notes

Notes about the series.

  • string, may be an empty string

observations

Dates and associated observations for the series.

date

Date the value was observed on.

  • string representing the date in the format yyyy-mm-dd.

value

The observed value that date.

  • numeric string
  • the value is stored as a string to minimize precision loss and rounding errors
  • values for dates with missing observations are reported as a period "." and represent a null/missing value

Back to Top