Our website will undergo scheduled maintenance on Sunday, December 17. During this time, connection to our website and some of its features may be unavailable. Thank you for your patience and we apologize for any inconvenience.
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