IPUMS NHGIS Dataset Metadata

NHGIS summary tables are organized into datasets distinguished by the years, geographic levels and topics they cover; by the data source and survey coverage (e.g., sample-based vs. 100% count); and by the breakdown variables available. An overview and in-depth catalog of datasets are available on the NHGIS website.

Get High-Level Metadata for All Datasets

This API call will return a list of all available datasets. The entry for each dataset includes metadata for the dataset’s name and description. The unique identifier for each dataset is in the name field. This is needed for retrieving details about a single dataset (see next section).

import requests
import json
from pprint import pprint

my_headers = {"Authorization": my_key}

nhgis_metadata = requests.get("https://api.ipums.org/des/metadata/agg/nhgis/vbeta/datasets", headers=my_headers)

pprint(nhgis_metadata.json()[0:20])

    [{'description': 'Population Data [US, States & Counties]',
      'name': '1790_cPop'},
     {'description': 'Population Data [US, States & Counties]',
      'name': '1800_cPop'},
     {'description': 'Population Data [US, States & Counties]',
      'name': '1810_cPop'},
     {'description': 'Population Data [US, States & Counties]',
      'name': '1820_cPop'},
     {'description': 'Population Data [US, States & Counties]',
      'name': '1830_cPop'},
     {'description': 'Agriculture Data [US, States & Counties]',
      'name': '1840_cAg'},
     {'description': 'Population & Other Data [US, States & Counties]',
      'name': '1840_cPopX'},
     {'description': 'Manufacturing Data [US, States & Counties]',
      'name': '1840_cMfg'},
     {'description': 'Agriculture Data [US, States & Counties]',
      'name': '1850_cAg'},
     {'description': 'Population, Agriculture & Other Data [US, States & Counties]',
      'name': '1850_cPAX'},
     {'description': 'Farm Real Estate Values [States & Counties]',
      'name': '1850_1959_cFV'},
     {'description': 'Population, Agriculture & Other Data [US & States]',
      'name': '1850_sPAX'},
     {'description': 'Agriculture Data [US, States & Counties]',
      'name': '1860_cAg'},
     {'description': 'Population, Agriculture & Other Data [US, States & Counties]',
      'name': '1860_cPAX'},
     {'description': 'Population, Agriculture & Other Data [US & States]',
      'name': '1860_sPAX'},
     {'description': 'Agriculture Data [US, States & Counties]',
      'name': '1870_cAg'},
     {'description': 'Population, Agriculture & Other Data [US, States & Counties]',
      'name': '1870_cPAX'},
     {'description': 'Religious Bodies, Occupation & Government Data [US & States]',
      'name': '1870_sROG'},
     {'description': 'Population, Housing & Other Data [US & States]',
      'name': '1870_sPHX'},
     {'description': 'Manufacturing Data [US, States & Counties]',
      'name': '1870_cMfg'}]
result <- GET("https://api.ipums.org/des/metadata/agg/nhgis/vbeta/datasets", add_headers(Authorization = my_key))
res_df <- content(result, "parsed", simplifyDataFrame = TRUE)
res_df # Contains metadata

# res_df will contain a response like:

          name                              description
1         1790_cPop                         Population Data [US, States & Counties]
2         1800_cPop                         Population Data [US, States & Counties]
3         1810_cPop                         Population Data [US, States & Counties]
4         1820_cPop                         Population Data [US, States & Counties]
5         1830_cPop                         Population Data [US, States & Counties]
6          1840_cAg                         Agriculture Data [US, States & Counties]
7        1840_cPopX                         Population & Other Data [US, States & Counties]
8         1840_cMfg                         Manufacturing Data [US, States & Counties]
9          1850_cAg                         Agriculture Data [US, States & Counties]
...
curl -X GET \
  https://api.ipums.org/des/metadata/agg/nhgis/vbeta/datasets \
  -H 'Content-Type: application/json' \
  -H 'Authorization: ' + my_key

# This will return a JSON response like:

