Documentation > Workflows & Code > Explore Metadata > NHGIS > Time Series Metadata

IPUMS NHGIS Time Series Metadata

An NHGIS time series table links together comparable statistics from multiple datasets into one table. An in-depth introduction and a full catalog of NHGIS time series tables are availble on the NHGIS website.

Below we provide examples in curl showing how to work with our API to access metadata about NHGIS time series tables.

If you are an R or Python user, please note that we also provide language-native client libraries to make it easier to work with the IPUMS API using those languages.

Get High-Level Metadata for Time Series Tables

This API call will return a list of all available time series tables. The entry for each time series table includes metadata for the table’s description, geographic levels, year availability, and geographic integration. The unique identifier for each time series table is in the name field. This is needed for retrieving details about a single time series table (see next section).

curl -X GET \
  "https://api.ipums.org/metadata/time_series_tables?collection=nhgis&version=2&pageSize=10" \
  -H "Authorization: $MY_KEY"
      
# Results

{
  "data": [
    {
      "name": "A00",
      "description": "Total Population",
      "geographicIntegration": "Nominal",
      "sequence": 100.01,
      "timeSeries": [
        {
          "name": "AA",
          "description": "Persons: Total",
          "sequence": 1
        }
      ],
      "years": [
        {
          "name": "1790",
          "description": "1790",
          "sequence": 1
        },
        {
          "name": "1800",
          "description": "1800",
          "sequence": 2
        },
        {
          "name": "1810",
          "description": "1810",
          "sequence": 3
        },
        {
          "name": "1820",
          "description": "1820",
          "sequence": 4
        },
        {
          "name": "1830",
          "description": "1830",
          "sequence": 5
        },
        {
          "name": "1840",
          "description": "1840",
          "sequence": 6
        },
        {
          "name": "1850",
          "description": "1850",
          "sequence": 7
        },
        {
          "name": "1860",
          "description": "1860",
          "sequence": 8
        },
        {
          "name": "1870",
          "description": "1870",
          "sequence": 12
        },
        {
          "name": "1880",
          "description": "1880",
          "sequence": 22
        },
        {
          "name": "1890",
          "description": "1890",
          "sequence": 29
        },
        {
          "name": "1900",
          "description": "1900",
          "sequence": 30
        },
        {
          "name": "1910",
          "description": "1910",
          "sequence": 32
        },
        {
          "name": "1920",
          "description": "1920",
          "sequence": 38
        },
        {
          "name": "1930",
          "description": "1930",
          "sequence": 48
        },
        {
          "name": "1940",
          "description": "1940",
          "sequence": 58
        },
        {
          "name": "1950",
          "description": "1950",
          "sequence": 68
        },
        {
          "name": "1960",
          "description": "1960",
          "sequence": 78
        },
        {
          "name": "1970",
          "description": "1970",
          "sequence": 88
        },
        {
          "name": "1980",
          "description": "1980",
          "sequence": 98
        },
        {
          "name": "1990",
          "description": "1990",
          "sequence": 108
        },
        {
          "name": "2000",
          "description": "2000",
          "sequence": 118
        },
        {
          "name": "2010",
          "description": "2010",
          "sequence": 131
        },
        {
          "name": "2020",
          "description": "2020",
          "sequence": 155
        }
      ],
      "geogLevels": [
        {
          "name": "state",
          "description": "State",
          "hasGeogExtentSelection": true,
          "sequence": 4
        },
        {
          "name": "county",
          "description": "State--County",
          "hasGeogExtentSelection": true,
          "sequence": 25
        }
      ]
    },
    {
      "name": "AV0",
      "description": "Total Population",
      "geographicIntegration": "Nominal",
      "sequence": 100.02,
      "timeSeries": [
        {
          "name": "AA",
          "description": "Persons: Total",
          "sequence": 1
        }
      ],
      "years": [
        {
          "name": "1970",
          "description": "1970",
          "sequence": 88
        },
        {
          "name": "1980",
          "description": "1980",
          "sequence": 98
        },
        {
          "name": "1990",
          "description": "1990",
          "sequence": 108
        },
        {
          "name": "2000",
          "description": "2000",
          "sequence": 118
        },
        {
          "name": "2010",
          "description": "2010",
          "sequence": 131
        },
        {
          "name": "105",
          "description": "2006-2010",
          "sequence": 133
        },
        {
          "name": "115",
          "description": "2007-2011",
          "sequence": 136
        },
        {
          "name": "125",
          "description": "2008-2012",
          "sequence": 139
        },
        {
          "name": "135",
          "description": "2009-2013",
          "sequence": 142
        },
        {
          "name": "145",
          "description": "2010-2014",
          "sequence": 144
        },
        {
          "name": "155",
          "description": "2011-2015",
          "sequence": 146
        },
        {
          "name": "165",
          "description": "2012-2016",
          "sequence": 148
        },
        {
          "name": "175",
          "description": "2013-2017",
          "sequence": 150
        },
        {
          "name": "185",
          "description": "2014-2018",
          "sequence": 152
        },
        {
          "name": "195",
          "description": "2015-2019",
          "sequence": 154
        },
        {
          "name": "2020",
          "description": "2020",
          "sequence": 155
        },
        {
          "name": "205",
          "description": "2016-2020",
          "sequence": 156
        }
      ],
      "geogLevels": [
        {
          "name": "state",
          "description": "State",
          "hasGeogExtentSelection": true,
          "sequence": 4
        },
        {
          "name": "county",
          "description": "State--County",
          "hasGeogExtentSelection": true,
          "sequence": 25
        },
        {
          "name": "tract",
          "description": "State--County--Census Tract",
          "hasGeogExtentSelection": true,
          "sequence": 65
        },
        {
          "name": "cty_sub",
          "description": "State--County--County Subdivision",
          "hasGeogExtentSelection": true,
          "sequence": 100
        },
        {
          "name": "place",
          "description": "State--Place",
          "hasGeogExtentSelection": true,
          "sequence": 145
        }
      ]
    },
    {
      "name": "B78",
      "description": "Total Population",
      "geographicIntegration": "Nominal",
      "sequence": 100.03,
      "timeSeries": [
        {
          "name": "AA",
          "description": "Persons: Total",
          "sequence": 1
        }
      ],
      "years": [
        {
          "name": "1980",
          "description": "1980",
          "sequence": 98
        },
        {
          "name": "1990",
          "description": "1990",
          "sequence": 108
        },
        {
          "name": "2000",
          "description": "2000",
          "sequence": 118
        },
        {
          "name": "2010",
          "description": "2010",
          "sequence": 131
        },
        {
          "name": "105",
          "description": "2006-2010",
          "sequence": 133
        },
        {
          "name": "115",
          "description": "2007-2011",
          "sequence": 136
        },
        {
          "name": "125",
          "description": "2008-2012",
          "sequence": 139
        },
        {
          "name": "135",
          "description": "2009-2013",
          "sequence": 142
        },
        {
          "name": "145",
          "description": "2010-2014",
          "sequence": 144
        },
        {
          "name": "155",
          "description": "2011-2015",
          "sequence": 146
        },
        {
          "name": "165",
          "description": "2012-2016",
          "sequence": 148
        },
        {
          "name": "175",
          "description": "2013-2017",
          "sequence": 150
        },
        {
          "name": "185",
          "description": "2014-2018",
          "sequence": 152
        },
        {
          "name": "195",
          "description": "2015-2019",
          "sequence": 154
        },
        {
          "name": "2020",
          "description": "2020",
          "sequence": 155
        },
        {
          "name": "205",
          "description": "2016-2020",
          "sequence": 156
        }
      ],
      "geogLevels": [
        {
          "name": "nation",
          "description": "Nation",
          "hasGeogExtentSelection": false,
          "sequence": 1
        },
        {
          "name": "region",
          "description": "Region",
          "hasGeogExtentSelection": false,
          "sequence": 2
        },
        {
          "name": "division",
          "description": "Division",
          "hasGeogExtentSelection": false,
          "sequence": 3
        },
        {
          "name": "state",
          "description": "State",
          "hasGeogExtentSelection": true,
          "sequence": 4
        },
        {
          "name": "county",
          "description": "State--County",
          "hasGeogExtentSelection": true,
          "sequence": 25
        },
        {
          "name": "tract",
          "description": "State--County--Census Tract",
          "hasGeogExtentSelection": true,
          "sequence": 65
        },
        {
          "name": "cty_sub",
          "description": "State--County--County Subdivision",
          "hasGeogExtentSelection": true,
          "sequence": 100
        },
        {
          "name": "place",
          "description": "State--Place",
          "hasGeogExtentSelection": true,
          "sequence": 145
        }
      ]
    },
    {
      "name": "CL8",
      "description": "Total Population",
      "geographicIntegration": "Standardized to 2010",
      "sequence": 100.04,
      "timeSeries": [
        {
          "name": "AA",
          "description": "Persons: Total",
          "sequence": 1
        }
      ],
      "years": [
        {
          "name": "1990",
          "description": "1990",
          "sequence": 108
        },
        {
          "name": "2000",
          "description": "2000",
          "sequence": 118
        },
        {
          "name": "2010",
          "description": "2010",
          "sequence": 131
        },
        {
          "name": "2020",
          "description": "2020",
          "sequence": 155
        }
      ],
      "geogLevels": [
        {
          "name": "state",
          "description": "State",
          "hasGeogExtentSelection": true,
          "sequence": 4
        },
        {
          "name": "county",
          "description": "State--County",
          "hasGeogExtentSelection": true,
          "sequence": 25
        },
        {
          "name": "tract",
          "description": "State--County--Census Tract",
          "hasGeogExtentSelection": true,
          "sequence": 65
        },
        {
          "name": "blck_grp",
          "description": "State--County--Census Tract--Block Group",
          "hasGeogExtentSelection": true,
          "sequence": 83
        },
        {
          "name": "cty_sub",
          "description": "State--County--County Subdivision",
          "hasGeogExtentSelection": true,
          "sequence": 100
        },
        {
          "name": "place",
          "description": "State--Place",
          "hasGeogExtentSelection": true,
          "sequence": 145
        },
        {
          "name": "cd111th",
          "description": "State--Congressional District (2007-2013, 110th-112th Congress)",
          "hasGeogExtentSelection": true,
          "sequence": 210
        },
        {
          "name": "cbsa",
          "description": "Metropolitan Statistical Area/Micropolitan Statistical Area",
          "hasGeogExtentSelection": false,
          "sequence": 319
        },
        {
          "name": "urb_area",
          "description": "Urban Area",
          "hasGeogExtentSelection": false,
          "sequence": 353
        },
        {
          "name": "zcta",
          "description": "5-Digit ZIP Code Tabulation Area",
          "hasGeogExtentSelection": false,
          "sequence": 363
        }
      ]
    },
    {
      "name": "A57",
      "description": "Persons by Urban/Rural Status [4]",
      "geographicIntegration": "Nominal",
      "sequence": 101.01,
      "timeSeries": [
        {
          "name": "AA",
          "description": "Persons: Urban",
          "sequence": 1
        },
        {
          "name": "AB",
          "description": "Persons: Urban--Inside urbanized areas",
          "sequence": 2
        },
        {
          "name": "AC",
          "description": "Persons: Urban--Outside urbanized areas (in urban clusters)",
          "sequence": 3
        },
        {
          "name": "AD",
          "description": "Persons: Rural",
          "sequence": 4
        }
      ],
      "years": [
        {
          "name": "1970",
          "description": "1970",
          "sequence": 88
        },
        {
          "name": "1980",
          "description": "1980",
          "sequence": 98
        },
        {
          "name": "1990",
          "description": "1990",
          "sequence": 108
        },
        {
          "name": "2000",
          "description": "2000",
          "sequence": 118
        },
        {
          "name": "2010",
          "description": "2010",
          "sequence": 131
        }
      ],
      "geogLevels": [
        {
          "name": "state",
          "description": "State",
          "hasGeogExtentSelection": true,
          "sequence": 4
        },
        {
          "name": "county",
          "description": "State--County",
          "hasGeogExtentSelection": true,
          "sequence": 25
        },
        {
          "name": "cty_sub",
          "description": "State--County--County Subdivision",
          "hasGeogExtentSelection": true,
          "sequence": 100
        },
        {
          "name": "place",
          "description": "State--Place",
          "hasGeogExtentSelection": true,
          "sequence": 145
        }
      ]
    },
    {
      "name": "A59",
      "description": "Persons by Urban/Rural Status [4]",
      "geographicIntegration": "Nominal",
      "sequence": 101.02,
      "timeSeries": [
        {
          "name": "AA",
          "description": "Persons: Urban",
          "sequence": 1
        },
        {
          "name": "AB",
          "description": "Persons: Urban--Inside urbanized areas",
          "sequence": 2
        },
        {
          "name": "AC",
          "description": "Persons: Urban--Outside urbanized areas (in urban clusters)",
          "sequence": 3
        },
        {
          "name": "AD",
          "description": "Persons: Rural",
          "sequence": 4
        }
      ],
      "years": [
        {
          "name": "1980",
          "description": "1980",
          "sequence": 98
        },
        {
          "name": "1990",
          "description": "1990",
          "sequence": 108
        },
        {
          "name": "2000",
          "description": "2000",
          "sequence": 118
        },
        {
          "name": "2010",
          "description": "2010",
          "sequence": 131
        }
      ],
      "geogLevels": [
        {
          "name": "nation",
          "description": "Nation",
          "hasGeogExtentSelection": false,
          "sequence": 1
        },
        {
          "name": "region",
          "description": "Region",
          "hasGeogExtentSelection": false,
          "sequence": 2
        },
        {
          "name": "division",
          "description": "Division",
          "hasGeogExtentSelection": false,
          "sequence": 3
        },
        {
          "name": "state",
          "description": "State",
          "hasGeogExtentSelection": true,
          "sequence": 4
        },
        {
          "name": "county",
          "description": "State--County",
          "hasGeogExtentSelection": true,
          "sequence": 25
        },
        {
          "name": "tract",
          "description": "State--County--Census Tract",
          "hasGeogExtentSelection": true,
          "sequence": 65
        },
        {
          "name": "cty_sub",
          "description": "State--County--County Subdivision",
          "hasGeogExtentSelection": true,
          "sequence": 100
        },
        {
          "name": "place",
          "description": "State--Place",
          "hasGeogExtentSelection": true,
          "sequence": 145
        }
      ]
    },
    {
      "name": "CL9",
      "description": "Persons by Urban/Rural Status [4]",
      "geographicIntegration": "Standardized to 2010",
      "sequence": 101.03,
      "timeSeries": [
        {
          "name": "AA",
          "description": "Persons: Urban",
          "sequence": 1
        },
        {
          "name": "AB",
          "description": "Persons: Urban--Inside urbanized areas",
          "sequence": 2
        },
        {
          "name": "AC",
          "description": "Persons: Urban--Outside urbanized areas (in urban clusters)",
          "sequence": 3
        },
        {
          "name": "AD",
          "description": "Persons: Rural",
          "sequence": 4
        }
      ],
      "years": [
        {
          "name": "1990",
          "description": "1990",
          "sequence": 108
        },
        {
          "name": "2000",
          "description": "2000",
          "sequence": 118
        },
        {
          "name": "2010",
          "description": "2010",
          "sequence": 131
        }
      ],
      "geogLevels": [
        {
          "name": "state",
          "description": "State",
          "hasGeogExtentSelection": true,
          "sequence": 4
        },
        {
          "name": "county",
          "description": "State--County",
          "hasGeogExtentSelection": true,
          "sequence": 25
        },
        {
          "name": "tract",
          "description": "State--County--Census Tract",
          "hasGeogExtentSelection": true,
          "sequence": 65
        },
        {
          "name": "blck_grp",
          "description": "State--County--Census Tract--Block Group",
          "hasGeogExtentSelection": true,
          "sequence": 83
        },
        {
          "name": "cty_sub",
          "description": "State--County--County Subdivision",
          "hasGeogExtentSelection": true,
          "sequence": 100
        },
        {
          "name": "place",
          "description": "State--Place",
          "hasGeogExtentSelection": true,
          "sequence": 145
        },
        {
          "name": "cd111th",
          "description": "State--Congressional District (2007-2013, 110th-112th Congress)",
          "hasGeogExtentSelection": true,
          "sequence": 210
        },
        {
          "name": "cbsa",
          "description": "Metropolitan Statistical Area/Micropolitan Statistical Area",
          "hasGeogExtentSelection": false,
          "sequence": 319
        },
        {
          "name": "urb_area",
          "description": "Urban Area",
          "hasGeogExtentSelection": false,
          "sequence": 353
        },
        {
          "name": "zcta",
          "description": "5-Digit ZIP Code Tabulation Area",
          "hasGeogExtentSelection": false,
          "sequence": 363
        }
      ]
    },
    {
      "name": "A08",
      "description": "Persons by Sex [2]",
      "geographicIntegration": "Nominal",
      "sequence": 102.01,
      "timeSeries": [
        {
          "name": "AA",
          "description": "Persons: Male",
          "sequence": 1
        },
        {
          "name": "AB",
          "description": "Persons: Female",
          "sequence": 2
        }
      ],
      "years": [
        {
          "name": "1820",
          "description": "1820",
          "sequence": 4
        },
        {
          "name": "1830",
          "description": "1830",
          "sequence": 5
        },
        {
          "name": "1840",
          "description": "1840",
          "sequence": 6
        },
        {
          "name": "1850",
          "description": "1850",
          "sequence": 7
        },
        {
          "name": "1860",
          "description": "1860",
          "sequence": 8
        },
        {
          "name": "1870",
          "description": "1870",
          "sequence": 12
        },
        {
          "name": "1880",
          "description": "1880",
          "sequence": 22
        },
        {
          "name": "1890",
          "description": "1890",
          "sequence": 29
        },
        {
          "name": "1900",
          "description": "1900",
          "sequence": 30
        },
        {
          "name": "1910",
          "description": "1910",
          "sequence": 32
        },
        {
          "name": "1920",
          "description": "1920",
          "sequence": 38
        },
        {
          "name": "1930",
          "description": "1930",
          "sequence": 48
        },
        {
          "name": "1940",
          "description": "1940",
          "sequence": 58
        },
        {
          "name": "1950",
          "description": "1950",
          "sequence": 68
        },
        {
          "name": "1960",
          "description": "1960",
          "sequence": 78
        },
        {
          "name": "1970",
          "description": "1970",
          "sequence": 88
        },
        {
          "name": "1980",
          "description": "1980",
          "sequence": 98
        },
        {
          "name": "1990",
          "description": "1990",
          "sequence": 108
        },
        {
          "name": "2000",
          "description": "2000",
          "sequence": 118
        },
        {
          "name": "2010",
          "description": "2010",
          "sequence": 131
        }
      ],
      "geogLevels": [
        {
          "name": "state",
          "description": "State",
          "hasGeogExtentSelection": true,
          "sequence": 4
        },
        {
          "name": "county",
          "description": "State--County",
          "hasGeogExtentSelection": true,
          "sequence": 25
        }
      ]
    },
    {
      "name": "AV1",
      "description": "Persons by Sex [2]",
      "geographicIntegration": "Nominal",
      "sequence": 102.02,
      "timeSeries": [
        {
          "name": "AA",
          "description": "Persons: Male",
          "sequence": 1
        },
        {
          "name": "AB",
          "description": "Persons: Female",
          "sequence": 2
        }
      ],
      "years": [
        {
          "name": "1970",
          "description": "1970",
          "sequence": 88
        },
        {
          "name": "1980",
          "description": "1980",
          "sequence": 98
        },
        {
          "name": "1990",
          "description": "1990",
          "sequence": 108
        },
        {
          "name": "2000",
          "description": "2000",
          "sequence": 118
        },
        {
          "name": "2010",
          "description": "2010",
          "sequence": 131
        },
        {
          "name": "105",
          "description": "2006-2010",
          "sequence": 133
        },
        {
          "name": "115",
          "description": "2007-2011",
          "sequence": 136
        },
        {
          "name": "125",
          "description": "2008-2012",
          "sequence": 139
        },
        {
          "name": "135",
          "description": "2009-2013",
          "sequence": 142
        },
        {
          "name": "145",
          "description": "2010-2014",
          "sequence": 144
        },
        {
          "name": "155",
          "description": "2011-2015",
          "sequence": 146
        },
        {
          "name": "165",
          "description": "2012-2016",
          "sequence": 148
        },
        {
          "name": "175",
          "description": "2013-2017",
          "sequence": 150
        },
        {
          "name": "185",
          "description": "2014-2018",
          "sequence": 152
        },
        {
          "name": "195",
          "description": "2015-2019",
          "sequence": 154
        },
        {
          "name": "205",
          "description": "2016-2020",
          "sequence": 156
        }
      ],
      "geogLevels": [
        {
          "name": "state",
          "description": "State",
          "hasGeogExtentSelection": true,
          "sequence": 4
        },
        {
          "name": "county",
          "description": "State--County",
          "hasGeogExtentSelection": true,
          "sequence": 25
        },
        {
          "name": "tract",
          "description": "State--County--Census Tract",
          "hasGeogExtentSelection": true,
          "sequence": 65
        },
        {
          "name": "cty_sub",
          "description": "State--County--County Subdivision",
          "hasGeogExtentSelection": true,
          "sequence": 100
        },
        {
          "name": "place",
          "description": "State--Place",
          "hasGeogExtentSelection": true,
          "sequence": 145
        }
      ]
    },
    {
      "name": "CM0",
      "description": "Persons by Sex [2]",
      "geographicIntegration": "Standardized to 2010",
      "sequence": 102.03,
      "timeSeries": [
        {
          "name": "AA",
          "description": "Persons: Male",
          "sequence": 1
        },
        {
          "name": "AB",
          "description": "Persons: Female",
          "sequence": 2
        }
      ],
      "years": [
        {
          "name": "1990",
          "description": "1990",
          "sequence": 108
        },
        {
          "name": "2000",
          "description": "2000",
          "sequence": 118
        },
        {
          "name": "2010",
          "description": "2010",
          "sequence": 131
        }
      ],
      "geogLevels": [
        {
          "name": "state",
          "description": "State",
          "hasGeogExtentSelection": true,
          "sequence": 4
        },
        {
          "name": "county",
          "description": "State--County",
          "hasGeogExtentSelection": true,
          "sequence": 25
        },
        {
          "name": "tract",
          "description": "State--County--Census Tract",
          "hasGeogExtentSelection": true,
          "sequence": 65
        },
        {
          "name": "blck_grp",
          "description": "State--County--Census Tract--Block Group",
          "hasGeogExtentSelection": true,
          "sequence": 83
        },
        {
          "name": "cty_sub",
          "description": "State--County--County Subdivision",
          "hasGeogExtentSelection": true,
          "sequence": 100
        },
        {
          "name": "place",
          "description": "State--Place",
          "hasGeogExtentSelection": true,
          "sequence": 145
        },
        {
          "name": "cd111th",
          "description": "State--Congressional District (2007-2013, 110th-112th Congress)",
          "hasGeogExtentSelection": true,
          "sequence": 210
        },
        {
          "name": "cbsa",
          "description": "Metropolitan Statistical Area/Micropolitan Statistical Area",
          "hasGeogExtentSelection": false,
          "sequence": 319
        },
        {
          "name": "urb_area",
          "description": "Urban Area",
          "hasGeogExtentSelection": false,
          "sequence": 353
        },
        {
          "name": "zcta",
          "description": "5-Digit ZIP Code Tabulation Area",
          "hasGeogExtentSelection": false,
          "sequence": 363
        }
      ]
    }
  ],
  "pageNumber": 1,
  "pageSize": 10,
  "totalCount": 389,
  "links": {
    "previousPage": null,
    "nextPage": "https://api.ipums.org/metadata/time_series_tables?collection=nhgis&pageNumber=2&pageSize=10&version=2"
  }
}

