{"openapi":"3.1.0","info":{"title":"US Counties and FIPS","version":"1.0.0","description":"County FIPS codes, names, areas, populations, centroids and density from US Census Bureau data. One call, one computed answer, no accounts or API keys. Machine-payable over x402.","x-guidance":"US Counties and FIPS: County FIPS codes, names, areas, populations, centroids and density from US Census Bureau data. Use /county-lookup for a county by 5-digit FIPS or name plus state, /county-search to find counties by name, /counties-in-state to list a state, /county-nearest-to-point for counties whose centroids are nearest a coordinate, /state-summary for state totals, /fips-parse-and-validate to check and explain a FIPS code including retired codes, /counties-by-population for rankings, and /county-density for people per square mile. Each paid GET returns a computed verdict with the reasons, the source and what was NOT checked. A verdict of UNVERIFIED means a lookup failed: treat it as unknown. No account or key: pay per call in USDC over x402."},"servers":[{"url":"https://us-counties.x402tookit.com"}],"paths":{"/counties-by-population":{"get":{"operationId":"counties_by_population","summary":"Rank US counties by July 2025 population estimate, nationally or within one state; largest or smallest first.","description":"Rank US counties by July 2025 population estimate, nationally or within one state; largest or smallest first.","tags":["counties","population","ranking","census"],"parameters":[{"name":"state","in":"query","required":false,"description":"Limit to a state: FIPS, postal code or name (default: whole US)","schema":{"type":"string"}},{"name":"order","in":"query","required":false,"description":"desc (largest first, default) or asc","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Rows 1 to 100 (default 25)","schema":{"type":"integer"}},{"name":"offset","in":"query","required":false,"description":"Rows to skip (default 0)","schema":{"type":"integer"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"]},"scope":{"type":["null","string"]},"rankedCount":{"type":["null","number"]},"scopePopulation2025":{"type":["null","number"]},"offset":{"type":["null","number"]},"order":{"type":["null","string"]},"returned":{"type":["null","number"]},"truncated":{"type":["boolean","null"]},"counties":{"type":["array","null"],"items":{"type":"object","properties":{"rank":{"type":["null","number"]},"fips":{"type":["null","string"]},"name":{"type":["null","string"]},"stateUsps":{"type":["null","string"]},"population2025":{"type":["null","number"]},"shareOfScopePct":{"type":["null","number"]},"densityPerSqMiLand":{"type":["null","number"]}}}},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"RANKED","summary":"Largest in the US: Los Angeles County, CA, 9,694,934; 3144 counties ranked.","reasons":[],"scope":"United States (50 states and DC)","rankedCount":3144,"scopePopulation2025":341784857,"offset":0,"order":"desc","returned":10,"truncated":true,"counties":[{"rank":1,"fips":"06037","name":"Los Angeles County","stateUsps":"CA","population2025":9694934,"shareOfScopePct":2.84,"densityPerSqMiLand":2387.7},{"rank":2,"fips":"17031","name":"Cook County","stateUsps":"IL","population2025":5194625,"shareOfScopePct":1.52,"densityPerSqMiLand":5497.4}],"attribution":"Source: US Census Bureau 2025 Gazetteer and Vintage 2025 population estimates (public domain), snapshot 2026-10-21. Not endorsed by the Census Bureau.","degraded":false,"notChecked":["Puerto Rico (no population in the county totals file)","metro areas, cities and places","…1 more"],"source":"US Census Bureau Gazetteer 2025 + Population Estimates Vintage 2025 (public domain)","asOf":"2026-10-21T06:20:29.362Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://us-counties.x402tookit.com/counties-by-population"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://us-counties.x402tookit.com/counties-by-population"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://us-counties.x402tookit.com/counties-by-population"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://us-counties.x402tookit.com/counties-by-population"}}]}}},"/counties-in-state":{"get":{"operationId":"counties_in_state","summary":"List a state's counties or county equivalents with FIPS, population and land area; resolves FIPS, postal code or name.","description":"List a state's counties or county equivalents with FIPS, population and land area; resolves FIPS, postal code or name.","tags":["counties","state","fips"],"parameters":[{"name":"state","in":"query","required":true,"description":"State FIPS (06), postal code (CA) or name (California)","schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"name (default), fips, population or area","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Rows 1 to 300 (default 100)","schema":{"type":"integer"}},{"name":"offset","in":"query","required":false,"description":"Rows to skip (default 0)","schema":{"type":"integer"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"]},"state":{"type":["null","object"],"properties":{"fips":{"type":["null","string"]},"usps":{"type":["null","string"]},"name":{"type":["null","string"]}}},"countyCount":{"type":["null","number"]},"offset":{"type":["null","number"]},"returned":{"type":["null","number"]},"truncated":{"type":["boolean","null"]},"counties":{"type":["array","null"],"items":{"type":"object","properties":{"fips":{"type":["null","string"]},"name":{"type":["null","string"]},"population2025":{"type":["null","number"]},"landSqMi":{"type":["null","number"]},"densityPerSqMiLand":{"type":["null","number"]}}}},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"FOUND","summary":"Rhode Island (RI, FIPS 44) has 5 county equivalents in this dataset; showing 5.","reasons":[],"state":{"fips":"44","usps":"RI","name":"Rhode Island"},"countyCount":5,"offset":0,"returned":5,"truncated":false,"counties":[{"fips":"44001","name":"Bristol County","population2025":50001,"landSqMi":24.132,"densityPerSqMiLand":2072},{"fips":"44003","name":"Kent County","population2025":173495,"landSqMi":168.568,"densityPerSqMiLand":1029.2}],"attribution":"Source: US Census Bureau 2025 Gazetteer and Vintage 2025 population estimates (public domain), snapshot 2026-10-21. Not endorsed by the Census Bureau.","degraded":false,"notChecked":["independent cities or boroughs that are not counties in other datasets","retired county codes","…1 more"],"source":"US Census Bureau Gazetteer 2025 + Population Estimates Vintage 2025 (public domain)","asOf":"2026-10-21T06:20:29.614Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://us-counties.x402tookit.com/counties-in-state"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://us-counties.x402tookit.com/counties-in-state"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://us-counties.x402tookit.com/counties-in-state"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://us-counties.x402tookit.com/counties-in-state"}}]}}},"/county-density":{"get":{"operationId":"county_density","summary":"Population density of a US county per square mile and km of land, with national and state rank and US average.","description":"Population density of a US county per square mile and km of land, with national and state rank and US average.","tags":["counties","density","population","census"],"parameters":[{"name":"fips","in":"query","required":false,"description":"5-digit county FIPS, e.g. 36061 (use this or name plus state)","schema":{"type":"string"}},{"name":"name","in":"query","required":false,"description":"County name, e.g. Kings or Kings County","schema":{"type":"string"}},{"name":"state","in":"query","required":false,"description":"State FIPS, postal code or name","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"county":{"type":["null","object"],"properties":{"fips":{"type":["null","string"]},"stateFips":{"type":["null","string"]},"countyFips":{"type":["null","string"]},"name":{"type":["null","string"]},"state":{"type":["null","string"]},"stateUsps":{"type":["null","string"]},"landSqMi":{"type":["null","number"]},"waterSqMi":{"type":["null","number"]},"totalSqMi":{"type":["null","number"]},"centroid":{"type":["null","object"],"properties":{"lat":{"type":["null","number"]},"lon":{"type":["null","number"]}}},"population2025":{"type":["null","number"]},"populationBase2020":{"type":["null","number"]}}},"densityPerSqMiLand":{"type":["null","number"]},"densityPerSqKmLand":{"type":["null","number"]},"nationalRank":{"type":["null","number"]},"nationalRankOf":{"type":["null","number"]},"stateRank":{"type":["null","number"]},"stateRankOf":{"type":["null","number"]},"usAverageDensityPerSqMiLand":{"type":["null","number"]},"timesUsAverage":{"type":["null","number"]},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"COMPUTED","summary":"New York County, NY: 73,477.9 people per sq mi of land (28,370 per sq km); rank 1 of 3144 nationally.","reasons":["Density = July 1, 2025 population estimate (1,664,862) divided by land area (22.658 sq mi); water area is excluded."],"county":{"fips":"36061","stateFips":"36","countyFips":"061","name":"New York County","state":"New York","stateUsps":"NY","landSqMi":22.658,"waterSqMi":11.201,"totalSqMi":33.859,"centroid":{"lat":40.776642,"lon":-73.970187},"population2025":1664862,"populationBase2020":1694984},"densityPerSqMiLand":73477.89,"densityPerSqKmLand":28369.97,"nationalRank":1,"nationalRankOf":3144,"stateRank":1,"stateRankOf":62,"usAverageDensityPerSqMiLand":96.7,"timesUsAverage":759.67,"attribution":"Source: US Census Bureau 2025 Gazetteer and Vintage 2025 population estimates (public domain), snapshot 2026-10-21. Not endorsed by the Census Bureau.","degraded":false,"notChecked":["urban versus rural character inside the county (density is a county-wide average over land area)","daytime or seasonal population","…1 more"],"source":"US Census Bureau Gazetteer 2025 + Population Estimates Vintage 2025 (public domain)","asOf":"2026-10-21T06:20:29.878Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://us-counties.x402tookit.com/county-density"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://us-counties.x402tookit.com/county-density"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://us-counties.x402tookit.com/county-density"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://us-counties.x402tookit.com/county-density"}}]}}},"/county-lookup":{"get":{"operationId":"county_lookup","summary":"US county by 5-digit FIPS or name plus state: name, area, population, density, centroid. Census Bureau data.","description":"US county by 5-digit FIPS or name plus state: name, area, population, density, centroid. Census Bureau data.","tags":["counties","fips","census","lookup"],"parameters":[{"name":"fips","in":"query","required":false,"description":"5-digit county FIPS, e.g. 06037 (use this or name plus state)","schema":{"type":"string"}},{"name":"name","in":"query","required":false,"description":"County name, e.g. Cook or Cook County","schema":{"type":"string"}},{"name":"state","in":"query","required":false,"description":"State FIPS, postal code or name (needed with name unless the name is unique)","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"]},"fips":{"type":["null","string"]},"stateFips":{"type":["null","string"]},"countyFips":{"type":["null","string"]},"name":{"type":["null","string"]},"state":{"type":["null","string"]},"stateUsps":{"type":["null","string"]},"landSqMi":{"type":["null","number"]},"waterSqMi":{"type":["null","number"]},"totalSqMi":{"type":["null","number"]},"centroid":{"type":["null","object"],"properties":{"lat":{"type":["null","number"]},"lon":{"type":["null","number"]}}},"population2025":{"type":["null","number"]},"populationBase2020":{"type":["null","number"]},"densityPerSqMiLand":{"type":["null","number"]},"populationChangeSince2020Pct":{"type":["null","number"]},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"FOUND","summary":"Los Angeles County, California: FIPS 06037, population 9,694,934 (July 1, 2025 estimate), 4,060.29 sq mi land.","reasons":[],"fips":"06037","stateFips":"06","countyFips":"037","name":"Los Angeles County","state":"California","stateUsps":"CA","landSqMi":4060.29,"waterSqMi":689.15,"totalSqMi":4749.44,"centroid":{"lat":34.196398,"lon":-118.261862},"population2025":9694934,"populationBase2020":10017414,"densityPerSqMiLand":2387.7,"populationChangeSince2020Pct":-3.22,"attribution":"Source: US Census Bureau 2025 Gazetteer and Vintage 2025 population estimates (public domain), snapshot 2026-10-21. Not endorsed by the Census Bureau.","degraded":false,"notChecked":["boundaries (only an internal point is given)","other years' geography or population","…1 more"],"source":"US Census Bureau Gazetteer 2025 + Population Estimates Vintage 2025 (public domain)","asOf":"2026-10-21T06:20:30.142Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://us-counties.x402tookit.com/county-lookup"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://us-counties.x402tookit.com/county-lookup"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://us-counties.x402tookit.com/county-lookup"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://us-counties.x402tookit.com/county-lookup"}}]}}},"/county-nearest-to-point":{"get":{"operationId":"county_nearest_to_point","summary":"Counties whose Census centroids are nearest a latitude and longitude, with great-circle distance. Not point-in-polygon.","description":"Counties whose Census centroids are nearest a latitude and longitude, with great-circle distance. Not point-in-polygon.","tags":["counties","nearest","geo","centroid"],"parameters":[{"name":"lat","in":"query","required":true,"description":"Latitude, -90 to 90","schema":{"type":"number"}},{"name":"lon","in":"query","required":true,"description":"Longitude, -180 to 180","schema":{"type":"number"}},{"name":"limit","in":"query","required":false,"description":"Results 1 to 25 (default 5)","schema":{"type":"integer"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"query":{"type":["null","object"],"properties":{"lat":{"type":["null","number"]},"lon":{"type":["null","number"]}}},"nearest":{"type":["array","null"],"items":{"type":"object","properties":{"fips":{"type":["null","string"]},"stateFips":{"type":["null","string"]},"countyFips":{"type":["null","string"]},"name":{"type":["null","string"]},"state":{"type":["null","string"]},"stateUsps":{"type":["null","string"]},"landSqMi":{"type":["null","number"]},"waterSqMi":{"type":["null","number"]},"totalSqMi":{"type":["null","number"]},"centroid":{"type":["null","object"],"properties":{"lat":{"type":["null","number"]},"lon":{"type":["null","number"]}}},"population2025":{"type":["null","number"]},"populationBase2020":{"type":["null","number"]},"distanceKm":{"type":["null","number"]},"distanceMiles":{"type":["null","number"]}}}},"farthestKmReturned":{"type":["null","number"]},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"FOUND","summary":"Nearest county centroid: Cook County, IL (17031), 2.22 km away.","reasons":["This ranks centroid distance only. It is not a point-in-polygon test, so the nearest centroid can belong to a different county than the one containing the point."],"query":{"lat":41.8781,"lon":-87.6298},"nearest":[{"fips":"17031","stateFips":"17","countyFips":"031","name":"Cook County","state":"Illinois","stateUsps":"IL","landSqMi":944.93,"waterSqMi":689.71,"totalSqMi":1634.64,"centroid":{"lat":41.894294,"lon":-87.645455},"population2025":5194625,"populationBase2020":5279010,"distanceKm":2.22,"distanceMiles":1.38},{"fips":"17097","stateFips":"17","countyFips":"097","name":"Lake County","state":"Illinois","stateUsps":"IL","landSqMi":443.68,"waterSqMi":924.651,"totalSqMi":1368.331,"centroid":{"lat":42.185968,"lon":-87.805939},"population2025":719339,"populationBase2020":714394,"distanceKm":37.2,"distanceMiles":23.11}],"farthestKmReturned":37.89,"attribution":"Source: US Census Bureau 2025 Gazetteer and Vintage 2025 population estimates (public domain), snapshot 2026-10-21. Not endorsed by the Census Bureau.","degraded":false,"notChecked":["which county actually contains the point (the nearest centroid is often a neighbouring county for large or oddly shaped counties)","water and offshore areas","…1 more"],"source":"US Census Bureau Gazetteer 2025 + Population Estimates Vintage 2025 (public domain)","asOf":"2026-10-21T06:20:30.408Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://us-counties.x402tookit.com/county-nearest-to-point"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://us-counties.x402tookit.com/county-nearest-to-point"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://us-counties.x402tookit.com/county-nearest-to-point"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://us-counties.x402tookit.com/county-nearest-to-point"}}]}}},"/county-search":{"get":{"operationId":"county_search","summary":"Search US counties by full or partial name, optionally within one state; ranked, capped at 50.","description":"Search US counties by full or partial name, optionally within one state; ranked, capped at 50.","tags":["counties","search","fips"],"parameters":[{"name":"q","in":"query","required":true,"description":"Name or part of a name, e.g. Washington or St. Louis","schema":{"type":"string"}},{"name":"state","in":"query","required":false,"description":"Limit to a state: FIPS, postal code or name","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Results 1 to 50 (default 20)","schema":{"type":"integer"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"query":{"type":["null","object"],"properties":{"q":{"type":["null","string"]},"state":{"type":["null","string"]}}},"matches":{"type":["array","null"],"items":{"type":"object","properties":{"fips":{"type":["null","string"]},"stateFips":{"type":["null","string"]},"countyFips":{"type":["null","string"]},"name":{"type":["null","string"]},"state":{"type":["null","string"]},"stateUsps":{"type":["null","string"]},"landSqMi":{"type":["null","number"]},"waterSqMi":{"type":["null","number"]},"totalSqMi":{"type":["null","number"]},"centroid":{"type":["null","object"],"properties":{"lat":{"type":["null","number"]},"lon":{"type":["null","number"]}}},"population2025":{"type":["null","number"]},"populationBase2020":{"type":["null","number"]},"matchScore":{"type":["null","number"]}}}},"totalMatches":{"type":["null","number"]},"truncated":{"type":["boolean","null"]},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"FOUND","summary":"1 match for \"Washington\"; best: Washington County, OR (41067).","reasons":["Score: 100 exact name, 90 exact name without the type word, 70 prefix, 50 word prefix, 30 contains."],"query":{"q":"Washington","state":"OR"},"matches":[{"fips":"41067","stateFips":"41","countyFips":"067","name":"Washington County","state":"Oregon","stateUsps":"OR","landSqMi":724.272,"waterSqMi":2.362,"totalSqMi":726.634,"centroid":{"lat":45.553542,"lon":-123.097615},"population2025":611708,"populationBase2020":600368,"matchScore":90}],"totalMatches":1,"truncated":false,"attribution":"Source: US Census Bureau 2025 Gazetteer and Vintage 2025 population estimates (public domain), snapshot 2026-10-21. Not endorsed by the Census Bureau.","degraded":false,"notChecked":["places that are not counties (cities, towns, townships)","retired or renamed county names","…1 more"],"source":"US Census Bureau Gazetteer 2025 + Population Estimates Vintage 2025 (public domain)","asOf":"2026-10-21T06:20:30.673Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://us-counties.x402tookit.com/county-search"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://us-counties.x402tookit.com/county-search"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://us-counties.x402tookit.com/county-search"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://us-counties.x402tookit.com/county-search"}}]}}},"/fips-parse-and-validate":{"get":{"operationId":"fips_parse_and_validate","summary":"Split a county FIPS into state and county parts, check both exist, flag retired, legacy or zero-dropped codes.","description":"Split a county FIPS into state and county parts, check both exist, flag retired, legacy or zero-dropped codes.","tags":["fips","counties","validation","census"],"parameters":[{"name":"code","in":"query","required":true,"description":"FIPS to check, e.g. 06037, 6037 (zero dropped), 09001 (retired) or a longer GEOID","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"]},"input":{"type":["null","string"]},"attribution":{"type":["null","string"]},"level":{"type":["null","string"]},"stateFips":{"type":["null","string"]},"countyPart":{"type":["null","string"]},"county":{"type":["null","object"],"properties":{"fips":{"type":["null","string"]},"stateFips":{"type":["null","string"]},"countyFips":{"type":["null","string"]},"name":{"type":["null","string"]},"state":{"type":["null","string"]},"stateUsps":{"type":["null","string"]},"landSqMi":{"type":["null","number"]},"waterSqMi":{"type":["null","number"]},"totalSqMi":{"type":["null","number"]},"centroid":{"type":["null","object"],"properties":{"lat":{"type":["null","number"]},"lon":{"type":["null","number"]}}},"population2025":{"type":["null","number"]},"populationBase2020":{"type":["null","number"]}}},"checks":{"type":["null","object"],"properties":{"digitsOnly":{"type":["boolean","null"]},"lengthOk":{"type":["boolean","null"]},"stateExists":{"type":["boolean","null"]},"countyExists":{"type":["boolean","null"]}}},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"VALID","summary":"36061 is New York County, New York. State part 36, county part 061.","reasons":[],"input":"36061","attribution":"Source: US Census Bureau 2025 Gazetteer and Vintage 2025 population estimates (public domain), snapshot 2026-10-21. Not endorsed by the Census Bureau.","level":"county","stateFips":"36","countyPart":"061","county":{"fips":"36061","stateFips":"36","countyFips":"061","name":"New York County","state":"New York","stateUsps":"NY","landSqMi":22.658,"waterSqMi":11.201,"totalSqMi":33.859,"centroid":{"lat":40.776642,"lon":-73.970187},"population2025":1664862,"populationBase2020":1694984},"checks":{"digitsOnly":true,"lengthOk":true,"stateExists":true,"countyExists":true},"degraded":false,"notChecked":["whether the code is the right county for your records (only that it exists)","codes from other editions of the standard beyond the few retired ones listed","…1 more"],"source":"US Census Bureau Gazetteer 2025 + Population Estimates Vintage 2025 (public domain)","asOf":"2026-10-21T06:20:30.938Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://us-counties.x402tookit.com/fips-parse-and-validate"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://us-counties.x402tookit.com/fips-parse-and-validate"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://us-counties.x402tookit.com/fips-parse-and-validate"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://us-counties.x402tookit.com/fips-parse-and-validate"}}]}}},"/state-summary":{"get":{"operationId":"state_summary","summary":"State totals from county data: county count, land and water area, population, density, largest and smallest counties.","description":"State totals from county data: county count, land and water area, population, density, largest and smallest counties.","tags":["counties","state","census","population"],"parameters":[{"name":"state","in":"query","required":true,"description":"State FIPS (48), postal code (TX) or name (Texas)","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"state":{"type":["null","object"],"properties":{"fips":{"type":["null","string"]},"usps":{"type":["null","string"]},"name":{"type":["null","string"]}}},"countyCount":{"type":["null","number"]},"landSqMi":{"type":["null","number"]},"waterSqMi":{"type":["null","number"]},"population2025":{"type":["null","number"]},"populationBase2020":{"type":["null","number"]},"populationChangeSince2020Pct":{"type":["null","number"]},"densityPerSqMiLand":{"type":["null","number"]},"matchesCensusStateRow":{"type":["boolean","null"]},"mostPopulous":{"type":["null","object"],"properties":{"fips":{"type":["null","string"]},"name":{"type":["null","string"]},"population2025":{"type":["null","number"]},"landSqMi":{"type":["null","number"]}}},"leastPopulous":{"type":["null","object"],"properties":{"fips":{"type":["null","string"]},"name":{"type":["null","string"]},"population2025":{"type":["null","number"]},"landSqMi":{"type":["null","number"]}}},"largestByLandArea":{"type":["null","object"],"properties":{"fips":{"type":["null","string"]},"name":{"type":["null","string"]},"population2025":{"type":["null","number"]},"landSqMi":{"type":["null","number"]}}},"smallestByLandArea":{"type":["null","object"],"properties":{"fips":{"type":["null","string"]},"name":{"type":["null","string"]},"population2025":{"type":["null","number"]},"landSqMi":{"type":["null","number"]}}},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"SUMMARIZED","summary":"Texas: 254 county equivalents, 261,260 sq mi land, population 31,709,821 (July 1, 2025 estimate).","reasons":["The county populations sum exactly to the state total in the Census file."],"state":{"fips":"48","usps":"TX","name":"Texas"},"countyCount":254,"landSqMi":261259.965,"waterSqMi":7339.092,"population2025":31709821,"populationBase2020":29149498,"populationChangeSince2020Pct":8.78,"densityPerSqMiLand":121.4,"matchesCensusStateRow":true,"mostPopulous":{"fips":"48201","name":"Harris County","population2025":5045026,"landSqMi":1707.103},"leastPopulous":{"fips":"48301","name":"Loving County","population2025":52,"landSqMi":668.818},"largestByLandArea":{"fips":"48043","name":"Brewster County","population2025":9458,"landSqMi":6183.763},"smallestByLandArea":{"fips":"48397","name":"Rockwall County","population2025":140738,"landSqMi":127.229},"attribution":"Source: US Census Bureau 2025 Gazetteer and Vintage 2025 population estimates (public domain), snapshot 2026-10-21. Not endorsed by the Census Bureau.","degraded":false,"notChecked":["territories other than Puerto Rico","county subdivisions, places and tribal areas","…1 more"],"source":"US Census Bureau Gazetteer 2025 + Population Estimates Vintage 2025 (public domain)","asOf":"2026-10-21T06:20:31.204Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://us-counties.x402tookit.com/state-summary"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://us-counties.x402tookit.com/state-summary"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://us-counties.x402tookit.com/state-summary"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://us-counties.x402tookit.com/state-summary"}}]}}}}}