[
   {
      "name" : "1790_cPop",
      "description" : "Population Data [US, States & Counties]"
   },
   {
      "name" : "1800_cPop",
      "description" : "Population Data [US, States & Counties]"
   },
   {
      "name" : "1810_cPop",
      "description" : "Population Data [US, States & Counties]"
   },
   {
      "name" : "1820_cPop",
      "description" : "Population Data [US, States & Counties]"
   },
   {
      "name" : "1830_cPop",
      "description" : "Population Data [US, States & Counties]"
   },
   {
      "description" : "Agriculture Data [US, States & Counties]",
      "name" : "1840_cAg"
   },
   {
      "name" : "1840_cPopX",
      "description" : "Population & Other Data [US, States & Counties]"
   },
   {
      "description" : "Manufacturing Data [US, States & Counties]",
      "name" : "1840_cMfg"
   }
]

Get Detailed Metadata for a Single Dataset

This API call will return the details of a single dataset, 1790_cPop in this example. The details include the name and description of each each table within the dataset, as well as the geographic levels for which this dataset is available.

nhgis_1790_cPop = requests.get("https://api.ipums.org/des/metadata/agg/nhgis/vbeta/datasets/1790_cPop", headers=my_headers)
pprint(nhgis_1790_cPop.json())

# response looks like: 
{
    "name": "1790_cPop",
    "group": "1790 Census",
    "description": "Population Data [US, States & Counties]",
    "sequence": 101,
    "data_tables": [
        {
            "name": "NT1",
            "nhgis_code": "AAA",
            "description": "Total Population",
            "sequence": 1
        },
        {
            "name": "NT2",
            "nhgis_code": "AAK",
            "description": "Urban Population (Incorporated Places 2,500 and Over)",
            "sequence": 2
        },
        {
            "name": "NT3",
            "nhgis_code": "AAN",
            "description": "Urban Population in Cities of 25,000 and Over",
            "sequence": 3
        },
        {
            "name": "NT4",
            "nhgis_code": "AAO",
            "description": "White Males and Estimated White Females by Sex by Age",
            "sequence": 4
        },
        {
            "name": "NT5",
            "nhgis_code": "AAP",
            "description": "White Population by Sex",
            "sequence": 5
        },
        {
            "name": "NT6",
            "nhgis_code": "AAQ",
            "description": "Race/Slave Status",
            "sequence": 6
        },
        {
            "name": "NT9",
            "nhgis_code": "AAR",
            "description": "Total Number of Families",
            "sequence": 7
        },
        {
            "name": "NT10",
            "nhgis_code": "AAB",
            "description": "Number of Family Members",
            "sequence": 8
        },
        {
            "name": "NT12",
            "nhgis_code": "AAC",
            "description": "White Population by Nationality",
            "sequence": 9
        },
        {
            "name": "NT13",
            "nhgis_code": "AAD",
            "description": "Families by Slaveholding Status",
            "sequence": 10
        },
        {
            "name": "NT14",
            "nhgis_code": "AAE",
            "description": "Families by Slaveholding Status by Race",
            "sequence": 11
        },
        {
            "name": "NT15",
            "nhgis_code": "AAF",
            "description": "White Family Members by Slaveholding Status",
            "sequence": 12
        },
        {
            "name": "NT16",
            "nhgis_code": "AAG",
            "description": "Average Number of Members in White Families by Slaveholding Status",
            "sequence": 13
        },
        {
            "name": "NT17",
            "nhgis_code": "AAH",
            "description": "Percent of Families by Slaveholding Status by Race",
            "sequence": 14
        },
        {
            "name": "NT18",
            "nhgis_code": "AAI",
            "description": "Total Number of Slaves",
            "sequence": 15
        },
        {
            "name": "NT19",
            "nhgis_code": "AAJ",
            "description": "Average Number of Slaves per Slaveholding Family",
            "sequence": 16
        },
        {
            "name": "NT20",
            "nhgis_code": "AAL",
            "description": "Slaveholding Families by Number of Slaves",
            "sequence": 17
        },
        {
            "name": "NT21",
            "nhgis_code": "AAM",
            "description": "Race",
            "sequence": 18
        }
    ],
    "geog_levels": [
        {
            "name": "nation",
            "description": "Nation",
            "sequence": 1
        },
        {
            "name": "state",
            "description": "State",
            "sequence": 4
        },
        {
            "name": "county",
            "description": "State--County",
            "sequence": 25
        }
    ]
}
result <- GET("https://api.ipums.org/des/metadata/agg/nhgis/vbeta/datasets/1790_cPop", add_headers(Authorization = my_key))
results <- content(result, "parsed", simplifyDataFrame = TRUE)
results # Contains metadata