Note that this is a paginated endpoint. The default page size is 500 items, but here we have used the pageSize parameter to set 10 items per page. The links->nextPage field contains the URL to retrieve the next page of results.

Get Detailed Metadata for a Single Time Series Table

This API call will return the details of a single time series table, A00 in this example. The details repeat a lot of the information from the time series table call above, but also contain additional information on the individual time series contained within the table.

curl -X GET \
  "https://api.ipums.org/metadata/time_series_tables/A00?collection=nhgis&version=2" \
  -H "Authorization: $MY_KEY" | jq
    
# Results 

{
  "name": "A00",
  "description": "Total Population",
  "geographicIntegration": "Nominal",
  "sequence": 100.01,
  "timeSeries": [
    {
      "name": "AA",
      "description": "Persons: Total",
      "sequence": 1
    }
  ],
  "years": [
    {
      "name": "1790",
      "description": "1790",
      "sequence": 1
    },
    {
      "name": "1800",
      "description": "1800",
      "sequence": 2
    },
    {
      "name": "1810",
      "description": "1810",
      "sequence": 3
    },
    {
      "name": "1820",
      "description": "1820",
      "sequence": 4
    },
    {
      "name": "1830",
      "description": "1830",
      "sequence": 5
    },
    {
      "name": "1840",
      "description": "1840",
      "sequence": 6
    },
    {
      "name": "1850",
      "description": "1850",
      "sequence": 7
    },
    {
      "name": "1860",
      "description": "1860",
      "sequence": 8
    },
    {
      "name": "1870",
      "description": "1870",
      "sequence": 12
    },
    {
      "name": "1880",
      "description": "1880",
      "sequence": 22
    },
    {
      "name": "1890",
      "description": "1890",
      "sequence": 29
    },
    {
      "name": "1900",
      "description": "1900",
      "sequence": 30
    },
    {
      "name": "1910",
      "description": "1910",
      "sequence": 32
    },
    {
      "name": "1920",
      "description": "1920",
      "sequence": 38
    },
    {
      "name": "1930",
      "description": "1930",
      "sequence": 48
    },
    {
      "name": "1940",
      "description": "1940",
      "sequence": 58
    },
    {
      "name": "1950",
      "description": "1950",
      "sequence": 68
    },
    {
      "name": "1960",
      "description": "1960",
      "sequence": 78
    },
    {
      "name": "1970",
      "description": "1970",
      "sequence": 88
    },
    {
      "name": "1980",
      "description": "1980",
      "sequence": 98
    },
    {
      "name": "1990",
      "description": "1990",
      "sequence": 108
    },
    {
      "name": "2000",
      "description": "2000",
      "sequence": 118
    },
    {
      "name": "2010",
      "description": "2010",
      "sequence": 131
    },
    {
      "name": "2020",
      "description": "2020",
      "sequence": 155
    }
  ],
  "geogLevels": [
    {
      "name": "state",
      "description": "State",
      "hasGeogExtentSelection": true,
      "sequence": 4
    },
    {
      "name": "county",
      "description": "State--County",
      "hasGeogExtentSelection": true,
      "sequence": 25
    }
  ],
  "geographicInstances": [
    {
      "name": "010",
      "description": "Alabama"
    },
    {
      "name": "020",
      "description": "Alaska"
    },
    {
      "name": "025",
      "description": "Alaska Territory"
    },
    {
      "name": "040",
      "description": "Arizona"
    },
    {
      "name": "045",
      "description": "Arizona Territory"
    },
    {
      "name": "050",
      "description": "Arkansas"
    },
    {
      "name": "055",
      "description": "Arkansas Territory"
    },
    {
      "name": "060",
      "description": "California"
    },
    {
      "name": "080",
      "description": "Colorado"
    },
    {
      "name": "085",
      "description": "Colorado Territory"
    },
    {
      "name": "090",
      "description": "Connecticut"
    },
    {
      "name": "095",
      "description": "Dakota Territory"
    },
    {
      "name": "100",
      "description": "Delaware"
    },
    {
      "name": "110",
      "description": "District of Columbia"
    },
    {
      "name": "120",
      "description": "Florida"
    },
    {
      "name": "125",
      "description": "Florida Territory"
    },
    {
      "name": "130",
      "description": "Georgia"
    },
    {
      "name": "150",
      "description": "Hawaii"
    },
    {
      "name": "155",
      "description": "Hawaii Territory"
    },
    {
      "name": "160",
      "description": "Idaho"
    },
    {
      "name": "165",
      "description": "Idaho Territory"
    },
    {
      "name": "170",
      "description": "Illinois"
    },
    {
      "name": "175",
      "description": "Illinois Territory"
    },
    {
      "name": "178",
      "description": "Indian Territory"
    },
    {
      "name": "180",
      "description": "Indiana"
    },
    {
      "name": "185",
      "description": "Indiana Territory"
    },
    {
      "name": "190",
      "description": "Iowa"
    },
    {
      "name": "195",
      "description": "Iowa Territory"
    },
    {
      "name": "200",
      "description": "Kansas"
    },
    {
      "name": "205",
      "description": "Kansas Territory"
    },
    {
      "name": "210",
      "description": "Kentucky"
    },
    {
      "name": "220",
      "description": "Louisiana"
    },
    {
      "name": "225",
      "description": "Louisiana Territory"
    },
    {
      "name": "230",
      "description": "Maine"
    },
    {
      "name": "240",
      "description": "Maryland"
    },
    {
      "name": "250",
      "description": "Massachusetts"
    },
    {
      "name": "260",
      "description": "Michigan"
    },
    {
      "name": "265",
      "description": "Michigan Territory"
    },
    {
      "name": "270",
      "description": "Minnesota"
    },
    {
      "name": "275",
      "description": "Minnesota Territory"
    },
    {
      "name": "280",
      "description": "Mississippi"
    },
    {
      "name": "285",
      "description": "Mississippi Territory"
    },
    {
      "name": "290",
      "description": "Missouri"
    },
    {
      "name": "295",
      "description": "Missouri Territory"
    },
    {
      "name": "300",
      "description": "Montana"
    },
    {
      "name": "305",
      "description": "Montana Territory"
    },
    {
      "name": "310",
      "description": "Nebraska"
    },
    {
      "name": "315",
      "description": "Nebraska Territory"
    },
    {
      "name": "320",
      "description": "Nevada"
    },
    {
      "name": "325",
      "description": "Nevada Territory"
    },
    {
      "name": "330",
      "description": "New Hampshire"
    },
    {
      "name": "340",
      "description": "New Jersey"
    },
    {
      "name": "350",
      "description": "New Mexico"
    },
    {
      "name": "355",
      "description": "New Mexico Territory"
    },
    {
      "name": "360",
      "description": "New York"
    },
    {
      "name": "370",
      "description": "North Carolina"
    },
    {
      "name": "380",
      "description": "North Dakota"
    },
    {
      "name": "385",
      "description": "Northwest Territory"
    },
    {
      "name": "390",
      "description": "Ohio"
    },
    {
      "name": "400",
      "description": "Oklahoma"
    },
    {
      "name": "405",
      "description": "Oklahoma Territory"
    },
    {
      "name": "410",
      "description": "Oregon"
    },
    {
      "name": "413",
      "description": "Oregon Territory"
    },
    {
      "name": "417",
      "description": "Orleans Territory"
    },
    {
      "name": "420",
      "description": "Pennsylvania"
    },
    {
      "name": "440",
      "description": "Rhode Island"
    },
    {
      "name": "450",
      "description": "South Carolina"
    },
    {
      "name": "460",
      "description": "South Dakota"
    },
    {
      "name": "465",
      "description": "Southwest Territory"
    },
    {
      "name": "470",
      "description": "Tennessee"
    },
    {
      "name": "480",
      "description": "Texas"
    },
    {
      "name": "490",
      "description": "Utah"
    },
    {
      "name": "495",
      "description": "Utah Territory"
    },
    {
      "name": "500",
      "description": "Vermont"
    },
    {
      "name": "510",
      "description": "Virginia"
    },
    {
      "name": "530",
      "description": "Washington"
    },
    {
      "name": "535",
      "description": "Washington Territory"
    },
    {
      "name": "540",
      "description": "West Virginia"
    },
    {
      "name": "550",
      "description": "Wisconsin"
    },
    {
      "name": "555",
      "description": "Wisconsin Territory"
    },
    {
      "name": "560",
      "description": "Wyoming"
    },
    {
      "name": "565",
      "description": "Wyoming Territory"
    },
    {
      "name": "720",
      "description": "Puerto Rico"
    },
    {
      "name": "999",
      "description": "Persons in the Military"
    }
  ]
}

Time Series Table Attributes

  • name: The unique identifier of the time series table.
  • description: A short description of the time series table.
  • geographicIntegration: How the time series tables align geographic units across time. See our geographic integration method documentation.
  • sequence: The order in which the time series table will appear in the metadata API and extracts.
  • timeSeries: A list of time series for this time series table.
  • years: A list of years for this time series table.
  • geogLevels: A list of geographic levels available for this dataset.
    • name: The unique identifier of the geographic level.
    • description: A short description of the geographic level.
    • hasGeogExtentSelection: Whether or not extent selection is applied for this geography level. See geographicInstances for a list of valid extents.
  • geographicInstances: A list of the valid geographic extents for this time series table. Includes all states or state equivalents that are valid for any year in the time series table. (Some instances may be valid for some but not all years.)