Dataset Catalog
Terranode comes with pre-loaded US boundary datasets from the Census Bureau. These are available on all tiers at no extra cost. All datasets are public domain (Title 13, U.S. Code).
Use any dataset slug with the system_dataset parameter on query endpoints.
US States
Section titled “US States”Slug: us-states
US state and territory boundaries including DC and island areas. Simplified to 1:20,000,000 scale by the Census Bureau.
| Detail | Value |
|---|---|
| Features | 52 |
| Source | U.S. Census Bureau, Cartographic Boundary Files |
| Vintage | 2024 |
| Update cycle | Annual |
| ID property | GEOID (FIPS state code) |
Example query:
curl -s "https://api.terranode.co/v1/pip?lat=40.7128&lng=-74.006&system_dataset=us-states" \ -H "x-api-key: YOUR_API_KEY" | jq .Key properties: STATEFP, STUSPS (abbreviation), NAME, ALAND, AWATER
US Counties
Section titled “US Counties”Slug: us-counties
All 3,222 counties and county-equivalents (parishes, boroughs, independent cities, census areas) across all states, DC, and territories.
| Detail | Value |
|---|---|
| Features | 3,222 |
| Source | U.S. Census Bureau, Cartographic Boundary Files |
| Vintage | 2024 |
| Update cycle | Annual |
| ID property | GEOID (FIPS state+county code) |
Example query:
curl -s "https://api.terranode.co/v1/pip?lat=34.0522&lng=-118.2437&system_dataset=us-counties" \ -H "x-api-key: YOUR_API_KEY" | jq .Key properties: STATEFP, COUNTYFP, GEOID, NAME, NAMELSAD, ALAND, AWATER
US ZCTAs (ZIP Codes)
Section titled “US ZCTAs (ZIP Codes)”Slug: us-zctas
ZIP Code Tabulation Areas approximating USPS ZIP code delivery routes. Built from Census blocks. Not identical to USPS ZIP codes — some ZIP codes have no corresponding ZCTA.
| Detail | Value |
|---|---|
| Features | 33,791 |
| Source | U.S. Census Bureau, Cartographic Boundary Files |
| Vintage | 2024 |
| Update cycle | Annual |
| ID property | GEOID20 (5-digit ZCTA code) |
Example query:
curl -s "https://api.terranode.co/v1/pip?lat=40.7128&lng=-74.006&system_dataset=us-zctas" \ -H "x-api-key: YOUR_API_KEY" | jq .Key properties: GEOID20, ALAND20, AWATER20
US Census Tracts
Section titled “US Census Tracts”Slug: us-census-tracts
Small statistical subdivisions averaging ~4,000 people each. Widely used for demographic analysis and as the geographic unit for American Community Survey data.
| Detail | Value |
|---|---|
| Features | 85,184 |
| Source | U.S. Census Bureau, Cartographic Boundary Files |
| Vintage | 2024 |
| Update cycle | Annual |
| ID property | GEOID (FIPS state+county+tract code) |
Example query:
curl -s "https://api.terranode.co/v1/pip?lat=40.7128&lng=-74.006&system_dataset=us-census-tracts" \ -H "x-api-key: YOUR_API_KEY" | jq .Key properties: STATEFP, COUNTYFP, TRACTCE, GEOID, NAME, ALAND, AWATER
US Congressional Districts
Section titled “US Congressional Districts”Slug: us-congressional
Congressional district boundaries for the 119th US Congress. Includes at-large districts for states with a single representative and non-voting delegate districts for DC and territories.
| Detail | Value |
|---|---|
| Features | 437 |
| Source | U.S. Census Bureau, Cartographic Boundary Files |
| Vintage | 2024 |
| Update cycle | After redistricting |
| ID property | GEOID (FIPS state+district code) |
Example query:
curl -s "https://api.terranode.co/v1/pip?lat=40.7128&lng=-74.006&system_dataset=us-congressional" \ -H "x-api-key: YOUR_API_KEY" | jq .Key properties: STATEFP, CD119FP, GEOID, NAMELSAD
US State Legislative Districts — Upper (Senate)
Section titled “US State Legislative Districts — Upper (Senate)”Slug: us-state-legislative-upper
State senate district boundaries for all US states. Nebraska’s unicameral legislature is included as upper chamber.
| Detail | Value |
|---|---|
| Features | 1,960 |
| Source | U.S. Census Bureau, Cartographic Boundary Files |
| Vintage | 2024 |
| Update cycle | After redistricting |
| ID property | GEOID |
Example query:
curl -s "https://api.terranode.co/v1/pip?lat=30.2672&lng=-97.7431&system_dataset=us-state-legislative-upper" \ -H "x-api-key: YOUR_API_KEY" | jq .Key properties: STATEFP, SLDUST, GEOID, NAMELSAD
US State Legislative Districts — Lower (House/Assembly)
Section titled “US State Legislative Districts — Lower (House/Assembly)”Slug: us-state-legislative-lower
State house/assembly district boundaries for all US states. Excludes Nebraska (unicameral — see upper chamber).
| Detail | Value |
|---|---|
| Features | 4,874 |
| Source | U.S. Census Bureau, Cartographic Boundary Files |
| Vintage | 2024 |
| Update cycle | After redistricting |
| ID property | GEOID |
Example query:
curl -s "https://api.terranode.co/v1/pip?lat=30.2672&lng=-97.7431&system_dataset=us-state-legislative-lower" \ -H "x-api-key: YOUR_API_KEY" | jq .Key properties: STATEFP, SLDLST, GEOID, NAMELSAD
US Metropolitan Statistical Areas (CBSAs)
Section titled “US Metropolitan Statistical Areas (CBSAs)”Slug: us-cbsa
Metropolitan and micropolitan statistical areas. Metropolitan areas have population >= 50,000; micropolitan areas have population 10,000–49,999. Defined by the Office of Management and Budget based on commuting patterns.
| Detail | Value |
|---|---|
| Features | 935 |
| Source | U.S. Census Bureau, Cartographic Boundary Files |
| Vintage | 2024 |
| Update cycle | Annual |
| ID property | GEOID (CBSA code) |
Example query:
curl -s "https://api.terranode.co/v1/pip?lat=40.7128&lng=-74.006&system_dataset=us-cbsa" \ -H "x-api-key: YOUR_API_KEY" | jq .Key properties: GEOID, NAME, NAMELSAD, LSAD
US School Districts
Section titled “US School Districts”Slug: us-school-districts
Unified school district boundaries — districts that provide education services for all grade levels.
| Detail | Value |
|---|---|
| Features | 10,891 |
| Source | U.S. Census Bureau, Cartographic Boundary Files |
| Vintage | 2024 |
| Update cycle | Annual |
| ID property | GEOID |
Example query:
curl -s "https://api.terranode.co/v1/pip?lat=40.7128&lng=-74.006&system_dataset=us-school-districts" \ -H "x-api-key: YOUR_API_KEY" | jq .Key properties: STATEFP, GEOID, NAME, LOGRADE, HIGRADE, ALAND, AWATER
More datasets on the roadmap
Section titled “More datasets on the roadmap”Additional datasets are on the roadmap.
Have a dataset you’d like to see? Email feedback@terranode.co.
Listing datasets via the API
Section titled “Listing datasets via the API”Get the full list of system datasets with metadata:
curl -s "https://api.terranode.co/v1/system-datasets" \ -H "x-api-key: YOUR_API_KEY" | jq .Get details for a specific dataset (includes the full attribute schema):
curl -s "https://api.terranode.co/v1/system-datasets/us-counties" \ -H "x-api-key: YOUR_API_KEY" | jq .