# results will contain a response like:

$name
[1] "1790_cPop"

$description
[1] "Population Data [US, States & Counties]"

$data_tables
   name                                                        description
1   NT1                                                   Total Population
2  NT10                                           Number of Family Members
3  NT12                                    White Population by Nationality
4  NT13                                    Families by Slaveholding Status
5  NT14                            Families by Slaveholding Status by Race
6  NT15                        White Family Members by Slaveholding Status
7  NT16 Average Number of Members in White Families by Slaveholding Status
8  NT17                 Percent of Families by Slaveholding Status by Race
9  NT18                                             Total Number of Slaves
10 NT19                   Average Number of Slaves per Slaveholding Family
11  NT2              Urban Population (Incorporated Places 2,500 and Over)
12 NT20                          Slaveholding Families by Number of Slaves
13 NT21                                                               Race
14  NT3                      Urban Population in Cities of 25,000 and Over
15  NT4              White Males and Estimated White Females by Sex by Age
16  NT5                                            White Population by Sex
17  NT6                                                  Race/Slave Status
18  NT9                                           Total Number of Families

$geog_levels
    name   description
1 county State--County
2  state         State
3 nation        Nation
curl -X GET \
  https://api.ipums.org/des/metadata/agg/nhgis/vbeta/datasets/1790_cPop \
  -H 'Content-Type: application/json' \
  -H 'Authorization: ' + my_key
  
  # This returns:
  
{
    "name": "1790_cPop",
    "group": "1790 Census",
    "description": "Population Data [US, States & Counties]",
    "sequence": 101,
    "data_tables": [
        {
            "name": "NT1",
            "nhgis_code": "AAA",
            "description": "Total Population",
            "sequence": 1
        },
        {
            "name": "NT2",
            "nhgis_code": "AAK",
            "description": "Urban Population (Incorporated Places 2,500 and Over)",
            "sequence": 2
        },
        {
            "name": "NT3",
            "nhgis_code": "AAN",
            "description": "Urban Population in Cities of 25,000 and Over",
            "sequence": 3
        },
        {
            "name": "NT4",
            "nhgis_code": "AAO",
            "description": "White Males and Estimated White Females by Sex by Age",
            "sequence": 4
        },
        {
            "name": "NT5",
            "nhgis_code": "AAP",
            "description": "White Population by Sex",
            "sequence": 5
        },
        {
            "name": "NT6",
            "nhgis_code": "AAQ",
            "description": "Race/Slave Status",
            "sequence": 6
        },
        {
            "name": "NT9",
            "nhgis_code": "AAR",
            "description": "Total Number of Families",
            "sequence": 7
        },
        {
            "name": "NT10",
            "nhgis_code": "AAB",
            "description": "Number of Family Members",
            "sequence": 8
        },
        {
            "name": "NT12",
            "nhgis_code": "AAC",
            "description": "White Population by Nationality",
            "sequence": 9
        },
        {
            "name": "NT13",
            "nhgis_code": "AAD",
            "description": "Families by Slaveholding Status",
            "sequence": 10
        },
        {
            "name": "NT14",
            "nhgis_code": "AAE",
            "description": "Families by Slaveholding Status by Race",
            "sequence": 11
        },
        {
            "name": "NT15",
            "nhgis_code": "AAF",
            "description": "White Family Members by Slaveholding Status",
            "sequence": 12
        },
        {
            "name": "NT16",
            "nhgis_code": "AAG",
            "description": "Average Number of Members in White Families by Slaveholding Status",
            "sequence": 13
        },
        {
            "name": "NT17",
            "nhgis_code": "AAH",
            "description": "Percent of Families by Slaveholding Status by Race",
            "sequence": 14
        },
        {
            "name": "NT18",
            "nhgis_code": "AAI",
            "description": "Total Number of Slaves",
            "sequence": 15
        },
        {
            "name": "NT19",
            "nhgis_code": "AAJ",
            "description": "Average Number of Slaves per Slaveholding Family",
            "sequence": 16
        },
        {
            "name": "NT20",
            "nhgis_code": "AAL",
            "description": "Slaveholding Families by Number of Slaves",
            "sequence": 17
        },
        {
            "name": "NT21",
            "nhgis_code": "AAM",
            "description": "Race",
            "sequence": 18
        }
    ],
    "geog_levels": [
        {
            "name": "nation",
            "description": "Nation",
            "sequence": 1
        },
        {
            "name": "state",
            "description": "State",
            "sequence": 4
        },
        {
            "name": "county",
            "description": "State--County",
            "sequence": 25
        }
    ]
}

