St. Louis Fed | Economic Research | EconDISC® | FRED® | GeoFRED® | ALFRED® | CASSIDI® | FRASER® | Liber8® | APIs | Fed System
Economic Research from the Federal Reserve Bank of St. Louis
  Home | API Keys | FRED® API
Contact Us | Terms of Use | Privacy | Legal  

fred/series/vintagedates

Description

Get the dates in history when a series' data values were revised or new data values were released. Vintage dates are the release dates for a series excluding release dates when the data for a series did not change.

Example

Request (HTTP GET)

http://api.stlouisfed.org/fred/series/vintagedates?series_id=GNPCA&api_key=abcdefghijklmnopqrstuvwxyz123456

Note that API key 'abcdefghijklmnopqrstuvwxyz123456' is for demonstration purposes only. Use a registered API key instead.

Response

<?xml version="1.0" encoding="utf-8" ?>
<vintage_dates realtime_start="1776-07-04" realtime_end="9999-12-31" order_by="vintage_date" sort_order="asc" count="150" offset="0" limit="10000">
  <vintage_date>1958-12-21</vintage_date>
  <vintage_date>1959-02-19</vintage_date>
  <vintage_date>1959-07-19</vintage_date>
  <vintage_date>1960-02-16</vintage_date>
  <vintage_date>1960-07-22</vintage_date>
  <vintage_date>1961-02-19</vintage_date>
  <vintage_date>1961-07-19</vintage_date>
  <vintage_date>1962-02-24</vintage_date>
  <vintage_date>1962-07-20</vintage_date>
  <vintage_date>1963-02-20</vintage_date>
  <vintage_date>1963-07-22</vintage_date>
  <vintage_date>1964-02-20</vintage_date>
  <vintage_date>1964-07-16</vintage_date>
  <vintage_date>1965-01-14</vintage_date>
  <vintage_date>1965-02-17</vintage_date>
  <vintage_date>1965-08-19</vintage_date>
  <vintage_date>1966-01-13</vintage_date>
  <vintage_date>1966-02-15</vintage_date>
  <vintage_date>1966-07-15</vintage_date>
  <vintage_date>1967-01-13</vintage_date>
  <vintage_date>1967-02-17</vintage_date>
  <vintage_date>1967-07-17</vintage_date>
  <vintage_date>1968-01-16</vintage_date>
  <vintage_date>1968-02-15</vintage_date>
  <vintage_date>1968-07-18</vintage_date>
  <vintage_date>1969-01-14</vintage_date>
  <vintage_date>1969-02-14</vintage_date>
  <vintage_date>1969-07-17</vintage_date>
  <vintage_date>1970-01-16</vintage_date>
  <vintage_date>1970-02-13</vintage_date>
  <vintage_date>1970-07-17</vintage_date>
  <vintage_date>1971-01-18</vintage_date>
  <vintage_date>1971-02-12</vintage_date>
  <vintage_date>1971-07-16</vintage_date>
  <vintage_date>1972-01-21</vintage_date>
  <vintage_date>1972-02-18</vintage_date>
  <vintage_date>1972-07-21</vintage_date>
  <vintage_date>1973-01-19</vintage_date>
  <vintage_date>1973-02-20</vintage_date>
  <vintage_date>1973-07-19</vintage_date>
  <vintage_date>1974-01-17</vintage_date>
  <vintage_date>1974-02-20</vintage_date>
  <vintage_date>1974-07-18</vintage_date>
  <vintage_date>1975-01-16</vintage_date>
  <vintage_date>1975-03-20</vintage_date>
  <vintage_date>1976-01-16</vintage_date>
  <vintage_date>1976-01-20</vintage_date>
  <vintage_date>1976-02-19</vintage_date>
  <vintage_date>1976-03-19</vintage_date>
  <vintage_date>1976-07-20</vintage_date>
  <vintage_date>1977-01-18</vintage_date>
  <vintage_date>1977-02-18</vintage_date>
  <vintage_date>1977-03-21</vintage_date>
  <vintage_date>1977-07-21</vintage_date>
  <vintage_date>1978-01-19</vintage_date>
  <vintage_date>1978-02-21</vintage_date>
  <vintage_date>1978-03-20</vintage_date>
  <vintage_date>1978-07-21</vintage_date>
  <vintage_date>1979-01-18</vintage_date>
  <vintage_date>1979-02-22</vintage_date>
  <vintage_date>1979-03-20</vintage_date>
  <vintage_date>1979-07-20</vintage_date>
  <vintage_date>1980-01-18</vintage_date>
  <vintage_date>1980-02-22</vintage_date>
  <vintage_date>1980-03-19</vintage_date>
  <vintage_date>1980-12-23</vintage_date>
  <vintage_date>1981-01-21</vintage_date>
  <vintage_date>1981-02-19</vintage_date>
  <vintage_date>1981-03-18</vintage_date>
  <vintage_date>1982-01-20</vintage_date>
  <vintage_date>1982-02-22</vintage_date>
  <vintage_date>1982-03-19</vintage_date>
  <vintage_date>1982-07-21</vintage_date>
  <vintage_date>1983-01-19</vintage_date>
  <vintage_date>1983-02-22</vintage_date>
  <vintage_date>1983-03-21</vintage_date>
  <vintage_date>1983-07-21</vintage_date>
  <vintage_date>1984-01-20</vintage_date>
  <vintage_date>1984-02-17</vintage_date>
  <vintage_date>1984-03-20</vintage_date>
  <vintage_date>1984-07-23</vintage_date>
  <vintage_date>1985-01-22</vintage_date>
  <vintage_date>1985-02-21</vintage_date>
  <vintage_date>1985-03-21</vintage_date>
  <vintage_date>1985-12-20</vintage_date>
  <vintage_date>1986-01-22</vintage_date>
  <vintage_date>1986-02-20</vintage_date>
  <vintage_date>1986-03-19</vintage_date>
  <vintage_date>1986-07-22</vintage_date>
  <vintage_date>1987-01-22</vintage_date>
  <vintage_date>1987-02-19</vintage_date>
  <vintage_date>1987-03-18</vintage_date>
  <vintage_date>1987-07-24</vintage_date>
  <vintage_date>1988-01-27</vintage_date>
  <vintage_date>1988-02-25</vintage_date>
  <vintage_date>1988-03-23</vintage_date>
  <vintage_date>1988-07-27</vintage_date>
  <vintage_date>1989-01-27</vintage_date>
  <vintage_date>1989-02-28</vintage_date>
  <vintage_date>1989-03-23</vintage_date>
  <vintage_date>1989-07-27</vintage_date>
  <vintage_date>1990-01-26</vintage_date>
  <vintage_date>1990-02-28</vintage_date>
  <vintage_date>1990-03-28</vintage_date>
  <vintage_date>1990-07-27</vintage_date>
  <vintage_date>1991-01-25</vintage_date>
  <vintage_date>1991-02-27</vintage_date>
  <vintage_date>1991-03-27</vintage_date>
  <vintage_date>1991-12-04</vintage_date>
  <vintage_date>1992-02-28</vintage_date>
  <vintage_date>1992-03-26</vintage_date>
  <vintage_date>1992-04-28</vintage_date>
  <vintage_date>1992-07-30</vintage_date>
  <vintage_date>1992-09-24</vintage_date>
  <vintage_date>1992-12-22</vintage_date>
  <vintage_date>1993-03-26</vintage_date>
  <vintage_date>1993-08-31</vintage_date>
  <vintage_date>1994-03-31</vintage_date>
  <vintage_date>1994-07-29</vintage_date>
  <vintage_date>1995-03-31</vintage_date>
  <vintage_date>1996-01-19</vintage_date>
  <vintage_date>1996-04-02</vintage_date>
  <vintage_date>1996-08-01</vintage_date>
  <vintage_date>1997-03-28</vintage_date>
  <vintage_date>1997-04-30</vintage_date>
  <vintage_date>1997-07-31</vintage_date>
  <vintage_date>1998-03-26</vintage_date>
  <vintage_date>1998-07-31</vintage_date>
  <vintage_date>1999-03-31</vintage_date>
  <vintage_date>1999-10-29</vintage_date>
  <vintage_date>2000-03-30</vintage_date>
  <vintage_date>2000-04-03</vintage_date>
  <vintage_date>2000-04-27</vintage_date>
  <vintage_date>2000-07-28</vintage_date>
  <vintage_date>2001-03-29</vintage_date>
  <vintage_date>2001-07-27</vintage_date>
  <vintage_date>2002-03-28</vintage_date>
  <vintage_date>2002-07-31</vintage_date>
  <vintage_date>2003-03-27</vintage_date>
  <vintage_date>2003-12-23</vintage_date>
  <vintage_date>2004-01-30</vintage_date>
  <vintage_date>2004-03-25</vintage_date>
  <vintage_date>2004-07-30</vintage_date>
  <vintage_date>2005-03-30</vintage_date>
  <vintage_date>2005-07-29</vintage_date>
  <vintage_date>2006-03-30</vintage_date>
  <vintage_date>2006-07-28</vintage_date>
  <vintage_date>2007-03-29</vintage_date>
  <vintage_date>2007-07-27</vintage_date>
  <vintage_date>2008-03-27</vintage_date>
</vintage_dates>

Parameters

api_key

Read API Keys for more information.

series_id

The id for a series.

realtime_start

The start of the real-time period. For more information, see Real-Time Periods.

realtime_end

The end of the real-time period. For more information, see Real-Time Periods.

limit

The maximum number of results to return.

offset

sort_order

Sort results is ascending or descending vintage_date order.