Federal Reserve Economic Data
Maps API - Series Data
Description
This request returns a cross section of regional data for a specified release date. If no date is specified, the most recent data available are returned.
Parameters
Examples
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.
XML
Request (HTTPS GET)
https://api.stlouisfed.org/geofred/series/data?series_id=WIPCPI&api_key=abcdefghijklmnopqrstuvwxyz123456&date=2012-01-01
Response
<?xml version="1.0" encoding="utf-8" ?>
<series_data title="2012 Per Capita Personal Income by State (Dollars)" region="state" seasonality="Not Seasonally Adjusted" units="Dollars" frequency="Annual">
<observation date="2012-01-01" region="Delaware" code="10" value="44070" series_id="DEPCPI"/>
<observation date="2012-01-01" region="Pennsylvania" code="42" value="45855" series_id="PAPCPI"/>
<observation date="2012-01-01" region="Washington" code="53" value="47320" series_id="WAPCPI"/>
<observation date="2012-01-01" region="North Dakota" code="38" value="56443" series_id="NDPCPI"/>
<observation date="2012-01-01" region="Illinois" code="17" value="46029" series_id="ILPCPI"/>
<observation date="2012-01-01" region="North Carolina" code="37" value="39103" series_id="NCPCPI"/>
<observation date="2012-01-01" region="Georgia" code="13" value="37495" series_id="GAPCPI"/>
<observation date="2012-01-01" region="Wyoming" code="56" value="54213" series_id="WYPCPI"/>
<observation date="2012-01-01" region="South Carolina" code="45" value="35989" series_id="SCPCPI"/>
<observation date="2012-01-01" region="Connecticut" code="09" value="64121" series_id="CTPCPI"/>
<observation date="2012-01-01" region="Nebraska" code="31" value="46670" series_id="NEPCPI"/>
<observation date="2012-01-01" region="District of Columbia" code="11" value="68148" series_id="DCPCPI"/>
<observation date="2012-01-01" region="Mississippi" code="28" value="33657" series_id="MSPCPI"/>
<observation date="2012-01-01" region="New York" code="36" value="53102" series_id="NYPCPI"/>
<observation date="2012-01-01" region="California" code="06" value="48121" series_id="CAPCPI"/>
<observation date="2012-01-01" region="Wisconsin" code="55" value="42944" series_id="WIPCPI"/>
<observation date="2012-01-01" region="Oklahoma" code="40" value="42232" series_id="OKPCPI"/>
<observation date="2012-01-01" region="Rhode Island" code="44" value="45601" series_id="RIPCPI"/>
<observation date="2012-01-01" region="Arkansas" code="05" value="36582" series_id="ARPCPI"/>
<observation date="2012-01-01" region="Texas" code="48" value="44241" series_id="TXPCPI"/>
<observation date="2012-01-01" region="Missouri" code="29" value="40317" series_id="MOPCPI"/>
<observation date="2012-01-01" region="Louisiana" code="22" value="41003" series_id="LAPCPI"/>
<observation date="2012-01-01" region="Massachusetts" code="25" value="56669" series_id="MAPCPI"/>
<observation date="2012-01-01" region="Indiana" code="18" value="39433" series_id="INPCPI"/>
<observation date="2012-01-01" region="Maine" code="23" value="40411" series_id="MEPCPI"/>
<observation date="2012-01-01" region="Virginia" code="51" value="49309" series_id="VAPCPI"/>
<observation date="2012-01-01" region="Florida" code="12" value="41540" series_id="FLPCPI"/>
<observation date="2012-01-01" region="Alaska" code="02" value="53708" series_id="AKPCPI"/>
<observation date="2012-01-01" region="Iowa" code="19" value="42873" series_id="IAPCPI"/>
<observation date="2012-01-01" region="Ohio" code="39" value="40759" series_id="OHPCPI"/>
<observation date="2012-01-01" region="New Jersey" code="34" value="54574" series_id="NJPCPI"/>
<observation date="2012-01-01" region="New Mexico" code="35" value="35749" series_id="NMPCPI"/>
<observation date="2012-01-01" region="Oregon" code="41" value="39371" series_id="ORPCPI"/>
<observation date="2012-01-01" region="West Virginia" code="54" value="35453" series_id="WVPCPI"/>
<observation date="2012-01-01" region="Kentucky" code="21" value="35875" series_id="KYPCPI"/>
<observation date="2012-01-01" region="Tennessee" code="47" value="39373" series_id="TNPCPI"/>
<observation date="2012-01-01" region="Arizona" code="04" value="36545" series_id="AZPCPI"/>
<observation date="2012-01-01" region="Hawaii" code="15" value="43812" series_id="HIPCPI"/>
<observation date="2012-01-01" region="Vermont" code="50" value="45277" series_id="VTPCPI"/>
<observation date="2012-01-01" region="Kansas" code="20" value="45294" series_id="KSPCPI"/>
<observation date="2012-01-01" region="New Hampshire" code="33" value="51123" series_id="NHPCPI"/>
<observation date="2012-01-01" region="Idaho" code="16" value="35110" series_id="IDPCPI"/>
<observation date="2012-01-01" region="Maryland" code="24" value="52787" series_id="MDPCPI"/>
<observation date="2012-01-01" region="Michigan" code="26" value="39266" series_id="MIPCPI"/>
<observation date="2012-01-01" region="Nevada" code="32" value="39909" series_id="NVPCPI"/>
<observation date="2012-01-01" region="Montana" code="30" value="40701" series_id="MTPCPI"/>
<observation date="2012-01-01" region="Minnesota" code="27" value="47726" series_id="MNPCPI"/>
<observation date="2012-01-01" region="South Dakota" code="46" value="45442" series_id="SDPCPI"/>
<observation date="2012-01-01" region="Colorado" code="08" value="45630" series_id="COPCPI"/>
<observation date="2012-01-01" region="Alabama" code="01" value="35824" series_id="ALPCPI"/>
<observation date="2012-01-01" region="Utah" code="49" value="36005" series_id="UTPCPI"/>
</series_data>
JSON
Request (HTTPS GET)
https://api.stlouisfed.org/geofred/series/data?series_id=WIPCPI&api_key=abcdefghijklmnopqrstuvwxyz123456&file_type=json&date=2012-01-01
Response
{
"meta": {
"title": "2012 Per Capita Personal Income by State (Dollars)",
"region": "state",
"seasonality": "Not Seasonally Adjusted",
"units": "Dollars",
"frequency": "Annual",
"date": "2012-01-01",
"data": [{
"region": "Alabama",
"code": "01",
"value": "35942",
"series_id": "ALPCPI"
}, {
"region": "Alaska",
"code": "02",
"value": "49906",
"series_id": "AKPCPI"
}, {
"region": "Arizona",
"code": "04",
"value": "36624",
"series_id": "AZPCPI"
}, {
"region": "Arkansas",
"code": "05",
"value": "36423",
"series_id": "ARPCPI"
}, {
"region": "California",
"code": "06",
"value": "47505",
"series_id": "CAPCPI"
}, {
"region": "Colorado",
"code": "08",
"value": "46315",
"series_id": "COPCPI"
}, {
"region": "Connecticut",
"code": "09",
"value": "60223",
"series_id": "CTPCPI"
}, {
"region": "Delaware",
"code": "10",
"value": "44031",
"series_id": "DEPCPI"
}, {
"region": "District of Columbia",
"code": "11",
"value": "75950",
"series_id": "DCPCPI"
}, {
"region": "Florida",
"code": "12",
"value": "41041",
"series_id": "FLPCPI"
}, {
"region": "Georgia",
"code": "13",
"value": "37229",
"series_id": "GAPCPI"
}, {
"region": "Hawaii",
"code": "15",
"value": "44578",
"series_id": "HIPCPI"
}, {
"region": "Idaho",
"code": "16",
"value": "35142",
"series_id": "IDPCPI"
}, {
"region": "Illinois",
"code": "17",
"value": "46009",
"series_id": "ILPCPI"
}, {
"region": "Indiana",
"code": "18",
"value": "38136",
"series_id": "INPCPI"
}, {
"region": "Iowa",
"code": "19",
"value": "44014",
"series_id": "IAPCPI"
}, {
"region": "Kansas",
"code": "20",
"value": "43380",
"series_id": "KSPCPI"
}, {
"region": "Kentucky",
"code": "21",
"value": "35857",
"series_id": "KYPCPI"
}, {
"region": "Louisiana",
"code": "22",
"value": "40617",
"series_id": "LAPCPI"
}, {
"region": "Maine",
"code": "23",
"value": "39863",
"series_id": "MEPCPI"
}, {
"region": "Maryland",
"code": "24",
"value": "53659",
"series_id": "MDPCPI"
}, {
"region": "Massachusetts",
"code": "25",
"value": "56713",
"series_id": "MAPCPI"
}, {
"region": "Michigan",
"code": "26",
"value": "38585",
"series_id": "MIPCPI"
}, {
"region": "Minnesota",
"code": "27",
"value": "47377",
"series_id": "MNPCPI"
}, {
"region": "Mississippi",
"code": "28",
"value": "33446",
"series_id": "MSPCPI"
}, {
"region": "Missouri",
"code": "29",
"value": "39933",
"series_id": "MOPCPI"
}, {
"region": "Montana",
"code": "30",
"value": "39142",
"series_id": "MTPCPI"
}, {
"region": "Nebraska",
"code": "31",
"value": "45914",
"series_id": "NEPCPI"
}, {
"region": "Nevada",
"code": "32",
"value": "39229",
"series_id": "NVPCPI"
}, {
"region": "New Hampshire",
"code": "33",
"value": "50056",
"series_id": "NHPCPI"
}, {
"region": "New Jersey",
"code": "34",
"value": "54932",
"series_id": "NJPCPI"
}, {
"region": "New Mexico",
"code": "35",
"value": "35805",
"series_id": "NMPCPI"
}, {
"region": "New York",
"code": "36",
"value": "54099",
"series_id": "NYPCPI"
}, {
"region": "North Carolina",
"code": "37",
"value": "38538",
"series_id": "NCPCPI"
}, {
"region": "North Dakota",
"code": "38",
"value": "56310",
"series_id": "NDPCPI"
}, {
"region": "Ohio",
"code": "39",
"value": "40230",
"series_id": "OHPCPI"
}, {
"region": "Oklahoma",
"code": "40",
"value": "41399",
"series_id": "OKPCPI"
}, {
"region": "Oregon",
"code": "41",
"value": "39258",
"series_id": "ORPCPI"
}, {
"region": "Pennsylvania",
"code": "42",
"value": "45577",
"series_id": "PAPCPI"
}, {
"region": "Rhode Island",
"code": "44",
"value": "46257",
"series_id": "RIPCPI"
}, {
"region": "South Carolina",
"code": "45",
"value": "35347",
"series_id": "SCPCPI"
}, {
"region": "South Dakota",
"code": "46",
"value": "45676",
"series_id": "SDPCPI"
}, {
"region": "Tennessee",
"code": "47",
"value": "39002",
"series_id": "TNPCPI"
}, {
"region": "Texas",
"code": "48",
"value": "43271",
"series_id": "TXPCPI"
}, {
"region": "Utah",
"code": "49",
"value": "35891",
"series_id": "UTPCPI"
}, {
"region": "Vermont",
"code": "50",
"value": "44443",
"series_id": "VTPCPI"
}, {
"region": "Virginia",
"code": "51",
"value": "48715",
"series_id": "VAPCPI"
}, {
"region": "Washington",
"code": "53",
"value": "47055",
"series_id": "WAPCPI"
}, {
"region": "West Virginia",
"code": "54",
"value": "35140",
"series_id": "WVPCPI"
}, {
"region": "Wisconsin",
"code": "55",
"value": "42475",
"series_id": "WIPCPI"
}, {
"region": "Wyoming",
"code": "56",
"value": "52469",
"series_id": "WYPCPI"
}]
}
}
Parameters
api_key
Read API Keys for more information.
- 32 character alpha-numeric lowercase string, required
file_type
A key or file extension that indicates the type of file to send.
- One of the following values: 'xml', 'json'
xml = Extensible Markup Language. The HTTP Content-Type is text/xml (xml is not available for county data).
json = JavaScript Object Notation. The HTTP Content-Type is application/json.
series_id
The FRED series_id you want to request maps data for. Not all series that are in FRED have geographical data.
- string, required
date
The date you want to request series group data from.
- YYYY-MM-DD formatted string, optional
start_date
The start date you want to request series group data from. This allows you to pull a range of data
- YYYY-MM-DD formatted string, optional