Get Metadata for a Table

This API call will return the metadata details for a specific table, NP19 from 1990_STF1 in this example. This includes the NHGIS code, which appears in the codebook and is prepended to the variable names in the extract. The universe information is also returned, along with codes and descriptions for each variable.

nhgis_1990_STF1_NP19 = requests.get("https://api.ipums.org/des/metadata/agg/nhgis/vbeta/datasets/1990_STF1/data_tables/NP19", headers=my_headers)
pprint(nhgis_1990_STF1_NP19.json())

# This outputs:

{'description': 'Race of Householder by Household Type',
 'name': 'NP19',
 'nhgis_code': 'EUC',
 'sequence': 20,
 'universe': 'Households',
 'variables': [{'description': 'White >> Family households: Married-couple '
                               'family: With related children',
                'nhgis_code': 'EUC001'},
               {'description': 'White >> Family households: Married-couple '
                               'family: No related children',
                'nhgis_code': 'EUC002'},
               {'description': 'White >> Family households: Other family: Male '
                               'householder, no wife present: With related '
                               'children',
                'nhgis_code': 'EUC003'},
               {'description': 'White >> Family households: Other family: Male '
                               'householder, no wife present: No related '
                               'children',
                'nhgis_code': 'EUC004'},
               {'description': 'White >> Family households: Other family: '
                               'Female householder, no husband present: With '
                               'related children',
                'nhgis_code': 'EUC005'},
               {'description': 'White >> Family households: Other family: '
                               'Female householder, no husband present: No '
                               'related children',
                'nhgis_code': 'EUC006'},
               {'description': 'White >> Nonfamily households: Householder '
                               'living alone',
                'nhgis_code': 'EUC007'},
               {'description': 'White >> Nonfamily households: Householder not '
                               'living alone',
                'nhgis_code': 'EUC008'},
               {'description': 'Black >> Family households: Married-couple '
                               'family: With related children',
                'nhgis_code': 'EUC009'},
               {'description': 'Black >> Family households: Married-couple '
                               'family: No related children',
                'nhgis_code': 'EUC010'},
               {'description': 'Black >> Family households: Other family: Male '
                               'householder, no wife present: With related '
                               'children',
                'nhgis_code': 'EUC011'},
               {'description': 'Black >> Family households: Other family: Male '
                               'householder, no wife present: No related '
                               'children',
                'nhgis_code': 'EUC012'},
               {'description': 'Black >> Family households: Other family: '
                               'Female householder, no husband present: With '
                               'related children',
                'nhgis_code': 'EUC013'},
               {'description': 'Black >> Family households: Other family: '
                               'Female householder, no husband present: No '
                               'related children',
                'nhgis_code': 'EUC014'},
               {'description': 'Black >> Nonfamily households: Householder '
                               'living alone',
                'nhgis_code': 'EUC015'},
               {'description': 'Black >> Nonfamily households: Householder not '
                               'living alone',
                'nhgis_code': 'EUC016'},
               {'description': 'American Indian, Eskimo, or Aleut >> Family '
                               'households: Married-couple family: With '
                               'related children',
                'nhgis_code': 'EUC017'},
               {'description': 'American Indian, Eskimo, or Aleut >> Family '
                               'households: Married-couple family: No related '
                               'children',
                'nhgis_code': 'EUC018'},
               {'description': 'American Indian, Eskimo, or Aleut >> Family '
                               'households: Other family: Male householder, no '
                               'wife present: With related children',
                'nhgis_code': 'EUC019'},
               {'description': 'American Indian, Eskimo, or Aleut >> Family '
                               'households: Other family: Male householder, no '
                               'wife present: No related children',
                'nhgis_code': 'EUC020'},
               {'description': 'American Indian, Eskimo, or Aleut >> Family '
                               'households: Other family: Female householder, '
                               'no husband present: With related children',
                'nhgis_code': 'EUC021'},
               {'description': 'American Indian, Eskimo, or Aleut >> Family '
                               'households: Other family: Female householder, '
                               'no husband present: No related children',
                'nhgis_code': 'EUC022'},
               {'description': 'American Indian, Eskimo, or Aleut >> Nonfamily '
                               'households: Householder living alone',
                'nhgis_code': 'EUC023'},
               {'description': 'American Indian, Eskimo, or Aleut >> Nonfamily '
                               'households: Householder not living alone',
                'nhgis_code': 'EUC024'},
               {'description': 'Asian or Pacific Islander >> Family '
                               'households: Married-couple family: With '
                               'related children',
                'nhgis_code': 'EUC025'},
               {'description': 'Asian or Pacific Islander >> Family '
                               'households: Married-couple family: No related '
                               'children',
                'nhgis_code': 'EUC026'},
               {'description': 'Asian or Pacific Islander >> Family '
                               'households: Other family: Male householder, no '
                               'wife present: With related children',
                'nhgis_code': 'EUC027'},
               {'description': 'Asian or Pacific Islander >> Family '
                               'households: Other family: Male householder, no '
                               'wife present: No related children',
                'nhgis_code': 'EUC028'},
               {'description': 'Asian or Pacific Islander >> Family '
                               'households: Other family: Female householder, '
                               'no husband present: With related children',
                'nhgis_code': 'EUC029'},
               {'description': 'Asian or Pacific Islander >> Family '
                               'households: Other family: Female householder, '
                               'no husband present: No related children',
                'nhgis_code': 'EUC030'},
               {'description': 'Asian or Pacific Islander >> Nonfamily '
                               'households: Householder living alone',
                'nhgis_code': 'EUC031'},
               {'description': 'Asian or Pacific Islander >> Nonfamily '
                               'households: Householder not living alone',
                'nhgis_code': 'EUC032'},
               {'description': 'Other race >> Family households: '
                               'Married-couple family: With related children',
                'nhgis_code': 'EUC033'},
               {'description': 'Other race >> Family households: '
                               'Married-couple family: No related children',
                'nhgis_code': 'EUC034'},
               {'description': 'Other race >> Family households: Other family: '
                               'Male householder, no wife present: With '
                               'related children',
                'nhgis_code': 'EUC035'},
               {'description': 'Other race >> Family households: Other family: '
                               'Male householder, no wife present: No related '
                               'children',
                'nhgis_code': 'EUC036'},
               {'description': 'Other race >> Family households: Other family: '
                               'Female householder, no husband present: With '
                               'related children',
                'nhgis_code': 'EUC037'},
               {'description': 'Other race >> Family households: Other family: '
                               'Female householder, no husband present: No '
                               'related children',
                'nhgis_code': 'EUC038'},
               {'description': 'Other race >> Nonfamily households: '
                               'Householder living alone',
                'nhgis_code': 'EUC039'},
               {'description': 'Other race >> Nonfamily households: '
                               'Householder not living alone',
                'nhgis_code': 'EUC040'}]}
