Data Download Program - Help
How to use the Federal Reserve Board's Data Download Program
Getting Started
The Data Download Program is designed to allow flexible access to data produced by the Federal Reserve Board.  Data associated with the several statistical releases listed are currently available.  Data from other releases will be added in the future. 

There are a few things you should know about the application before proceeding.

  • Designed for customized data downloads
    The application was not designed for large data transfers.  Downloading a large number of series may affect performance.

  • One frequency per download
    To ensure quick downloads and usable output formats, the application will only allow users to download data of a single frequency (daily, monthly, quarterly, etc.) in a single output file.

  • Data are only available as currently published 
    There are no reporting, graphing, or analytical tools available in the application.  All data are reported as currently defined.  Pre-revision or real time data are not available.

  • Large files may cause problems for Excel 
    Excel has a limit of 256 columns.  If a file downloaded in either the Excel 2003 or CSV (comma-serparated values) file type exceeds 256 columns, it may not open correctly in Excel..

  • Package creation may take time 
    The application may require several minutes to create custom data packages.  In general, the more data you request, the longer it will take the application to create your package.

  • Accessibility
    The application is designed to be compatible with screen readers and includes navigation that does not require the use of a mouse or monitor.

Information about specific steps of the download process is available throughout the application in the "Learn More" sections. 

Back to help menu

Build your data package by selecting your data, choosing its format and date range, and downloading the file. To begin this process press the "Go to select" button.

Image of the build your package section of the choose page  

Learn more     Back to help menu

OR

Select a preformatted data package by selecting a package from the list provided and then pressing the "Go to download" button.

Image of the select a preformatted data package section of the choose page with radio buttons

Image of the select a preformatted data package section of the choose page with a list box

To see a list of the data series in the package, press the "Review package" button from the Download screen.

Image of the data package information box on the download page

Note: You cannot edit the contents of a preformatted data package.

Press the "Download file" button to retrieve your data file.

Image of the download file button on the download page

OR

Download all the data associated with a particular statistical release in a single XML file that has been formatted according to the SDMX data standard.  Click on the "Download all ..." link to access a "zipped" or compressed file that contains the data in XML format and supporting files for processing the data. If you do not have a utility to open a "zipped" file, a link to the free PKWare software is provided.

Learn more     Back to help menu

Building a data package
Press the "Go to select " button from the Choose screen.

Image of the build your package section of the choose page

  • Select an option in each of the numbered boxes.
  • Press the control key on your keyboard to select more than one entry in the box.
  • Press the "Continue" button to move to the next box.

    Note: You will not be able to move to the next box without pressing the "Continue" button.

  • The number of boxes will change based on your selections.
  • The green arrow on the left side of your screen shows you the current box to review.

    Image of a selection box on the select page

Once you have made all of your selections, press the "Add to package" button.

Image of a selection box on the select page with the add to package button

Learn more     Back to help menu

Once you have followed the instructions for building your package, you may add additional data series by pressing the "Select More" button from the Review screen.

Image of the select more and go to format buttons on the review page

A box will now appear on the right side of the screen. This box displays the number of data series currently in your package and the frequency of those data series.  You can remove and review the contents of your data package.

Note: When selecting additional data series, you are limited to selecting series that have the same frequency as the data that are already in your package.

Image of the data package information box with a clear package button and a review package button

Learn more     Back to help menu

Reviewing and editing the contents of a data package
To review the contents of a data package press the "Add to package" button from the select screen

Image of a selection box on the select page with the add to package button

OR

press the "Review Package" button from the Format or Download screens.

Image of the data package information box on the download page

Learn more     Back to help menu

To preview the last twenty entries in the data series click on the links that appear in the Series column.

Image of the table list of data series in your package

A small window will open with a table of the last 20 observations of the data series you have selected.

Image of a data series preview

Learn more     Back to help menu

To add additional data series to your package see "Adding to a package".

To remove a data series from your package from the Review screen, uncheck the box in the include column and press the "Refresh package" button.

Image of the table list of data series in your package focused on the include column

Once you have completed editing your package, the message above the review table will tell you how many series you have in your package and you will be able to continue to the Format screen.

Image of the package information box with no buttons

Press the "Go to format" button to continue to download.

Image of the select more and go to format buttons on the review page

Learn more     Back to help menu

Formatting a data package
Select either the number of observations or a date range.

Image of the select a date range or number of observations section of the format page

Learn more     Back to help menu

You have three file type options for your data package:

  • CSV (comma-separated values)
    Files of this type contain tabular data separated by commas with strings enclosed in double quotes (").

  • Excel (Excel 2003)
    Excel requires that you have Excel 2003 or newer.  Older versions of Excel will be compatible with CSV. 
    Note: For more information and potential limitations of Excel format please select working with Excel

  • XML (SDMX)
    Files of this type contain data conforming to the Statistical Data and Metadata eXchange (SDMX ) data standard and use the compact schema representation.  Supporting schema and structure files are available on the Download screen when this file type is selected. 

    Image of the file type section of the format page

Learn more     Back to help menu

You may choose to include or omit data labels in your final data package.  Data labels provide a description of the series and information about the units and currency (if applicable) of the series.  The labels also include the unit multiplier for the series, which shows the scale of the observations.   

Learn more     Back to help menu

There are three options for the layout of a data package:

  • Series in Columns
    The name of the data series is across the top of the file and the dates are shown down the first column.

  • Series in Rows
    The dates are across the top and the names of the data series are shown down the first column.

  • Series as Lists
    Each data series is given as date/observation pairs laid out one after another.

When formatting is complete press the "Go to download" button

Image of the go to download button on the format page

Learn more     Back to help menu

Retrieving your data package
The File Summary section of the Download screen shows the contents of your data package.

Image of the file summary section of the format page

To preview the final data package click the "preview sample" link. A small window will open with a preview of your package.
Note: The preview will only show up to the first 13 observations.  The data series will appear in rows regardless of the layout you have chosen.

Image of a preview sample

To reformat the data package, press the "Change format" button.

Image of the file summary section on the download page

Learn more     Back to help menu

Press the "Download file" button to receive your requested data package.

Image of the download button on the download page

Learn more     Back to help menu

If you have chosen XML as your file type, an area titled "XML information" will be available at the bottom of the Download screen.

Image of the xml information section on the download page

The links to files listed in this section provide the data structure definitions and other structural information needed for validating the XML files according to the SDMX data standard.

The files provided include:

  • A single FRB common schema file which outlines data information common to all Federal Reserve Board data available through the Data Download Program.
  • A structure file associated with a particular release which describes the organization of the data for that release.
  • One or more schema files describing the organization for each data set from which you have chosen data.

The remaining links take you to SDMX related information on the SDMX website. More information on SDMX specifications and how to use the schema and structure files is available from the SDMX website.

Learn more     Back to help menu

If you have formatted your package by number of observations or if you are downloading a preformatted package, you can return to this page to retrieve the most recent data as it becomes available. Use the menu options in your browser to bookmark the page. Packages formatted by dates will only show data for those dates.

Image of the bookmark this section on the download page

Learn more     Back to help menu

The "Direct download for automated systems" link on the page is the URL that can be used by computer programs to retrieve the contents of the data package without actually using a browsing window.  It performs the same function as clicking the "Download file" button but is presented as a URL for those who wish to automate the retrieval of data.

Image of the direct download for automated systems link

Learn more     Back to help menu