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 the series did not change.
This request can return either XML or JSON by setting the file_type parameter to xml or json. Note that the default value of file_type is xml. The API key 'abcdefghijklmnopqrstuvwxyz123456' is for demonstration purposes only. Use a registered API key instead.
https://api.stlouisfed.org/fred/series/vintagedates?series_id=GNPCA&api_key=abcdefghijklmnopqrstuvwxyz123456
<vintage_dates realtime_start="1776-07-04" realtime_end="9999-12-31" order_by="vintage_date" sort_order="asc" count="162" 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_date>2008-07-31</vintage_date>
<vintage_date>2009-03-26</vintage_date>
<vintage_date>2009-07-31</vintage_date>
<vintage_date>2009-08-17</vintage_date>
<vintage_date>2010-03-26</vintage_date>
<vintage_date>2010-07-30</vintage_date>
<vintage_date>2011-03-25</vintage_date>
<vintage_date>2011-07-29</vintage_date>
<vintage_date>2012-03-29</vintage_date>
<vintage_date>2012-07-27</vintage_date>
<vintage_date>2013-03-28</vintage_date>
<vintage_date>2013-07-31</vintage_date>
</vintage_dates>
https://api.stlouisfed.org/fred/series/vintagedates?series_id=GNPCA&api_key=abcdefghijklmnopqrstuvwxyz123456&file_type=json
{
"realtime_start": "1776-07-04",
"realtime_end": "9999-12-31",
"order_by": "vintage_date",
"sort_order": "asc",
"count": 162,
"offset": 0,
"limit": 10000,
"vintage_dates": [
"1958-12-21",
"1959-02-19",
"1959-07-19",
"1960-02-16",
"1960-07-22",
"1961-02-19",
"1961-07-19",
"1962-02-24",
"1962-07-20",
"1963-02-20",
"1963-07-22",
"1964-02-20",
"1964-07-16",
"1965-01-14",
"1965-02-17",
"1965-08-19",
"1966-01-13",
"1966-02-15",
"1966-07-15",
"1967-01-13",
"1967-02-17",
"1967-07-17",
"1968-01-16",
"1968-02-15",
"1968-07-18",
"1969-01-14",
"1969-02-14",
"1969-07-17",
"1970-01-16",
"1970-02-13",
"1970-07-17",
"1971-01-18",
"1971-02-12",
"1971-07-16",
"1972-01-21",
"1972-02-18",
"1972-07-21",
"1973-01-19",
"1973-02-20",
"1973-07-19",
"1974-01-17",
"1974-02-20",
"1974-07-18",
"1975-01-16",
"1975-03-20",
"1976-01-16",
"1976-01-20",
"1976-02-19",
"1976-03-19",
"1976-07-20",
"1977-01-18",
"1977-02-18",
"1977-03-21",
"1977-07-21",
"1978-01-19",
"1978-02-21",
"1978-03-20",
"1978-07-21",
"1979-01-18",
"1979-02-22",
"1979-03-20",
"1979-07-20",
"1980-01-18",
"1980-02-22",
"1980-03-19",
"1980-12-23",
"1981-01-21",
"1981-02-19",
"1981-03-18",
"1982-01-20",
"1982-02-22",
"1982-03-19",
"1982-07-21",
"1983-01-19",
"1983-02-22",
"1983-03-21",
"1983-07-21",
"1984-01-20",
"1984-02-17",
"1984-03-20",
"1984-07-23",
"1985-01-22",
"1985-02-21",
"1985-03-21",
"1985-12-20",
"1986-01-22",
"1986-02-20",
"1986-03-19",
"1986-07-22",
"1987-01-22",
"1987-02-19",
"1987-03-18",
"1987-07-24",
"1988-01-27",
"1988-02-25",
"1988-03-23",
"1988-07-27",
"1989-01-27",
"1989-02-28",
"1989-03-23",
"1989-07-27",
"1990-01-26",
"1990-02-28",
"1990-03-28",
"1990-07-27",
"1991-01-25",
"1991-02-27",
"1991-03-27",
"1991-12-04",
"1992-02-28",
"1992-03-26",
"1992-04-28",
"1992-07-30",
"1992-09-24",
"1992-12-22",
"1993-03-26",
"1993-08-31",
"1994-03-31",
"1994-07-29",
"1995-03-31",
"1996-01-19",
"1996-04-02",
"1996-08-01",
"1997-03-28",
"1997-04-30",
"1997-07-31",
"1998-03-26",
"1998-07-31",
"1999-03-31",
"1999-10-29",
"2000-03-30",
"2000-04-03",
"2000-04-27",
"2000-07-28",
"2001-03-29",
"2001-07-27",
"2002-03-28",
"2002-07-31",
"2003-03-27",
"2003-12-23",
"2004-01-30",
"2004-03-25",
"2004-07-30",
"2005-03-30",
"2005-07-29",
"2006-03-30",
"2006-07-28",
"2007-03-29",
"2007-07-27",
"2008-03-27",
"2008-07-31",
"2009-03-26",
"2009-07-31",
"2009-08-17",
"2010-03-26",
"2010-07-30",
"2011-03-25",
"2011-07-29",
"2012-03-29",
"2012-07-27",
"2013-03-28",
"2013-07-31"
]
}
Read API Keys for more information.
A key or file extension that indicates the type of file to send.
xml = Extensible Markup Language. The HTTP Content-Type is text/xml.
json = JavaScript Object Notation. The HTTP Content-Type is application/json.
The id for a series.
The start of the real-time period. For more information, see Real-Time Periods.
The end of the real-time period. For more information, see Real-Time Periods.
The maximum number of results to return.
Sort results is ascending or descending vintage_date order.