result <- GET("https://api.ipums.org/des/metadata/agg/nhgis/vbeta/datasets/1990_STF1/data_tables/NP19", add_headers(Authorization = my_key))
results <- content(result, "parsed", simplifyDataFrame = TRUE)
results # Contains metadata

# Results contains:

$name
[1] "NP19"

$description
[1] "Race of Householder by Household Type"

$universe
[1] "Households"

$nhgis_code
[1] "EUC"

$sequence
[1] 20

$variables
                                                                                                                           description nhgis_code
1                                                             White >> Family households: Married-couple family: With related children     EUC001
2                                                               White >> Family households: Married-couple family: No related children     EUC002
3                                   White >> Family households: Other family: Male householder, no wife present: With related children     EUC003
4                                     White >> Family households: Other family: Male householder, no wife present: No related children     EUC004
5                              White >> Family households: Other family: Female householder, no husband present: With related children     EUC005
6                                White >> Family households: Other family: Female householder, no husband present: No related children     EUC006
7                                                                              White >> Nonfamily households: Householder living alone     EUC007
8                                                                          White >> Nonfamily households: Householder not living alone     EUC008
9                                                             Black >> Family households: Married-couple family: With related children     EUC009
10                                                              Black >> Family households: Married-couple family: No related children     EUC010
11                                  Black >> Family households: Other family: Male householder, no wife present: With related children     EUC011
12                                    Black >> Family households: Other family: Male householder, no wife present: No related children     EUC012
13                             Black >> Family households: Other family: Female householder, no husband present: With related children     EUC013
14                               Black >> Family households: Other family: Female householder, no husband present: No related children     EUC014
15                                                                             Black >> Nonfamily households: Householder living alone     EUC015
16                                                                         Black >> Nonfamily households: Householder not living alone     EUC016
17                                American Indian, Eskimo, or Aleut >> Family households: Married-couple family: With related children     EUC017
18                                  American Indian, Eskimo, or Aleut >> Family households: Married-couple family: No related children     EUC018
19      American Indian, Eskimo, or Aleut >> Family households: Other family: Male householder, no wife present: With related children     EUC019
20        American Indian, Eskimo, or Aleut >> Family households: Other family: Male householder, no wife present: No related children     EUC020
21 American Indian, Eskimo, or Aleut >> Family households: Other family: Female householder, no husband present: With related children     EUC021
22   American Indian, Eskimo, or Aleut >> Family households: Other family: Female householder, no husband present: No related children     EUC022
23                                                 American Indian, Eskimo, or Aleut >> Nonfamily households: Householder living alone     EUC023
24                                             American Indian, Eskimo, or Aleut >> Nonfamily households: Householder not living alone     EUC024
25                                        Asian or Pacific Islander >> Family households: Married-couple family: With related children     EUC025
26                                          Asian or Pacific Islander >> Family households: Married-couple family: No related children     EUC026
27              Asian or Pacific Islander >> Family households: Other family: Male householder, no wife present: With related children     EUC027
28                Asian or Pacific Islander >> Family households: Other family: Male householder, no wife present: No related children     EUC028
29         Asian or Pacific Islander >> Family households: Other family: Female householder, no husband present: With related children     EUC029
30           Asian or Pacific Islander >> Family households: Other family: Female householder, no husband present: No related children     EUC030
31                                                         Asian or Pacific Islander >> Nonfamily households: Householder living alone     EUC031
32                                                     Asian or Pacific Islander >> Nonfamily households: Householder not living alone     EUC032
33                                                       Other race >> Family households: Married-couple family: With related children     EUC033
34                                                         Other race >> Family households: Married-couple family: No related children     EUC034
35                             Other race >> Family households: Other family: Male householder, no wife present: With related children     EUC035
36                               Other race >> Family households: Other family: Male householder, no wife present: No related children     EUC036
37                        Other race >> Family households: Other family: Female householder, no husband present: With related children     EUC037
38                          Other race >> Family households: Other family: Female householder, no husband present: No related children     EUC038
39                                                                        Other race >> Nonfamily households: Householder living alone     EUC039
40                                                                    Other race >> Nonfamily households: Householder not living alone     EUC040
curl -X GET \
  https://api.ipums.org/des/metadata/agg/nhgis/vbeta/datasets/1990_STF1/data_tables/NP19 \
  -H 'Content-Type: application/json' \
  -H 'Authorization: ' + my_key

