Skip to main content

GeoFRED® 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

Example

XML

Request (HTTPS GET)

https://api.stlouisfed.org/geofred/series/data?series_id=WIPCPI&api_key=abcdefghijklmnopqrstuvwxyz123456&date=2012-01-01

Response

<series_data title="Per Capita Personal Income by State (Dollars)" region="state" seasonality="Not Seasonally Adjusted" units="Dollars" frequency="Annual" date="2012-01-01">
                    <observation region="Alabama" code="01" value="35942" series_id="ALPCPI"/>
                    <observation region="Alaska" code="02" value="49906" series_id="AKPCPI"/>
                    <observation region="Arizona" code="04" value="36624" series_id="AZPCPI"/>
                    <observation region="Arkansas" code="05" value="36423" series_id="ARPCPI"/>
                    <observation region="California" code="06" value="47505" series_id="CAPCPI"/>
                    <observation region="Colorado" code="08" value="46315" series_id="COPCPI"/>
                    <observation region="Connecticut" code="09" value="60223" series_id="CTPCPI"/>
                    <observation region="Delaware" code="10" value="44031" series_id="DEPCPI"/>
                    <observation region="District of Columbia" code="11" value="75950" series_id="DCPCPI"/>
                    <observation region="Florida" code="12" value="41041" series_id="FLPCPI"/>
                    <observation region="Georgia" code="13" value="37229" series_id="GAPCPI"/>
                    <observation region="Hawaii" code="15" value="44578" series_id="HIPCPI"/>
                    <observation region="Idaho" code="16" value="35142" series_id="IDPCPI"/>
                    <observation region="Illinois" code="17" value="46009" series_id="ILPCPI"/>
                    <observation region="Indiana" code="18" value="38136" series_id="INPCPI"/>
                    <observation region="Iowa" code="19" value="44014" series_id="IAPCPI"/>
                    <observation region="Kansas" code="20" value="43380" series_id="KSPCPI"/>
                    <observation region="Kentucky" code="21" value="35857" series_id="KYPCPI"/>
                    <observation region="Louisiana" code="22" value="40617" series_id="LAPCPI"/>
                    <observation region="Maine" code="23" value="39863" series_id="MEPCPI"/>
                    <observation region="Maryland" code="24" value="53659" series_id="MDPCPI"/>
                    <observation region="Massachusetts" code="25" value="56713" series_id="MAPCPI"/>
                    <observation region="Michigan" code="26" value="38585" series_id="MIPCPI"/>
                    <observation region="Minnesota" code="27" value="47377" series_id="MNPCPI"/>
                    <observation region="Mississippi" code="28" value="33446" series_id="MSPCPI"/>
                    <observation region="Missouri" code="29" value="39933" series_id="MOPCPI"/>
                    <observation region="Montana" code="30" value="39142" series_id="MTPCPI"/>
                    <observation region="Nebraska" code="31" value="45914" series_id="NEPCPI"/>
                    <observation region="Nevada" code="32" value="39229" series_id="NVPCPI"/>
                    <observation region="New Hampshire" code="33" value="50056" series_id="NHPCPI"/>
                    <observation region="New Jersey" code="34" value="54932" series_id="NJPCPI"/>
                    <observation region="New Mexico" code="35" value="35805" series_id="NMPCPI"/>
                    <observation region="New York" code="36" value="54099" series_id="NYPCPI"/>
                    <observation region="North Carolina" code="37" value="38538" series_id="NCPCPI"/>
                    <observation region="North Dakota" code="38" value="56310" series_id="NDPCPI"/>
                    <observation region="Ohio" code="39" value="40230" series_id="OHPCPI"/>
                    <observation region="Oklahoma" code="40" value="41399" series_id="OKPCPI"/>
                    <observation region="Oregon" code="41" value="39258" series_id="ORPCPI"/>
                    <observation region="Pennsylvania" code="42" value="45577" series_id="PAPCPI"/>
                    <observation region="Rhode Island" code="44" value="46257" series_id="RIPCPI"/>
                    <observation region="South Carolina" code="45" value="35347" series_id="SCPCPI"/>
                    <observation region="South Dakota" code="46" value="45676" series_id="SDPCPI"/>
                    <observation region="Tennessee" code="47" value="39002" series_id="TNPCPI"/>
                    <observation region="Texas" code="48" value="43271" series_id="TXPCPI"/>
                    <observation region="Utah" code="49" value="35891" series_id="UTPCPI"/>
                    <observation region="Vermont" code="50" value="44443" series_id="VTPCPI"/>
                    <observation region="Virginia" code="51" value="48715" series_id="VAPCPI"/>
                    <observation region="Washington" code="53" value="47055" series_id="WAPCPI"/>
                    <observation region="West Virginia" code="54" value="35140" series_id="WVPCPI"/>
                    <observation region="Wisconsin" code="55" value="42475" series_id="WIPCPI"/>
                    <observation region="Wyoming" code="56" value="52469" series_id="WYPCPI"/>
                    </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": "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.

  • string, optional, default: xml
  • One of the following values: 'xml', 'json'

    xml = Extensible Markup Language. The HTTP Content-Type is text/xml.
    json = JavaScript Object Notation. The HTTP Content-Type is application/json.

series_id

The FRED series_id you want to request GeoFRED 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

Subscribe to our newsletter


Follow us

Twitter logo Google Plus logo Facebook logo YouTube logo LinkedIn logo
Back to Top