fred/release/series

Description
Example
- Request
- Response
Parameters
- api_key
- release_id
- realtime_start
- realtime_end
- limit
- offset
- order_by
- sort_order
- filter_variable
- filter_value

Description

Get the series on a release of economic data.

Request (HTTP GET)

http://api.stlouisfed.org/fred/release/series?release_id=51&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" ?>
<seriess realtime_start="2008-07-28" realtime_end="2008-07-28" order_by="series_id" sort_order="asc" count="21" offset="0" limit="1000">
  <series id="BOPGEXP" realtime_start="2008-07-28" realtime_end="2008-07-28" title="Exports of Goods, Balance of Payments Basis" observation_start="1992-01-01" observation_end="2008-02-01" frequency="Monthly" frequency_short="M" units="Millions of Dollars" units_short="Mil. of $" seasonal_adjustment="Seasonally Adjusted" seasonal_adjustment_short="SA" last_updated="2008-04-10 11:47:57-05"/>
  <series id="BOPGIMP" realtime_start="2008-07-28" realtime_end="2008-07-28" title="Imports of Goods: Balance of Payments Basis" observation_start="1992-01-01" observation_end="2008-02-01" frequency="Monthly" frequency_short="M" units="Millions of Dollars" units_short="Mil. of $" seasonal_adjustment="Seasonally Adjusted" seasonal_adjustment_short="SA" last_updated="2008-04-10 11:46:48-05"/>
  <series id="BOPGSTB" realtime_start="2008-07-28" realtime_end="2008-07-28" title="Trade Balance: Goods and Services, Balance of Payments Basis" observation_start="1992-01-01" observation_end="2008-02-01" frequency="Monthly" frequency_short="M" units="Millions of Dollars" units_short="Mil. of $" seasonal_adjustment="Seasonally Adjusted" seasonal_adjustment_short="SA" last_updated="2008-04-10 11:47:54-05"/>
  <series id="BOPGTB" realtime_start="2008-07-28" realtime_end="2008-07-28" title="Trade Balance: Goods, Balance of Payments Basis" observation_start="1992-01-01" observation_end="2008-02-01" frequency="Monthly" frequency_short="M" units="Millions of Dollars" units_short="Mil. of $" seasonal_adjustment="Seasonally Adjusted" seasonal_adjustment_short="SA" last_updated="2008-04-10 11:50:40-05"/>
  <series id="BOPSEXP" realtime_start="2008-07-28" realtime_end="2008-07-28" title="Exports of Services, Balance of Payments Basis" observation_start="1992-01-01" observation_end="2008-02-01" frequency="Monthly" frequency_short="M" units="Millions of Dollars" units_short="Mil. of $" seasonal_adjustment="Seasonally Adjusted" seasonal_adjustment_short="SA" last_updated="2008-04-10 11:47:55-05"/>
  <series id="BOPSIMP" realtime_start="2008-07-28" realtime_end="2008-07-28" title="Imports of Services, Balance of Payments Basis" observation_start="1992-01-01" observation_end="2008-02-01" frequency="Monthly" frequency_short="M" units="Millions of Dollars" units_short="Mil. of $" seasonal_adjustment="Seasonally Adjusted" seasonal_adjustment_short="SA" last_updated="2008-04-10 11:49:13-05"/>
  <series id="BOPSTB" realtime_start="2008-07-28" realtime_end="2008-07-28" title="Trade Balance: Services, Balance of Payments Basis" observation_start="1992-01-01" observation_end="2008-02-01" frequency="Monthly" frequency_short="M" units="Millions of Dollars" units_short="Mil. of $" seasonal_adjustment="Seasonally Adjusted" seasonal_adjustment_short="SA" last_updated="2008-04-10 11:47:58-05"/>
  <series id="EXPCA" realtime_start="2008-07-28" realtime_end="2008-07-28" title="U.S. Exports to Canada, f.a.s. basis" observation_start="1974-01-01" observation_end="2008-02-01" frequency="Monthly" frequency_short="M" units="Millions of Dollars" units_short="Mil. of $" seasonal_adjustment="Not Seasonally Adjusted" seasonal_adjustment_short="NSA" last_updated="2008-04-10 11:47:13-05" notes="Free Alongside Ship Basis (f.a.s.)"/>
  <series id="EXPCH" realtime_start="2008-07-28" realtime_end="2008-07-28" title="U.S. Exports to China, Mainland, f.a.s. basis" observation_start="1974-01-01" observation_end="2008-02-01" frequency="Monthly" frequency_short="M" units="Millions of Dollars" units_short="Mil. of $" seasonal_adjustment="Not Seasonally Adjusted" seasonal_adjustment_short="NSA" last_updated="2008-04-10 11:46:01-05" notes="Free Alongside Ship Basis (f.a.s.)"/>
  <series id="EXPFR" realtime_start="2008-07-28" realtime_end="2008-07-28" title="U.S. Exports to France, f.a.s. basis" observation_start="1974-01-01" observation_end="2008-02-01" frequency="Monthly" frequency_short="M" units="Millions of Dollars" units_short="Mil. of $" seasonal_adjustment="Not Seasonally Adjusted" seasonal_adjustment_short="NSA" last_updated="2008-04-10 11:46:31-05" notes="Free Alongside Ship Basis (f.a.s.)"/>
  <series id="EXPGE" realtime_start="2008-07-28" realtime_end="2008-07-28" title="U.S. Exports to Germany, f.a.s. basis" observation_start="1974-01-01" observation_end="2008-02-01" frequency="Monthly" frequency_short="M" units="Millions of Dollars" units_short="Mil. of $" seasonal_adjustment="Not Seasonally Adjusted" seasonal_adjustment_short="NSA" last_updated="2008-04-10 11:46:47-05" notes="Free Alongside Ship Basis (f.a.s.)"/>
  <series id="EXPJP" realtime_start="2008-07-28" realtime_end="2008-07-28" title="U.S. Exports to Japan, f.a.s. basis" observation_start="1974-01-01" observation_end="2008-02-01" frequency="Monthly" frequency_short="M" units="Millions of Dollars" units_short="Mil. of $" seasonal_adjustment="Not Seasonally Adjusted" seasonal_adjustment_short="NSA" last_updated="2008-04-10 11:46:32-05" notes="Free Alongside Ship Basis (f.a.s.)"/>
  <series id="EXPMX" realtime_start="2008-07-28" realtime_end="2008-07-28" title="U.S. Exports to Mexico, f.a.s. basis" observation_start="1974-01-01" observation_end="2008-02-01" frequency="Monthly" frequency_short="M" units="Millions of Dollars" units_short="Mil. of $" seasonal_adjustment="Not Seasonally Adjusted" seasonal_adjustment_short="NSA" last_updated="2008-04-10 11:48:41-05" notes="Free Alongside Ship Basis (f.a.s.)"/>
  <series id="EXPUK" realtime_start="2008-07-28" realtime_end="2008-07-28" title="U.S. Exports to the United Kingdom, f.a.s. basis" observation_start="1974-01-01" observation_end="2008-02-01" frequency="Monthly" frequency_short="M" units="Millions of Dollars" units_short="Mil. of $" seasonal_adjustment="Not Seasonally Adjusted" seasonal_adjustment_short="NSA" last_updated="2008-04-10 11:46:48-05" notes="Free Alongside Ship Basis (f.a.s.)"/>
  <series id="IMPCA" realtime_start="2008-07-28" realtime_end="2008-07-28" title="U.S. Imports from Canada, Customs Basis" observation_start="1974-01-01" observation_end="2008-02-01" frequency="Monthly" frequency_short="M" units="Millions of Dollars" units_short="Mil. of $" seasonal_adjustment="Not Seasonally Adjusted" seasonal_adjustment_short="NSA" last_updated="2008-04-10 11:46:33-05"/>
  <series id="IMPCH" realtime_start="2008-07-28" realtime_end="2008-07-28" title="U.S. Imports from China, Mainland, Customs Basis" observation_start="1974-01-01" observation_end="2008-02-01" frequency="Monthly" frequency_short="M" units="Millions of Dollars" units_short="Mil. of $" seasonal_adjustment="Not Seasonally Adjusted" seasonal_adjustment_short="NSA" last_updated="2008-04-10 11:49:26-05"/>
  <series id="IMPFR" realtime_start="2008-07-28" realtime_end="2008-07-28" title="U.S. Imports from France, Customs Basis" observation_start="1974-01-01" observation_end="2008-02-01" frequency="Monthly" frequency_short="M" units="Millions of Dollars" units_short="Mil. of $" seasonal_adjustment="Not Seasonally Adjusted" seasonal_adjustment_short="NSA" last_updated="2008-04-10 11:47:17-05"/>
  <series id="IMPGE" realtime_start="2008-07-28" realtime_end="2008-07-28" title="U.S. Imports from Germany, Customs Basis" observation_start="1974-01-01" observation_end="2008-02-01" frequency="Monthly" frequency_short="M" units="Millions of Dollars" units_short="Mil. of $" seasonal_adjustment="Not Seasonally Adjusted" seasonal_adjustment_short="NSA" last_updated="2008-04-10 11:48:58-05"/>
  <series id="IMPJP" realtime_start="2008-07-28" realtime_end="2008-07-28" title="U.S. Imports from Japan, Customs Basis" observation_start="1974-01-01" observation_end="2008-02-01" frequency="Monthly" frequency_short="M" units="Millions of Dollars" units_short="Mil. of $" seasonal_adjustment="Not Seasonally Adjusted" seasonal_adjustment_short="NSA" last_updated="2008-04-10 11:47:09-05"/>
  <series id="IMPMX" realtime_start="2008-07-28" realtime_end="2008-07-28" title="U.S. Imports from Mexico, Customs Basis" observation_start="1974-01-01" observation_end="2008-02-01" frequency="Monthly" frequency_short="M" units="Millions of Dollars" units_short="Mil. of $" seasonal_adjustment="Not Seasonally Adjusted" seasonal_adjustment_short="NSA" last_updated="2008-04-10 11:47:53-05"/>
  <series id="IMPUK" realtime_start="2008-07-28" realtime_end="2008-07-28" title="U.S. Imports from the United Kingdom, Customs Basis" observation_start="1974-01-01" observation_end="2008-02-01" frequency="Monthly" frequency_short="M" units="Millions of Dollars" units_short="Mil. of $" seasonal_adjustment="Not Seasonally Adjusted" seasonal_adjustment_short="NSA" last_updated="2008-04-10 11:47:56-05"/>
</seriess>

The series tag's notes attribute is optional.

Parameters

api_key

Read API Keys for more information.

32 character alpha-numeric lowercase string, required

release_id

The id for a release.

integer, required

realtime_start

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

YYYY-MM-DD formatted string, optional, default: today's date

realtime_end

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

YYYY-MM-DD formatted string, optional, default: today's date

limit

The maximum number of results to return.

integer between 1 and 1000, optional, default: 1000

offset

non-negative integer, optional, default: 0

order_by

Order results by values of the specified attribute.

One of the following strings: 'series_id', 'title', 'units', 'frequency', 'seasonal_adjustment', 'realtime_start', 'realtime_end', 'last_updated', 'observation_start', 'observation_end'.
optional, default: series_id

sort_order

Sort results is ascending or descending order for attribute values specified by order_by.

One of the following strings: 'asc', 'desc'.
optional, default: asc

filter_variable

The attribute to filter results by.

One of the following strings: 'frequency', 'units', 'seasonal_adjustment'.
optional, no filter by default

filter_value

The value of the filter_variable attribute to filter results by.

String, optional, no filter by default