# This returns: 

{
    "name": "NP19",
    "description": "Race of Householder by Household Type",
    "universe": "Households",
    "nhgis_code": "EUC",
    "sequence": 20,
    "variables": [
        {
            "description": "White >> Family households: Married-couple family: With related children",
            "nhgis_code": "EUC001"
        },
        {
            "description": "White >> Family households: Married-couple family: No related children",
            "nhgis_code": "EUC002"
        },
        {
            "description": "White >> Family households: Other family: Male householder, no wife present: With related children",
            "nhgis_code": "EUC003"
        },
        {
            "description": "White >> Family households: Other family: Male householder, no wife present: No related children",
            "nhgis_code": "EUC004"
        },
        {
            "description": "White >> Family households: Other family: Female householder, no husband present: With related children",
            "nhgis_code": "EUC005"
        },
        {
            "description": "White >> Family households: Other family: Female householder, no husband present: No related children",
            "nhgis_code": "EUC006"
        },
        {
            "description": "White >> Nonfamily households: Householder living alone",
            "nhgis_code": "EUC007"
        },
        {
            "description": "White >> Nonfamily households: Householder not living alone",
            "nhgis_code": "EUC008"
        },
        {
            "description": "Black >> Family households: Married-couple family: With related children",
            "nhgis_code": "EUC009"
        },
        {
            "description": "Black >> Family households: Married-couple family: No related children",
            "nhgis_code": "EUC010"
        },
        {
            "description": "Black >> Family households: Other family: Male householder, no wife present: With related children",
            "nhgis_code": "EUC011"
        },
        {
            "description": "Black >> Family households: Other family: Male householder, no wife present: No related children",
            "nhgis_code": "EUC012"
        },
        {
            "description": "Black >> Family households: Other family: Female householder, no husband present: With related children",
            "nhgis_code": "EUC013"
        },
        {
            "description": "Black >> Family households: Other family: Female householder, no husband present: No related children",
            "nhgis_code": "EUC014"
        },
        {
            "description": "Black >> Nonfamily households: Householder living alone",
            "nhgis_code": "EUC015"
        },
        {
            "description": "Black >> Nonfamily households: Householder not living alone",
            "nhgis_code": "EUC016"
        },
        {
            "description": "American Indian, Eskimo, or Aleut >> Family households: Married-couple family: With related children",
            "nhgis_code": "EUC017"
        },
        {
            "description": "American Indian, Eskimo, or Aleut >> Family households: Married-couple family: No related children",
            "nhgis_code": "EUC018"
        },
        {
            "description": "American Indian, Eskimo, or Aleut >> Family households: Other family: Male householder, no wife present: With related children",
            "nhgis_code": "EUC019"
        },
        {
            "description": "American Indian, Eskimo, or Aleut >> Family households: Other family: Male householder, no wife present: No related children",
            "nhgis_code": "EUC020"
        },
        {
            "description": "American Indian, Eskimo, or Aleut >> Family households: Other family: Female householder, no husband present: With related children",
            "nhgis_code": "EUC021"
        },
        {
            "description": "American Indian, Eskimo, or Aleut >> Family households: Other family: Female householder, no husband present: No related children",
            "nhgis_code": "EUC022"
        },
        {
            "description": "American Indian, Eskimo, or Aleut >> Nonfamily households: Householder living alone",
            "nhgis_code": "EUC023"
        },
        {
            "description": "American Indian, Eskimo, or Aleut >> Nonfamily households: Householder not living alone",
            "nhgis_code": "EUC024"
        },
        {
            "description": "Asian or Pacific Islander >> Family households: Married-couple family: With related children",
            "nhgis_code": "EUC025"
        },
        {
            "description": "Asian or Pacific Islander >> Family households: Married-couple family: No related children",
            "nhgis_code": "EUC026"
        },
        {
            "description": "Asian or Pacific Islander >> Family households: Other family: Male householder, no wife present: With related children",
            "nhgis_code": "EUC027"
        },
        {
            "description": "Asian or Pacific Islander >> Family households: Other family: Male householder, no wife present: No related children",
            "nhgis_code": "EUC028"
        },
        {
            "description": "Asian or Pacific Islander >> Family households: Other family: Female householder, no husband present: With related children",
            "nhgis_code": "EUC029"
        },
        {
            "description": "Asian or Pacific Islander >> Family households: Other family: Female householder, no husband present: No related children",
            "nhgis_code": "EUC030"
        },
        {
            "description": "Asian or Pacific Islander >> Nonfamily households: Householder living alone",
            "nhgis_code": "EUC031"
        },
        {
            "description": "Asian or Pacific Islander >> Nonfamily households: Householder not living alone",
            "nhgis_code": "EUC032"
        },
        {
            "description": "Other race >> Family households: Married-couple family: With related children",
            "nhgis_code": "EUC033"
        },
        {
            "description": "Other race >> Family households: Married-couple family: No related children",
            "nhgis_code": "EUC034"
        },
        {
            "description": "Other race >> Family households: Other family: Male householder, no wife present: With related children",
            "nhgis_code": "EUC035"
        },
        {
            "description": "Other race >> Family households: Other family: Male householder, no wife present: No related children",
            "nhgis_code": "EUC036"
        },
        {
            "description": "Other race >> Family households: Other family: Female householder, no husband present: With related children",
            "nhgis_code": "EUC037"
        },
        {
            "description": "Other race >> Family households: Other family: Female householder, no husband present: No related children",
            "nhgis_code": "EUC038"
        },
        {
            "description": "Other race >> Nonfamily households: Householder living alone",
            "nhgis_code": "EUC039"
        },
        {
            "description": "Other race >> Nonfamily households: Householder not living alone",
            "nhgis_code": "EUC040"
        }
    ]
}