An official website of the United States government
Here’s how you know
Official websites use .gov
A .gov website belongs to an official government organization in the United States.
Secure .gov websites use HTTPS
A lock (
) or https:// means you’ve safely connected to the .gov website. Share sensitive information only on official, secure websites.
The U.S. Census Bureau is releasing new functionality to our discovery page on the data API that will allow users to see a list of all valid values for categorical variables.
This functionality may break existing calls to the API Discovery for variables, depending on how the JSON or XML for variable exploration are used.
Valid Values will be populated on a flow basis as the U.S. Census Bureau migrates to a new metadata system. We will update this notice once some valid values are populated. Currently all valid values are blank.
Released to beta on July 6, 2017 and plan to release to production on July 19, 2017.
Beta: https://beta.dataweb.rm.census.gov/data.html
Production: https://api.census.gov/data/.html
Developers will be able to see and query a list of valid values for select variables.
There will be a new column on the variables discovery page that will link to a list of valid values for most categorical variables. These valid values will also show up in the json and xml variables pages.
JSON-
{
"name": "LFO",
"label": "Legal form of organization",
"concept": "Employer Statistics",
"required": default displayed,
"predicateType": "string",
"group": "N/A",
"limit": 8,
"validValues": [
]
}
XML-
<census-api><vars><var xml:id="LFO" label="Legal form of organization" concept="Employer Statistics" required="default displayed" predicate-type="string" group="N/A" limit="8"><validValues>
</validValues></var></vars></census-api>
This feature will provide access to additional documentation for categorical variables by allowing users to generate lists of valid values for an API call without going through the data first.
Please report any problems you encounter to <cnmp.developers.list@census.gov>.
Top