diff --git a/mcp-db/data/components-programs.csv b/mcp-db/data/components-programs.csv index 8bda01b..c27e5c5 100644 --- a/mcp-db/data/components-programs.csv +++ b/mcp-db/data/components-programs.csv @@ -1,275 +1,198 @@ -COMPONENT_STRING,COMPONENT_LABEL,COMPONENT_DESCRIPTION,API_SHORT_NAME,PROGRAM_STRING,PROGRAM_LABEL -ACSSE,1-Year Supplemental Estimates,"ACS 1-Year Supplemental Estimates extend standard 1-year ACS coverage to smaller geographic areas. Available for areas with populations of 20,000 or more (vs. 65,000+ for standard 1-year estimates), these simplified tables (K20-series) trade some detail for broader geographic reach. Released roughly one month after the standard 1-year products.",acs/acsse,ACS,American Community Survey -ACSDT5Y,Detailed Tables 5-Year,"ACS 5-Year Detailed Tables (B/C-series) pool five years of survey data and are the most geographically comprehensive ACS product-available for every area down to the census block group, regardless of population size. With 64,000+ variables, these tables provide the deepest cross-tabulations across all ACS topics.",acs/acs5,ACS,American Community Survey -ACSSPP1Y,Selected Population Profiles 1-Year,"ACS 1-Year Selected Population Profiles (SPP) provide broad social, economic, and housing summaries for race, ethnic, ancestry, and country/region-of-birth groups. Available for geographic areas with 500,000+ total population and group populations of 65,000+. Presenting data as counts and percentages across 300+ variables.",acs/acs1/spp,ACS,American Community Survey -ACSST3Y,Subject Tables 3-Year,"ACS 3-Year Subject Tables (S-series) summarize topic-level estimates for areas with 20,000+ population, pooling three years of data. Discontinued after the 2013 (2011-2013) release.",acs/acs3/subject,ACS,American Community Survey -ACSDP3Y,Data Profiles 3-Year,"ACS 3-Year Data Profiles (DP-series, 4 tables) summarize social, economic, housing, and demographic estimates for areas with 20,000+ population, pooling three years of data. Discontinued after the 2013 (2011-2013) release.",acs/acs3/profile,ACS,American Community Survey -ACSST1Y,Subject Tables 1-Year,"ACS 1-Year Subject Tables (S-series) summarize estimates by topic-such as income, commuting, or educational attainment-for a broader geographic range than detailed tables. Presenting data as both counts and percentages, they cover 66,000+ variables for areas with 65,000+ population.",acs/acs1/subject,ACS,American Community Survey -ACSPUMS1YPR,Puerto Rico Public Use Microdata Sample,"Puerto Rico Community Survey (PRCS) 1-Year PUMS contains individual-level person and housing unit records representing approximately 1% of Puerto Rico's population. Separate from the national ACS PUMS (state FIPS 72), it enables custom tabulations at the state and PUMA levels for Puerto Rico.",acs/acs1/pumspr,ACS,American Community Survey -ACSCP3Y,Comparison Profiles 3-Year,"ACS 3-Year Comparison Profiles (CP-series) compare current 3-year estimates against prior 5-year estimates with statistical significance testing, for areas with 20,000+ population. Discontinued after the 2013 (2011-2013) release. Contains 3,000+ variables.",acs/acs3/cprofile,ACS,American Community Survey -ACSCP5Y,Comparison Profiles 5-Year,"ACS 5-Year Comparison Profiles (CP-series) mirror the Data Profile format but include comparisons to prior 5-year estimates with statistical significance testing, enabling trend analysis for all geographies down to the tract level. Contains 2,400+ variables.",acs/acs5/cprofile,ACS,American Community Survey -ACSCP1Y,Comparison Profiles 1-Year,"ACS 1-Year Comparison Profiles (CP-series) mirror the Data Profile format but add year-over-year comparisons with the four preceding 1-year estimates, including statistical significance testing. Useful for tracking change over time for areas with 65,000+ population. Contains 1,000+ variables.",acs/acs1/cprofile,ACS,American Community Survey -ACSDT3Y,Detailed Tables 3-Year,"ACS 3-Year Detailed Tables (B/C-series) pooled data collected over three consecutive years to produce estimates for areas with 20,000+ population, including counties and places too small for 1-year reliability. Discontinued after the 2013 (2011-2013) release.",acs/acs3,ACS,American Community Survey -ACSCD113,1-Year Data Profile CD113,"ACS 1-Year Data Profiles for the 113th Congressional Districts provide the four standard DP-series tables (social, economic, housing, demographic) tailored to each of the 435 congressional districts as defined for the 113th Congress.",acs/acs1/cd113,ACS,American Community Survey -ACSCD115,1-Year Data Profile 115th Congressional District,"ACS 1-Year Data Profiles for the 115th Congressional Districts provide the four standard DP-series tables (social, economic, housing, demographic) tailored to each of the 435 congressional districts as defined for the 115th Congress.",acs/acs1/cd115,ACS,American Community Survey -ACSDT1Y,Detailed Tables 1-Year,"ACS 1-Year Detailed Tables (B/C-series) are the most granular ACS pre-tabulated product, offering 31,000+ cross-tabulations of demographic, social, economic, and housing characteristics. Published for areas with 65,000+ population: nation, all states, DC, Puerto Rico, congressional districts, metro areas, and qualifying counties and places.",acs/acs1,ACS,American Community Survey -ACSDP5Y,Data Profiles 5-Year,"ACS 5-Year Data Profiles (DP-series, 4 tables) provide broad social, economic, housing, and demographic summaries as both counts and percentages. Available for all geographies down to the census tract level, with 2,400+ variables. The most widely used ACS product for local-area planning and research.",acs/acs5/profile,ACS,American Community Survey -ACSFLOWS,5-Year Migration Flows,"ACS 5-Year Migration Flows derive county-level migration statistics from the ACS 'Where did you live 1 year ago?' question. The dataset provides flow estimates between state/world-region origins and current county of residence, plus supplemental geographic mobility statistics (nonmovers, inter-state movers, arrivals from abroad) for each county.",acs/flows,ACS,American Community Survey -ACSDP5YSPT,Selected Population Data Profiles 5-Year,"ACS 5-Year Selected Population Data Profiles provide DP-style summary tables for detailed race, Hispanic origin, tribal, and ancestry population groups. Released every five years for areas with sufficient group population size.",acs/acs5/sptprofile,ACS,American Community Survey -ACSPUMS1Y,Public Use Microdata Sample,ACS 1-Year Public Use Microdata Sample (PUMS) contains individual-level (person and housing unit) records representing approximately 1% of the U.S. population-with all identifying information removed. Enables custom tabulations not available in pre-tabulated products. Available at the state and Public Use Microdata Area (PUMA) levels.,acs/acs1/pums,ACS,American Community Survey -ACSDT5YSPT,Selected Population Detailed Tables 5-Year,"ACS 5-Year Selected Population Detailed Tables (SPT) provide the full range of B/C-series cross-tabulations for detailed race, Hispanic origin, tribal, and ancestry groups. Released every five years, they allow analysis of smaller population subgroups that cannot support estimates in standard detailed tables.",acs/acs5/spt,ACS,American Community Survey -ACSDP5YAIAN,American Indian and Alaska Native Data Profiles 5-Year,ACS 5-Year American Indian and Alaska Native (AIAN) Data Profiles provide DP-style summaries for tribal populations using more detailed tribal categories than standard SPT products. Released every five years.,acs/acs5/aianprofile,ACS,American Community Survey -ACSDT5YAIAN,American Indian and Alaska Native Detailed Tables 5-Year,"ACS 5-Year American Indian and Alaska Native (AIAN) Detailed Tables provide B/C-series cross-tabulations specifically for tribal populations, using more granular tribal categories than those available in the standard Selected Population Tables. Released every five years.",acs/acs5/aian,ACS,American Community Survey -ACSST5Y,Subject Tables 5-Year,"ACS 5-Year Subject Tables (S-series) provide topic-organized summaries (e.g., poverty, language, commuting) as both counts and percentages for all geographies down to the census tract. With 66,000+ variables, they offer a middle ground between data profiles and detailed tables.",acs/acs5/subject,ACS,American Community Survey -ACSSPP3Y,Selected Population Profiles 3-Year,"ACS 3-Year Selected Population Profiles (SPP) provide social, economic, and housing summaries for detailed population groups in areas with 20,000+ population. Discontinued after the 2013 (2011-2013) release.",acs/acs3/spp,ACS,American Community Survey -ACSPUMS5YPR,Puerto Rico Public Use Microdata Sample,"Puerto Rico Community Survey (PRCS) 5-Year PUMS pools five years of PRCS records, representing approximately 5% of Puerto Rico's population. Separate from the national ACS PUMS (state FIPS 72), it supports custom analyses at the state and PUMA levels for smaller Puerto Rico subpopulations.",acs/acs5/pumspr,ACS,American Community Survey -ACSEEO5Y,Equal Employment Opportunity 5-Year,"ACS 5-Year Equal Employment Opportunity (EEO) Tabulation cross-tabulates detailed occupation by sex, race, Hispanic origin, and educational attainment for the civilian employed population. Produced jointly with the EEOC, OFCCP, and OPM to support civil rights enforcement and workforce analysis. Available at multiple geography levels.",acs/acs5/eeo,ACS,American Community Survey -ACSDIMCUBE1Y,Detailed Tables 1-Year,Experimental ACS 1-Year Dimensional Cube Demonstration explores a multidimensional data model for delivering ACS detailed table estimates. This prototype format is not a production data product and is intended for evaluation of alternative API delivery methods.,acs/acsdimcube1,ACS,American Community Survey -ACSDP1Y,Data Profiles 1-Year,"ACS 1-Year Data Profiles (DP-series, 4 tables) summarize the most widely used social, economic, housing, and demographic estimates for a single geography. Presenting data as both counts and percentages, they cover 2,400+ variables for areas with 65,000+ population.",acs/acs1/profile,ACS,American Community Survey -ACSPUMS5Y,Public Use Microdata Sample,ACS 5-Year Public Use Microdata Sample (PUMS) pools five 1-year PUMS files to represent approximately 5% of the U.S. population. Individual person and housing unit records (with identifiers removed) allow custom analyses. Available at the state and PUMA levels. Larger sample enables estimates for smaller subpopulations than the 1-year PUMS.,acs/acs5/pums,ACS,American Community Survey -ECNTYPE,"Mining: Detailed Statistics by Type of Operation for the U.S., States, and Offshore Areas","Economic Census Mining Detailed Statistics by Type of Operation break down mining sector employment, payroll, and receipts by operational type (e.g., surface vs. underground mining) for the U.S., states, and offshore areas.",ecntype,ECN,Economic Census -ECNLOCMINE,"Mining: Location of Mines by Employment Size for Subsectors and Industries for the U.S., States, and Offshore Area","Economic Census Mining Location of Mines by Employment Size reports the number and distribution of mining establishments across employment size classes by NAICS subsector and industry, for the U.S., states, and offshore areas.",ecnlocmine,ECN,Economic Census -ECNLOCMFG,"Manufacturing: Location of Manufacturing Establishments by Employment Size for the U.S., States, and Counties","Economic Census Manufacturing Location of Establishments by Employment Size reports the number of manufacturing establishments distributed across employment size classes by NAICS industry, for the U.S., states, and counties.",ecnlocmfg,ECN,Economic Census -ECNMARGIN,Wholesale Trade: Gross Margin and its Components for Merchant Wholesalers for the U.S.,"Economic Census Wholesale Trade Gross Margin and Components reports gross margin, beginning and end-of-year inventories, and cost of goods sold for merchant wholesalers at the U.S. level.",ecnmargin,ECN,Economic Census -ECNNAPCSPRD,Economic Census,"Economic Census NAPCS Product-Level Statistics report product line revenue and the number of establishments carrying each NAPCS product, along with industry contributions to total product-line revenue. Covers all sectors at the U.S. level only.",ecnnapcsprd,ECN,Economic Census -ECNPATIENT,"Health Care and Social Assistance: Sales, Value of Shipments, or Revenue by Type of Patient Care for the U.S.","Economic Census Health Care and Social Assistance Revenue by Type of Patient Care reports revenue by care setting (e.g., inpatient, outpatient, emergency) for health care establishments at the U.S. level.",ecnpatient,ECN,Economic Census -ECNTYPEPAYER,"Health Care and Social Assistance: Sales, Value of Shipments, or Revenue by Type of Payer for the U.S. and States","Economic Census Health Care and Social Assistance Revenue by Type of Payer reports revenue broken down by payer category (Medicare, Medicaid, private insurance, self-pay, other government) for health care establishments at the U.S. and state levels.",ecntypepayer,ECN,Economic Census -ECNNAPCS,Economic Census,"Economic Census North American Product Classification System (NAPCS) data report revenue by detailed product line for establishments in selected sectors, linking product sales to the producing industry. Provides product-level economic detail not available in standard industry tables.",ecn/napcs,ECN,Economic Census -ECNCOMM,"Wholesale Trade: Sales and Commissions of Electronic Markets, Agents, Brokers, and Commission Merchants for the U.S.","Economic Census Wholesale Trade Sales and Commissions for Electronic Markets, Agents, Brokers, and Commission Merchants reports revenue and commission income for non-merchant wholesale intermediaries at the U.S. level.",ecncomm,ECN,Economic Census -ECNMATFUEL,"Combined version: Manufacturing and Mining: Materials Consumed and Selected Supplies, Minerals Received for Preparation, Purchased Machinery and Fuels Consumed by Type of Industry for the U.S.","Economic Census Materials Consumed, Fuels, and Purchased Machinery report the cost and type of materials, energy inputs, and capital equipment consumed by manufacturing and mining establishments at the U.S. level.",ecnmatfuel,ECN,Economic Census -ECNLINES,Economic Census US Lines Data,"Economic Census Lines of Business Data report sales/revenue by major product or service category (lines) for establishments of firms with payroll, organized by kind of business at the U.S. level.",ecnlines,ECN,Economic Census -ECNZIP,Economic Census US ZIP Code Data,"Economic Census ZIP Code Data provide establishment counts, employment, and payroll at the 5-digit ZIP code level for the entire U.S. economy, enabling fine-grained local economic analysis not available in standard county or place tables.",ecnzip,ECN,Economic Census -ECNCOMP,"All Sectors: Comparative Statistics for the U.S., States, and Selected Geographies (Previous NAICS Basis)","Economic Census Comparative Statistics compare current census results to the prior census on a consistent previous-NAICS basis, allowing change-over-time analysis of employment, payroll, and sales across sectors for the U.S., states, and selected geographies.",ecncomp,ECN,Economic Census -ECNCLCUST,"Selected Sectors: Sales, Value of Shipments, or Revenue by Class of Customer for Selected Geographies","Economic Census Sales by Class of Customer report revenue broken down by type of buyer (households, businesses, government, export) for selected sectors in the U.S. and states, revealing demand-side structure within industries.",ecnclcust,ECN,Economic Census -ECNIPA,US Industry Product Data,"Economic Census U.S. Industry Product Data tabulate sales by detailed product or service type within NAICS industries, providing product-mix information beyond headline revenue for selected industry groups.",ecnipa,ECN,Economic Census -ECNLOAN,Finance and Insurance: Type of Loan Products Income for the U.S.,"Economic Census Finance and Insurance Type of Loan Products Income reports revenue from different loan product categories (e.g., mortgages, auto loans, credit cards) for depository and non-depository credit institutions at the U.S. level.",ecnloan,ECN,Economic Census -ECNADMBEN,"Finance and Insurance: Administrative Expenses and Benefits Paid for Life, Health, and Medical Insurance Carriers for the U.S.","Economic Census Finance and Insurance Administrative Expenses and Benefits Paid for Life, Health, and Medical Insurance Carriers reports operating cost components (administrative expense ratios, benefit payments) at the U.S. level.",ecnadmben,ECN,Economic Census -ECNBRORDEAL,Finance and Insurance: Brokering or Dealing Products Income,"Economic Census Finance and Insurance Brokering or Dealing Products Income reports revenue by product type (e.g., equities, fixed income) for securities brokers and dealers at the U.S. level.",ecnbrordeal,ECN,Economic Census -ECNCCARD,Finance and Insurance: Credit Card Products Income,"Economic Census Finance and Insurance Credit Card Products Income reports revenue from credit card operations (interest, fees, interchange) for credit card issuers and processors at the U.S. level.",ecnccard,ECN,Economic Census -ECNBRANDDEAL,Finance and Insurance: Brokering and Dealing Products Income,Economic Census Finance and Insurance Brokering and Dealing Products Income is a combined version of brokering and dealing revenue by product category for securities firms at the U.S. level.,ecnbranddeal,ECN,Economic Census -ECNLABOR,"Other Services (Except Public Administration): Sales, Value of Shipments, or Revenue from Labor Charges and Parts Installed for Repair and Maintenance Services for the U.S.",Economic Census Other Services Labor Charges and Parts Installed reports revenue from labor charges and installed parts as a share of total revenue for repair and maintenance service establishments at the U.S. level.,ecnlabor,ECN,Economic Census -ECNRDOFC,"Management of Companies and Enterprises: Research and Development for Corporate, Subsidiary, and Regional Managing Offices for the U.S.","Economic Census Management of Companies R&D for Corporate and Regional Offices reports research and development expenditures and employment for corporate headquarters, subsidiary managing offices, and regional offices at the U.S. level.",ecnrdofc,ECN,Economic Census -ECNCRFIN,Finance and Insurance: Types of Credit Financing Products Income,"Economic Census Finance and Insurance Types of Credit Financing Products Income reports revenue broken down by credit product type (e.g., auto loans, student loans, personal loans) for credit intermediaries at the U.S. level.",ecncrfin,ECN,Economic Census -ECNINVVAL,Manufacturing: Method of Inventory Valuation for the U.S.,"Economic Census Manufacturing Method of Inventory Valuation reports the accounting method (FIFO, LIFO, average cost, etc.) used to value manufacturing inventories at year-end, at the U.S. level.",ecninvval,ECN,Economic Census -ECNKOB,"Construction: Value of Business Done for Kind-of-Business for the U.S., Regions, and States","Economic Census Construction Value of Business Done by Kind-of-Business reports construction activity (revenue from work put-in-place) cross-tabulated by the type of construction work performed, for the U.S., regions, and states.",ecnkob,ECN,Economic Census -ECNLIFOMINE,Mining: Inventories with LIFO Valuation for the U.S.,"Economic Census Mining Inventories with LIFO Valuation report the value of mineral inventories and the proportion valued using the Last-In, First-Out (LIFO) accounting method for mining establishments at the U.S. level.",ecnlifomine,ECN,Economic Census -ECNLOCCONS,Construction: Location of Construction Establishments by Employment Size for the U.S. and States,Economic Census Construction Location of Establishments by Employment Size reports the distribution of construction establishments across employment size classes for the U.S. and states.,ecnloccons,ECN,Economic Census -ECNMENUTYPE,Accommodation and Food Services: Subject Series - Misc Subjects: Principal Menu Type or Specialty for the U.S. and States: 2012,Economic Census Accommodation and Food Services Principal Menu Type or Specialty reports restaurant counts and revenue by cuisine or menu specialty at the U.S. and state levels (2012 data).,ecnmenutype,ECN,Economic Census -ECNSEAT,Accommodation and Food Services: Subject Series - Misc Subjects: Seating Capacity for the U.S. and States: 2012,Economic Census Accommodation and Food Services Seating Capacity reports total seating capacity and per-establishment averages by restaurant type at the U.S. and state levels (2012 data).,ecnseat,ECN,Economic Census -ECNPURELEC,Economic Census,"Economic Census Utilities Cost of Purchased Electricity reports total expenditures on purchased electricity for utilities sector establishments at the U.S. level, supporting energy cost analysis across the utilities industry.",ecnpurelec,ECN,Economic Census -ECNPURGAS,Economic Census,Economic Census Utilities Cost of Purchased Natural Gas reports total expenditures on purchased natural gas for utilities sector establishments at the U.S. level.,ecnpurgas,ECN,Economic Census -ECNCONACT,Economic Census,Economic Census Utilities and Transportation Contractual Activities reports revenue from contracted services within the utilities and transportation and warehousing sectors at the U.S. level.,ecnconact,ECN,Economic Census -ECNPETRSTAT,Wholesale Trade: Petroleum Bulk Storage Capacity by Type of Station by Type of Product for the U.S. and States,Economic Census Wholesale Trade Petroleum Bulk Storage Capacity by Type of Station reports petroleum storage capacity and product type for petroleum bulk liquid stations in the U.S. and states.,ecnpetrstat,ECN,Economic Census -ECNDIRPREM,Finance and Insurance: Direct Premiums Earned,"Economic Census Finance and Insurance Direct Premiums Earned reports premium revenue by line of insurance business (e.g., life, health, property, casualty) for insurance carriers at the U.S. level.",ecndirprem,ECN,Economic Census -ECNDISSMED,"Information: Sales, Value of Shipments, or Revenue by Type of Dissemination Media for the U.S.","Economic Census Information Sector Revenue by Type of Dissemination Media reports revenue broken down by the medium through which information products and services are delivered (e.g., print, digital, broadcast) at the U.S. level.",ecndissmed,ECN,Economic Census -ECNPROFIT,Wholesale Trade: Gross Profit and its Components for Merchant Wholesalers for the U.S.,"Economic Census Wholesale Trade Gross Profit and Components reports gross profit, operating expenses, and inventory data for merchant wholesalers at the U.S. level, complementing the gross margin series.",ecnprofit,ECN,Economic Census -ECNFRAN,Selected Sectors: Franchise Status for the U.S. and States,"Economic Census Franchise Status statistics report establishments' franchise affiliation status (franchisee, franchisor, or non-franchised) along with associated sales, payroll, and employment for selected sectors in the U.S. and states.",ecnfran,ECN,Economic Census -ECNEXPNRG,Economic Census,Economic Census Utilities Exported Energy to Canada and Mexico reports the volume and value of electricity and natural gas exported to neighboring countries by U.S. utility establishments.,ecnexpnrg,ECN,Economic Census -ECNPURMODE,Transportation and Warehousing: Cost of Purchased Transportation by Mode of Shipping for the U.S. and States,"Economic Census Transportation and Warehousing Cost of Purchased Transportation by Mode reports expenditures on outsourced transportation (truck, rail, air, water, pipeline) by transportation and warehousing establishments at the U.S. and state levels.",ecnpurmode,ECN,Economic Census -ECNFLSPACE,Economic Census,Economic Census Retail Trade Floor Space by Selected Industry reports total and per-establishment retail floor space (sq. ft.) for selected retail sectors at the U.S. level.,ecnflspace,ECN,Economic Census -ECNFOODSVC,Accommodation and Food Services: Primary Type of Food Service for the U.S. and States,"Economic Census Accommodation and Food Services Primary Type of Food Service reports establishment counts and revenue by primary service type (full-service restaurants, limited-service, catering, etc.) at the U.S. and state levels.",ecnfoodsvc,ECN,Economic Census -ECNADBNPROP,Finance and Insurance: Administrative Expenses and Losses Incurred for Property and Casualty Insurance Carriers,"Economic Census Finance and Insurance Administrative Expenses and Losses for Property and Casualty Insurance Carriers reports loss ratios, administrative costs, and claim payments for P&C insurers at the U.S. level.",ecnadbnprop,ECN,Economic Census -ECNCONCESS,Accommodation and Food Services: Subject Series - Misc Subjects: Concession Operators for the U.S. and States: 2012,Economic Census Accommodation and Food Services Concession Operators reports revenues and establishment counts for contract food service and concession operators at the U.S. and state levels (2012 data).,ecnconcess,ECN,Economic Census -ECNGUESTSIZE,Accommodation and Food Services: Subject Series - Misc Subjects: Guestroom Size of Establishments for the U.S. and States: 2012,"Economic Census Accommodation Guestroom Size of Establishments reports the distribution of lodging properties by guestroom count (small, medium, large) for the U.S. and states (2012 data).",ecnguestsize,ECN,Economic Census -ECNGRANT,"Health Care and Social Assistance: Grants, Transferred Contributions and Similar Payments, with Net Expenses for the U.S.","Economic Census Health Care and Social Assistance Grants, Transferred Contributions, and Net Expenses reports grant revenue, transferred contributions, and net program expenses for social assistance establishments at the U.S. level.",ecngrant,ECN,Economic Census -ECNHOSP,Health Care and Social Assistance: Ownership and Control of Government Hospitals for the U.S.,Economic Census Health Care Ownership and Control of Government Hospitals reports the number and operating characteristics of government-owned hospitals by level of government ownership at the U.S. level.,ecnhosp,ECN,Economic Census -ECNINSTR,Educational Services: Modes of Instruction for the U.S.,"Economic Census Educational Services Modes of Instruction reports revenue and establishment counts by instructional delivery method (in-person, online, correspondence) for educational service establishments at the U.S. level.",ecninstr,ECN,Economic Census -ECNPETRREC,Wholesale Trade: Primary Method of Receiving Petroleum Bulk Liquid Products for the U.S. and States,"Economic Census Wholesale Trade Primary Method of Receiving Petroleum Bulk Liquid Products reports the mode (pipeline, barge, rail, truck) by which bulk petroleum facilities receive product in the U.S. and states.",ecnpetrrec,ECN,Economic Census -ECNBRIDGE1,Selected Sectors: Industry Bridge Statistics on the Current NAICS Basis With Distribution Among the Previous NAICS-Based Industries for the U.S.,"Economic Census Industry Bridge Statistics (Current NAICS Basis) show how prior-census industry classifications distribute across the current NAICS structure, facilitating historical comparisons when industry definitions change between censuses.",ecnbridge1,ECN,Economic Census -ECNBRIDGE2,Selected Sectors: Industry Bridge Statistics on the Previous NAICS Basis With Distribution Among the Current NAICS-Based Industries for the U.S.,"Economic Census Industry Bridge Statistics (Previous NAICS Basis) show how current-census industry estimates distribute across the prior NAICS classification, complementing ECNBRIDGE1 for users needing backward-compatible time series.",ecnbridge2,ECN,Economic Census -ECNEXPSVC,Selected Sectors: Summary Statistics for Exported Services for the U.S.,"Economic Census Summary Statistics for Exported Services measure the volume and revenue of services sold by U.S. establishments to customers outside the United States, by NAICS industry sector.",ecnexpsvc,ECN,Economic Census -ECNENTSUP,Selected Sectors: Summary Statistics for Enterprise Support Establishments by Industry Served for the U.S.,"Economic Census Enterprise Support Establishments statistics cover auxiliary units (e.g., corporate headquarters, R&D labs) that serve their parent company rather than external customers. Reports employment, payroll, and operating expenses by industry served.",ecnentsup,ECN,Economic Census -ECNHOTEL,Accommodation and Food Services: Hotel Property Type for the U.S. and States,"Economic Census Accommodation Hotel Property Type reports number of properties, rooms, occupancy, and revenue by hotel category (e.g., extended stay, resort, boutique) at the U.S. and state levels.",ecnhotel,ECN,Economic Census -CFSPUMORIG,Commodity Flow Survey Public Use Microdata: Origin of Shipments,"Commodity Flow Survey (CFS) Public Use Microdata - Origin of Shipments provides shipment-level records (with confidentiality protection) showing commodity type, weight, value, mode of transport, and origin state for freight flows originating in each U.S. state.",cfspum/cfspumorig,ECN,Economic Census -ECNEQUIP,Transportation and Warehousing: Revenue-Generating Equipment for Passenger Transportation for the U.S. and States,"Economic Census Transportation and Warehousing Revenue-Generating Equipment reports counts of passenger transportation vehicles and equipment (e.g., buses, aircraft) by type for passenger transportation establishments at the U.S. and state levels.",ecnequip,ECN,Economic Census -ECNEOYINV,Wholesale Trade: Inventories by Valuation Method for the U.S.,"Economic Census Wholesale Trade Inventories by Valuation Method reports end-of-year inventory values and the accounting method (FIFO, LIFO, etc.) used for merchant wholesalers at the U.S. level.",ecneoyinv,ECN,Economic Census -ECNEOYINVWH,Transportation and Warehousing: Inventories by Valuation Method for Enterprise Support Establishments for the U.S.,Economic Census Transportation and Warehousing Inventories by Valuation Method for Enterprise Support Establishments reports end-of-year inventory values and accounting method for auxiliary warehousing and distribution units.,ecneoyinvwh,ECN,Economic Census -ECNEMPFUNC,Wholesale Trade: Employment by Primary Function for the U.S.,"Economic Census Wholesale Trade Employment by Primary Function breaks down employment into functional categories (e.g., sales, warehousing, delivery) for merchant wholesaler establishments at the U.S. level.",ecnempfunc,ECN,Economic Census -ECNLIFOMFG,Manufacturing: Inventories with LIFO Valuation for the U.S.,"Economic Census Manufacturing Inventories with LIFO Valuation report the value of manufacturing inventories and the proportion valued using the Last-In, First-Out (LIFO) accounting method at the U.S. level.",ecnlifomfg,ECN,Economic Census -ECNPETRPROD,Wholesale Trade: Petroleum Bulk Storage Capacity by Type of Product and Storage Capacity Size for the U.S. and States,Economic Census Wholesale Trade Petroleum Bulk Storage Capacity by Product and Size reports storage capacity cross-tabulated by product type and total capacity size class for petroleum bulk liquid facilities.,ecnpetrprod,ECN,Economic Census -ECNVALCON,Construction: Value of Construction Work for Location of Construction Work for U.S. and States,"Economic Census Construction Value of Work by Location reports the value of construction performed at the worksite location (where the work was done, not where the firm is headquartered) for the U.S. and states.",ecnvalcon,ECN,Economic Census -ECNELMENU,Accommodation and Food Services: Establishments Using Electronic Devices for Self-Service Table Orders and/or Payment for the U.S. and States,"Economic Census Accommodation and Food Services Electronic Self-Service Ordering and Payment reports the number of food service establishments using electronic kiosk, tableside tablet, or other self-service technology at the U.S. and state levels.",ecnelmenu,ECN,Economic Census -ECNCASHADV,Other Services (Except Public Administration) : Subject Series - Misc Subjects: Receipts/Revenue from Repayments of Cash Advances for the U.S.: 2012,Economic Census Other Services Receipts from Cash Advance Repayments reports revenue from the repayment of cash advances issued by check cashing and similar financial service establishments at the U.S. level (2012 data).,ecncashadv,ECN,Economic Census -ECNNAPCSIND,Economic Census,"Economic Census NAPCS Industry-Level Statistics report product line detail cross-tabulated by NAICS industry, showing revenue and establishment counts for each product-industry combination.",ecnnapcsind,ECN,Economic Census -ECNPETRFAC,Wholesale Trade: Petroleum Bulk Storage Capacity by Type of Facility and Type of Product for the U.S. and States,"Economic Census Wholesale Trade Petroleum Bulk Storage Capacity by Facility Type and Product reports storage capacity by both the type of facility (terminal, bulk plant, farm) and petroleum product type.",ecnpetrfac,ECN,Economic Census -ECNSIZE,Economic Census: Establishment and Firm Size Statistics for the U.S.,"Economic Census Establishment and Firm Size Statistics cross-tabulate business activity by employment size class and revenue size class, enabling analysis of the size distribution of U.S. establishments and firms within NAICS industries.",ecnsize,ECN,Economic Census -ECNSOCIAL,"Health Care and Social Assistance: Sales, Value of Shipments, or Revenue by Type of Social Assistance for the U.S.","Economic Census Health Care and Social Assistance Revenue by Type of Social Assistance reports revenue broken down by type of social service provided (e.g., individual/family services, vocational rehabilitation) at the U.S. level.",ecnsocial,ECN,Economic Census -ECNTYPOP,Wholesale Trade: Detailed Type of Operation for the U.S.,"Economic Census Wholesale Trade Detailed Type of Operation reports sales and establishment counts by specific operational type within wholesale trade (e.g., cash-and-carry, rack jobbers) at the U.S. level.",ecntypop,ECN,Economic Census -ECNLIFOVAL,Management of Companies and Enterprises: Subject Series - Misc Subjects: Inventories with LIFO Valuation for the U.S.: 2012 and 2011,Economic Census Management of Companies Inventories with LIFO Valuation reports inventory values and LIFO usage for management holding companies at the U.S. level (2012 and 2011 data).,ecnlifoval,ECN,Economic Census -ECNGUEST,Accommodation and Food Services: Subject Series - Misc Subjects: Number of Guestrooms for the U.S. and States: 2012,Economic Census Accommodation Number of Guestrooms reports total guestroom inventory by number-of-rooms size class for accommodation establishments at the U.S. and state levels (2012 data).,ecnguest,ECN,Economic Census -ECNMEALCOST,Accommodation and Food Services: Subject Series - Misc Subjects: Average Cost Per Meal for the U.S. and States: 2012,Economic Census Accommodation and Food Services Average Cost Per Meal reports average customer expenditure per meal by type of food service establishment at the U.S. and state levels (2012 data).,ecnmealcost,ECN,Economic Census -ECNRDACQ,Management of Companies and Enterprises: Subject Series - Miscellaneous Subjects: Summary Statistics for Research and Development Acquisition for Selected Industries for the U.S.: 2012,Economic Census Management of Companies R&D Acquisition Statistics report expenditures on externally acquired R&D for selected management holding company industries at the U.S. level (2012 data).,ecnrdacq,ECN,Economic Census -ECNBASIC,"Summary Statistics for the U.S., States, and Selected Geographies: 2022","Economic Census Summary Statistics for the U.S., States, and Selected Geographies provide the core business activity measures-number of establishments, sales/revenue, payroll, and employment-by NAICS industry sector at national, state, metro, county, and place levels. The primary entry point for Economic Census data.",ecnbasic,ECN,Economic Census -ZBP,Zipcode Business Patterns,"ZIP Code Business Patterns (ZBP) provide annual establishment counts, employment size distributions, and payroll by NAICS industry at the 5-digit ZIP code level. Useful for local market research, service-area analysis, and economic development planning at fine geographic granularity.",zbp,ANN,Annual Economic Surveys -PEPPRCAGESEX,Puerto Rico Commonwealth Estimates by Single Year of Age and Sex,"PEP Puerto Rico Commonwealth Estimates by Single Year of Age and Sex provide fine-grained annual age-sex breakdowns for Puerto Rico's total resident population, supporting actuarial, demographic, and program planning analyses for the territory.",pep/prcagesex,PEP,Population Estimates -PEPCTY,County Total Population and Components of Change,"PEP County Total Population and Components of Change estimates provide annual resident population counts and the four components of change (births, deaths, net domestic migration, net international migration) for every U.S. county.",pep/cty,PEP,Population Estimates -PEPCOCHAR6,"County Population Estimates by 5 Year Age Groups, Sex, 6 Races, and Hispanic Origin","PEP County Population Estimates by 5-Year Age Groups, Sex, 6 Races, and Hispanic Origin provide annual county-level demographic breakdowns using a 6-race classification that adds Native Hawaiian and Other Pacific Islander as a separate category. Supports detailed minority population analyses.",pep/cochar6,PEP,Population Estimates -PEPCOCHAR5,"County Population Estimates by 5 Year Age Groups, Sex, 5 Races, and Hispanic Origin","PEP County Population Estimates by 5-Year Age Groups, Sex, 5 Races, and Hispanic Origin provide detailed annual demographic breakdowns at the county level, using a 5-race classification (White, Black, AIAN, Asian, NHOPI). Used for program planning and civil rights compliance.",pep/cochar5,PEP,Population Estimates -PEPPRMAGESEX,Puerto Rico Municipios Estimates by 5-Year Age Groups and Sex,"PEP Puerto Rico Municipios Estimates by 5-Year Age Groups and Sex provide annual demographic breakdowns for each of Puerto Rico's 78 municipios, enabling sub-territorial age-sex analyses.",pep/prmagesex,PEP,Population Estimates -PEPPRM,Puerto Rico Municipios Total Population,"PEP Puerto Rico Municipios Total Population estimates provide annual resident population counts for each of Puerto Rico's 78 municipios, the primary administrative subdivisions of the territory.",pep/prm,PEP,Population Estimates -PEPSTCHAR5,"State Population Estimates by Single Year of Age, Sex, 5 Races, and Hispanic Origin","PEP State Population Estimates by Single Year of Age, Sex, 5 Races, and Hispanic Origin provide detailed annual demographic breakdowns at the state level using single-year age groups and a 5-race classification.",pep/stchar5,PEP,Population Estimates -PEPAGESPECIAL5,"National, State, County Annual Resident Population Estimates by Age Groups, Sex, 5 Races, and Hispanic Origin","PEP National/State/County Annual Resident Population Estimates by Age Groups, Sex, 5 Races, and Hispanic Origin provide cross-tabulated demographic estimates across multiple geography levels in a single combined file using 5-race classification.",pep/agespecial5,PEP,Population Estimates -PEPAGESPECIAL6,"National, State, County Annual Resident Population Estimates by Age Groups, Sex, 6 Races, and Hispanic Origin","PEP National/State/County Annual Resident Population Estimates by Age Groups, Sex, 6 Races, and Hispanic Origin provide cross-tabulated demographic estimates across multiple geography levels in a single combined file using 6-race classification.",pep/agespecial6,PEP,Population Estimates -PEPSTCHAR6,"State Population Estimates by Single Year of Age, Sex, 6 Races, and Hispanic Origin","PEP State Population Estimates by Single Year of Age, Sex, 6 Races, and Hispanic Origin provide detailed annual demographic breakdowns at the state level using single-year age groups and a 6-race classification.",pep/stchar6,PEP,Population Estimates -PEPMONTHLYNATCHAR5,"National Monthly Population Estimates by Single Year of Age , Sex, 5 Races, Hispanic Origin, and Universe","PEP National Monthly Population Estimates by Single Year of Age, Sex, 5 Races, Hispanic Origin, and Universe provide sub-annual (monthly) national demographic estimates-useful for tracking rapid population changes or reconciling with vital statistics data.",pep/monthlynatchar5,PEP,Population Estimates -PEPMONTHLYNATCHAR6,"National Monthly Population Estimates by Single Year of Age, Sex, 6 Races, Hispanic Origin, and Universe","PEP National Monthly Population Estimates by Single Year of Age, Sex, 6 Races, Hispanic Origin, and Universe are the 6-race counterpart to PEPMONTHLYNATCHAR5, providing monthly national demographic estimates with added NHOPI race detail.",pep/monthlynatchar6,PEP,Population Estimates -PEPAGESPECIALPR,Puerto Rico Commonwealth and Municipios Annual Resident Population Estimates by Age Groups and Sex,PEP Puerto Rico Commonwealth and Municipios Annual Resident Population Estimates by Age Groups and Sex provide a combined file covering both territory-wide and municipio-level annual demographic estimates for Puerto Rico.,pep/agespecialpr,PEP,Population Estimates -PEPUSDAILY,US Daily Population and Components of Change Increments,"PEP U.S. Daily Population and Components of Change Increments provide daily estimates of the national resident population and its incremental changes from births, deaths, and net migration-used for real-time population clock applications.",pep/daily,PEP,Population Estimates -PEPINTERCENSALHOUSING,Housing Units,"PEP Intercensal Housing Units estimates provide revised annual housing unit counts for states and counties for the intercensal period, reconciled between two decennial censuses to correct for revisions made after the initial estimate release.",pep/int_housingunits,PEP,Population Estimates -PEPAGESEX,National Annual Resident Population Estimates by Single Year of Age and Sex,"PEP National Annual Resident Population Estimates by Single Year of Age and Sex provide fine-grained age-sex distributions for the national resident population for each year between censuses, supporting life-table calculations, program eligibility modeling, and demographic analysis.",pep/agesex,PEP,Population Estimates -PEPINTERCENSALCHARAGEGROUPS,"County Estimates by 5 Year Age Groups, Race by Sex, and Hispanic Origin","PEP Intercensal County Estimates by 5-Year Age Groups, Race by Sex, and Hispanic Origin provide revised annual county-level demographic estimates for the intercensal period, reconciling forward and backward projections between two censuses.",pep/int_charagegroups,PEP,Population Estimates -PEPSUBCTY,Subcounty Population Places and MCDs,"PEP Subcounty Population Estimates cover all legally incorporated places and minor civil divisions (MCDs), providing annual resident population counts below the county level for cities, towns, villages, and townships.",pep/subcty,PEP,Population Estimates -PEPINTERCENSALNATRESAFO,United States Resident plus Armed Forces Overseas Population Estimates by Age and Sex,"PEP Intercensal United States Resident plus Armed Forces Overseas (RESAFO) Population Estimates by Age and Sex include both the domestic resident population and U.S. military and federal civilian employees stationed overseas, for intercensal years.",pep/int_natresafo,PEP,Population Estimates -PEPINTERCENSALNATCIVPOP,United States Civilian Population Estimates by Age and Sex,"PEP Intercensal United States Civilian Population Estimates by Age and Sex exclude active-duty military from the national population total, providing a civilian-only series for intercensal years. Useful for labor force and program eligibility analyses.",pep/int_natcivpop,PEP,Population Estimates -PEPINTERCENSALNATRESPOP,United States Resident Population Estimates by Age and Sex,"PEP Intercensal United States Resident Population Estimates by Age and Sex provide revised annual national age-sex distributions for the intercensal period, reconciling estimates between two successive decennial censuses.",pep/int_natrespop,PEP,Population Estimates -PEPNATSTPRC,"US, State, and PR Total Population and Components of Change","PEP national, state, and Puerto Rico total population and components of change estimates break down annual population change into births, deaths, net domestic migration, and net international migration for the nation, each state, and Puerto Rico.",pep/natstprc,PEP,Population Estimates -PEPNATSTPRC18,"US, State, and PR Population Age 18+","PEP national, state, and Puerto Rico population age 18 and older estimates provide annual counts of the adult resident population-used for apportionment, program planning, and electoral analyses.",pep/natstprc18,PEP,Population Estimates -PEPHOUSING,"Housing Unit Estimates for US, States, and Counties","PEP Housing Unit Estimates provide annual counts of total housing units for the nation, states, and counties, estimated from building permits, demolitions, and other administrative data. Distinct from occupied/vacant measures in the ACS or census.",pep/housing,PEP,Population Estimates -PEPCHARAGE,"Estimates by Age, Sex, Race, and Hispanic Origin","PEP Estimates by Age, Sex, Race, and Hispanic Origin combine detailed demographic dimensions (single-year age, sex, race, Hispanic origin) into a unified file spanning national, state, and county geographies.",pep/charage,PEP,Population Estimates -PEPNATMONTHLY,National Monthly Population,"PEP National Monthly Population provides a simplified monthly total resident population series for the nation, supporting high-frequency population tracking between annual estimate releases.",pep/natmonthly,PEP,Population Estimates -PEPPOP,Population Estimates,"Population Estimates Program (PEP) Population Estimates provide annually updated resident population counts for the nation, states, counties, and places. These are the Census Bureau's official intercensal estimates, produced using the cohort-component method combining birth, death, and migration data.",pep/population,PEP,Population Estimates -POPPROJBIRTHS,"Projected Births by Sex, Race, and Hispanic Origin for the United States: 2016-2060","Projected Births by Sex, Race, and Hispanic Origin extend projected birth counts through 2060, providing one of the three components of change (alongside deaths and migration) underlying the national population projections series.",popproj/births,POPPROJ,National Population Projections -POPPROJDEATHS,"Projected Population by Single Year of Age, Sex, Race, and Hispanic Origin for the United States: 2016-2060","Projected Deaths by Sex, Race, and Hispanic Origin extend projected death counts through 2060, providing the mortality component underlying the national population projections and enabling cause-specific mortality research.",popproj/deaths,POPPROJ,National Population Projections -POPPROJNAT,"Projected Population by Single Year of Age, Sex, Race, and Hispanic Origin, and Nativity for the United States: 2016-2060","Projected Population by Nativity (native-born vs. foreign-born), in addition to single year of age, sex, race, and Hispanic origin, through 2060. Supports analyses of immigration's contribution to future population growth.",popproj/nat,POPPROJ,National Population Projections -POPPROJNIM,"Projected Net International Migration by Single Year of Age, Sex, Race, and Hispanic Origin for the United States: 2016-2060","Projected Net International Migration by Single Year of Age, Sex, Race, and Hispanic Origin through 2060, providing the migration component underlying national population projections. Useful for immigration policy analysis.",popproj/nim,POPPROJ,National Population Projections -POPPROJPOP,"Projected Population by Single Year of Age, Sex, Race, and Hispanic Origin for the United States: 2016-2060","National Population Projections by Single Year of Age, Sex, Race, and Hispanic Origin project the resident U.S. population through 2060 under a set of fertility, mortality, and migration assumptions. The primary projections series from the Census Bureau's national projections program.",popproj/pop,POPPROJ,National Population Projections -PROJAGEGROUPS,"Projected Population by Age Group, Sex, Race, and Hispanic Origin for the United States: 2016-2060","National Population Projections by Age Group, Sex, Race, and Hispanic Origin aggregate single-year projections into broader age bands (e.g., 0-4, 5-9), making the data more accessible for program planning and policy applications.",popproj/agegroups,POPPROJ,National Population Projections -FTD14IMPEXPHIST,Historical Imports and Exports,"Historical Imports and Exports (FTD) provide long time-series of U.S. merchandise trade by commodity and country partner, compiled from historical trade statistics reports. Useful for trend analysis of U.S. trade patterns over multiple decades.",intltrade/imp_exp,IT,International Trade -SUSB,Statistics of U.S. Businesses,"Statistics of U.S. Businesses (SUSB) provide establishment-level tabulations of employment and payroll by NAICS industry, enterprise employment size class, and geography (national, state, metro, county). Widely used for analyzing the size distribution of employer businesses.",ecnsusb,SUB,Statistics of U.S. Businesses -EITSADVM3,Economic Indicators Advanced M3,"Advance Monthly Survey of Manufacturers' Shipments, Inventories and Orders (M3/ADV-M3) provides early-release monthly data on shipments, new orders, unfilled orders, and inventories for durable and nondurable goods manufacturers. A leading economic indicator for manufacturing sector activity.",timeseries/eitsadvm3,EITS,Economic Indicators -CPSMARITAL,Fertility and Marital History Supplement,"CPS Fertility and Marital History Supplement (combined) collects information on marriage and divorce history alongside birth history, enabling analysis of family formation patterns and their relationship to fertility.",cps/marital,CPS,Current Population Survey -CPSDISWORKJOBTEN,"Displaced Worker, Employee Tenure, and Occupational Mobility Supplement","CPS Displaced Worker, Employee Tenure, and Occupational Mobility Supplement covers job loss due to plant closings or layoffs (displaced workers), length of time with current employer (tenure), and occupational change. Fielded biennially in January.",cps/dwjt,CPS,Current Population Survey -CPSFERTILITY,Fertility Supplement,"CPS Fertility Supplement collects data on birth history, expected future births, and childlessness for women aged 15-50. Fielded periodically in June, it is used to estimate lifetime fertility rates and understand childbearing patterns.",cps/fertility,CPS,Current Population Survey -CPSIMMIGRATION,Immigration/Emigration Supplement,"CPS Immigration/Emigration Supplement collects detailed data on immigration history, year of entry, and emigration intentions for the foreign-born population. Used to study immigrant integration and population dynamics.",cps/immigration,CPS,Current Population Survey -CPSUNBANKED,Unbanked/Underbanked Supplement,CPS Unbanked/Underbanked Supplement (conducted for the FDIC) measures household access to mainstream banking services-checking/savings accounts-and use of alternative financial services. It is the source for the FDIC's biennial National Survey of Unbanked and Underbanked Households.,cps/unbank,CPS,Current Population Survey -CPSVOLUNTEER,Volunteering and Civic Life Supplement,"CPS Volunteering and Civic Life Supplement measures formal volunteering through organizations, informal helping activities, and civic engagement behaviors (e.g., attending community meetings). Fielded annually through a partnership with AmeriCorps.",cps/volunteer,CPS,Current Population Survey -CPSFOODSECURITY,Food Security Supplement,"CPS Food Security Supplement measures household-level food security status and hunger using a validated scale. Administered annually in December, it is the source for official USDA national and state food insecurity estimates.",cps/foodsec,CPS,Current Population Survey -POVERTY,Time Series Current Population Survey: Poverty Status,"CPS Historical Poverty Time Series provides long-running national poverty statistics derived from the Current Population Survey ASEC supplement. Data span back to the 1960s and track poverty rates by family type, race, age, and other characteristics over time.",timeseries/poverty/histpov2,CPS,Current Population Survey -CPSVETS,Veterans Supplement,"CPS Veterans Supplement collects detailed data on military service history, period of service, disability status, and service-connected disabilities for the veteran population. Fielded periodically in August.",cps/vets,CPS,Current Population Survey -CPSASEC,Annual Social and Economic (March) Supplement,"CPS Annual Social and Economic (ASEC/March) Supplement is the source for official national poverty statistics and median household income. Collected annually in March from an expanded sample (~100,000 households), it covers prior-year income, health insurance, and poverty status in detail.",cps/asec,CPS,Current Population Survey -CPSSCHOOL,School Enrollment Supplement,"CPS School Enrollment Supplement collects detailed data on enrollment status, school type (public/private), and grade level for the population 3 years and older. Fielded annually in October, it is the source for official school enrollment estimates.",cps/school,CPS,Current Population Survey -CPSBASIC,Basic Monthly,"CPS Basic Monthly Survey is the core labor force survey conducted each month for approximately 60,000 households. It produces the official national unemployment rate and major employment statistics (employed, unemployed, not in labor force) by demographic characteristics.",cps/basic,CPS,Current Population Survey -CPSINTERNET,Computer and Internet Use Supplement,"CPS Computer and Internet Use Supplement collects data on household computer ownership and internet access by connection type, speed, and device, along with individual-level internet use patterns. Key source for digital divide measurement.",cps/internet,CPS,Current Population Survey -CPSDISABILITY,Disability Supplement,"CPS Disability Supplement collects detailed disability status information including type of disability, severity, and work limitations, enabling analysis of labor force participation and economic well-being for the disabled population.",cps/disability,CPS,Current Population Survey -CPSVOTING,Voting Supplement,"CPS Voting and Registration Supplement collects self-reported voter registration and voting participation data after major federal elections, providing the source for official estimates of voter turnout by age, sex, race, citizenship, and education.",cps/voting,CPS,Current Population Survey -CPSTOBACCOUSE,Tobacco Use Supplement,"CPS Tobacco Use Supplement (TUS-CPS) is the primary source of national and state-level data on cigarette, cigar, and smokeless tobacco use for adults. Conducted three times per two-year cycle, it supports public health surveillance and tobacco control policy.",cps/tobacco,CPS,Current Population Survey -IDBSINGLEYEAR,Time Series International Database: International Populations by Single Year of Age and Sex,"International Database (IDB) Single-Year Age and Sex data provide annual population estimates and projections for all countries and territories through 2050, broken down by single year of age and sex. Used for global demographic research and international program planning.",timeseries/idb/1year,IDB,International Database -IDB5YR,Time Series International Database: International Populations by Single Year of Age and Sex,"International Database (IDB) 5-Year Age Group data aggregate IDB single-year estimates into standard 5-year age bands, providing a more manageable format for global comparative demographic analysis.",timeseries/idb/5year,IDB,International Database -PDBTRACT,Planning Database Tract Level,"Planning Database (PDB) Tract-Level file compiles ACS 5-year estimates alongside Census Bureau operational data (mail return rates, use of administrative records) at the census tract level. Designed to help survey planners identify hard-to-survey populations and target resources.",pdb/tract,PDB,Census Planning Database -PDBBLOCKGROUP,Planning Database Block Group Level,Planning Database (PDB) Block Group-Level file provides ACS 5-year estimates and operational indicators at the census block group level-the most granular geography available in the PDB-for local-area hard-to-survey population analysis.,pdb/blockgroup,PDB,Census Planning Database -PDBSTATECOUNTY,Planning Database - State and County Level,"Planning Database (PDB) State and County-Level file aggregates ACS 5-year socioeconomic estimates and census operational metrics to the county and state level, enabling state-wide and county-wide analyses of survey participation barriers.",pdb/statecounty,PDB,Census Planning Database -SAHIE,Small Area Health Insurance Estimates,"Small Area Health Insurance Estimates (SAHIE) provide annually updated estimates of health insurance coverage status for all counties and states, modeled using CPS, Medicaid/CHIP enrollment, tax, and census data. The primary source for sub-state uninsurance rates.",timeseries/healthins/sahie,SAHIE,Small Area Health Insurance Estimates -PSEOFLOWS,Post-Secondary Employment Outcomes (PSEO) - Flows,Post-Secondary Employment Outcomes (PSEO) Flows data measure the geographic mobility of graduates-tracking where they work relative to where they attended school-providing industry and state-level employment flows for postsecondary completers.,timeseries/pseo/flows,PSEO,Post-Secondary Employment Outcomes (PSEO) -PSEOEARNINGS,Post-Secondary Employment Outcomes (PSEO) - Earnings,"Post-Secondary Employment Outcomes (PSEO) Earnings data link postsecondary transcripts to longitudinal employment records to measure earnings outcomes by institution, field of study, degree level, and graduate cohort year.",timeseries/pseo/earnings,PSEO,Post-Secondary Employment Outcomes (PSEO) -DECENNIALSF1,Summary File 1,"Decennial Census Summary File 1 (SF1) contains 100-percent data-counts collected from all households-on population and housing subjects including age, sex, race, Hispanic origin, household relationship, and housing occupancy/tenure. Available at all geographic levels down to the census block.",dec/sf1,DEC,Decennial Census -DECENNIALCD113,113th Congressional District Summary File,"Decennial Census 113th Congressional District Summary File provides 100-percent population and housing counts (race, Hispanic origin, age, sex, housing tenure) tabulated to the boundaries of the 435 congressional districts as defined for the 113th Congress.",dec/cd113,DEC,Decennial Census -DECENNIALCD115,115th Congressional District Summary File,Decennial Census 115th Congressional District Summary File provides 100-percent population and housing counts tabulated to the boundaries of the 435 congressional districts as defined for the 115th Congress.,dec/cd115,DEC,Decennial Census -DECENNIALPL,Redistricting Data (PL 94-171),"Decennial Census Redistricting Data (P.L. 94-171) is the first detailed data product released after each census. Required by law within one year of Census Day, it provides race, Hispanic origin, voting-age population, housing occupancy, and group quarters counts down to the census block for use in legislative redistricting.",dec/pl,DEC,Decennial Census -DECENNIALSF3,Summary File 3,"Decennial Census Summary File 3 (SF3) contains sample (long-form) data on social, economic, and housing characteristics collected from approximately 1-in-6 households. Covers topics such as income, education, commuting, and housing costs at geography levels down to the census block group. Replaced by the ACS after 2000.",dec/sf3,DEC,Decennial Census -DECENNIALDPAIAN,American Indian and Alaska Native Demographic Profile,"Decennial Census American Indian and Alaska Native Demographic Profile provides 100-percent population and housing counts specifically for federally recognized American Indian Areas, Alaska Native Areas, and Hawaiian Home Lands.",dec/aianprofile,DEC,Decennial Census -DECENNIALCD116,116th Congressional District Summary File,Decennial Census 116th Congressional District Summary File provides 100-percent population and housing counts tabulated to the boundaries of the 435 congressional districts as defined for the 116th Congress.,dec/cd116,DEC,Decennial Census -DECENNIALDPCD110H,110th Congressional District Demographic Profile (100-Percent),Decennial Census 110th Congressional District Demographic Profile (100-Percent) presents key population and housing counts from the 100-percent (short-form) census data tabulated to 110th Congress district boundaries.,dec/cd110hprofile,DEC,Decennial Census -DECENNIALDPCD110S,110th Congressional District Demographic Profile (Sample),"Decennial Census 110th Congressional District Demographic Profile (Sample) presents social, economic, and housing estimates from the long-form sample data tabulated to 110th Congress district boundaries.",dec/cd110sprofile,DEC,Decennial Census -DECENNIALAIAN,American Indian and Alaska Native Summary File,"Decennial Census American Indian and Alaska Native Summary File provides full 100-percent detailed cross-tabulations for the population within federally recognized tribal areas, including American Indian Areas, Alaska Native Areas, and Hawaiian Home Lands.",dec/aian,DEC,Decennial Census -DECENNIALRR,Decennial Self-Response Rate,"Decennial Self-Response Rate dataset tracks the cumulative rate at which households responded to the census on their own (internet, phone, or mail) before enumerator follow-up, reported daily at the tract, county, state, and national levels during the collection period.",dec/responserate,DEC,Decennial Census -DECENNIALDPCD115,115th Congressional District Demographic Profile,"Decennial Census 115th Congressional District Demographic Profile provides a DP-style summary of social, economic, housing, and demographic characteristics for each congressional district under the 115th Congress boundary definitions.",dec/cd115profile,DEC,Decennial Census -DECENNIALDPCD113,113th Congressional District Demographic Profile,"Decennial Census 113th Congressional District Demographic Profile provides a DP-style summary of social, economic, housing, and demographic characteristics for each congressional district under the 113th Congress boundary definitions.",dec/cd113profile,DEC,Decennial Census -DECENNIALDPSLDH,State Legislative District Demographic Profile (100-Percent),Decennial Census State Legislative District Demographic Profile (100-Percent) provides key demographic and housing counts from short-form census data tabulated to upper-chamber state legislative district boundaries.,dec/sldhprofile,DEC,Decennial Census -DECENNIALSLDH,State Legislative District Summary File (100-Percent),"Decennial Census State Legislative District Summary File (100-Percent) provides detailed cross-tabulations of 100-percent data (race, age, sex, housing tenure) for upper-chamber state legislative districts.",dec/sldh,DEC,Decennial Census -DECENNIALCQR,Count Question Resolution,Decennial Count Question Resolution (CQR) program allows governments to challenge population or housing counts they believe are in error. This dataset contains population and housing unit counts before and after any corrections accepted through the CQR process.,dec/cqr,DEC,Decennial Census -DECENNIALCD110H,110th Congressional District Summary File (100-Percent),Decennial Census 110th Congressional District Summary File (100-Percent) provides detailed cross-tabulations of short-form census data for each district under 110th Congress boundary definitions.,dec/cd110h,DEC,Decennial Census -DECENNIALSF2,Summary File 2,"Decennial Census Summary File 2 (SF2) provides 100-percent population and housing counts iterated for 250 race and Hispanic origin groups, American Indian and Alaska Native tribes, and ancestry groups-enabling analysis of detailed population subgroups at geography levels down to the census tract.",dec/sf2,DEC,Decennial Census -DECENNIALTESTING,Decennial Testing Data,"Decennial Testing Data contains experimental or dress-rehearsal census counts released for research and evaluation purposes. These data are not official census counts and are intended to test questionnaire design, processing, or geographic methods ahead of a production census.",dec/testing,DEC,Decennial Census -DECENNIALPES,Decennial Post Enumeration Survey,Decennial Post-Enumeration Survey (PES) is an independent survey conducted after the census to estimate net coverage error-how many people were over- or undercounted. Results inform methodological improvements and evaluate the accuracy of decennial enumeration by demographic group and geography.,dec/pes,DEC,Decennial Census -DECENNIALDP,Demographic Profile,"Decennial Census Demographic Profile provides selected demographic and housing characteristics (age, sex, race, Hispanic origin, household type, housing tenure) for areas down to the census tract. The 2020 version is equivalent to the 2010 Demographic Profile and serves as a concise summary of census 100-percent data.",dec/dp,DEC,Decennial Census -DECENNIALTESTING2,Decennial Testing Data 2,"Decennial Testing Data 2 is a secondary experimental dataset released alongside or following Decennial Testing Data, supporting further evaluation of census methodologies, disclosure avoidance approaches, or data products under development.",dec/testing2,DEC,Decennial Census -DECENNIALDDHCA,Detailed Demographic and Housing Characteristics File A,"Decennial Census Detailed Demographic and Housing Characteristics File A (DHC-A) provides comprehensive cross-tabulations of population and housing variables-including age, sex, race, Hispanic origin, household type, and tenure-at geography levels down to the census block. The 2020 successor to prior century's SF1/SF2 detailed tables.",dec/ddhca,DEC,Decennial Census -DECENNIALPUMS1PCT,Public Use Microdata Sample - 1 Percent Sample,"Decennial Census Public Use Microdata Sample (1-Percent) contains individual-level person and housing unit records representing approximately 1% of the population, with all identifying information removed. Enables custom cross-tabulations of census 100-percent variables at the state and PUMA levels.",dec/pums1pct,DECENNIAL,Decennial Census of Population and Housing -SAIPESCHOOLDISTRICTS,Small Area Income and Poverty Estimates: School Districts,SAIPE School District Poverty Estimates provide annually updated counts and rates of children aged 5-17 in poverty for all U.S. school districts. Required by the Elementary and Secondary Education Act to allocate Title I education funding.,timeseries/poverty/saipe/schdist,SAIPE,Small Area Income and Poverty Estimates -PEPCHARAGEGROUPS,"Estimates by Age Group, Sex, Race, and Hispanic Origin","PEP Estimates by Age Group, Sex, Race, and Hispanic Origin present the same multi-variable demographic breakdowns as PEPCHARAGE but use 5-year age groups rather than single-year ages, reducing file size while retaining demographic detail.",pep/charagegroups,PEP,Population Estimates -PEPCOMPONENTS,Components of Change Estimates,"PEP Components of Change Estimates provide annual data on the four drivers of population change-births, deaths, net domestic migration, and net international migration-for the nation, states, and counties. Enables decomposition of population growth or decline by its underlying demographic components.",pep/components,PEP,Population Estimates -CPSCIVICENGAGE,Civic Engagement Supplement,"CPS Civic Engagement Supplement measures participation in community and civic activities beyond formal volunteering, such as attending public meetings, contacting officials, and participating in neighborhood groups.",cps/civic,CPS,Current Population Survey -DECENNIALDPSF3,Summary File 3 Demographic Profile,"Decennial Census Summary File 3 Demographic Profile presents a summary view of SF3 sample (long-form) social, economic, and housing estimates for areas down to the census tract, offering an accessible entry point into the full SF3 detailed tables.",dec/sf3profile,DEC,Decennial Census -DECENNIALCD110S,110th Congressional District Summary File (Sample),Decennial Census 110th Congressional District Summary File (Sample) provides long-form sample data cross-tabulations for each district under 110th Congress boundary definitions.,dec/cd110s,DEC,Decennial Census -DECENNIALDPSLDS,State Legislative District Demographic Profile (Sample),"Decennial Census State Legislative District Demographic Profile (Sample) provides social, economic, and housing estimates from long-form census data tabulated to lower-chamber state legislative district boundaries.",dec/sldsprofile,DEC,Decennial Census -SAIPESTATECOUNTY,Small Area Income and Poverty Estimates: State and County,"Small Area Income and Poverty Estimates (SAIPE) State and County file provides annually updated estimates of median household income and poverty rates for every U.S. county, state, and the nation. SAIPE combines CPS, tax, and administrative data to produce more current estimates than ACS for smaller areas.",poverty/saipe,SAIPE,Small Area Income and Poverty Estimates -DECENNIALSLDS,State Legislative District Summary File (Sample),"Decennial Census State Legislative District Summary File (Sample) provides long-form sample data cross-tabulations (social, economic, housing) for lower-chamber state legislative districts.",dec/slds,DEC,Decennial Census -DECENNIALDPSF4,Summary File 4 Demographic Profile,"Decennial Census Summary File 4 Demographic Profile presents a summary view of SF4 sample data iterated by detailed population groups, providing accessible cross-group comparisons of social, economic, and housing characteristics.",dec/sf4profile,DEC,Decennial Census -DECENNIALPLNAT,National Redistricting Data,"Decennial Census National Redistricting Data (P.L. 94-171) is the national-level version of the redistricting summary file, covering geographic units that cross state boundaries (e.g., national totals, regions, divisions). Provides the same race, Hispanic origin, voting-age, and housing occupancy counts as the state files.",dec/plnat,DEC,Decennial Census -DECENNIALDPSF2,Summary File 2 Demographic Profile,"Decennial Census Summary File 2 Demographic Profile provides a condensed view of SF2 100-percent data iterated by race and Hispanic origin groups, presenting key demographic and housing counts for areas down to the census tract.",dec/sf2profile,DEC,Decennial Census -DECENNIALSF4,Summary File 4,"Decennial Census Summary File 4 (SF4) provides sample (long-form) data iterated for detailed race and Hispanic origin groups, American Indian and Alaska Native tribes, and ancestry groups, enabling subgroup analysis of social, economic, and housing characteristics. Replaced by ACS after 2000.",dec/sf4,DEC,Decennial Census -GOVS,Public Sector Annual Surveys and Census of Governments,"Public Sector Annual Surveys and Census of Governments time series provide annual statistics on the finances (revenues, expenditures, debt) and employment of state and local governments, aggregated from annual surveys and the quinquennial Census of Governments. Key source for public finance and intergovernmental fiscal analysis.",timeseries/govs,PUB,Public Sector -BUILDINGPERMITSANNUAL,Annual Residential Building Permits,"Annual Residential Building Permits report the number of authorized new housing units by structure type (single-family, 2-4 unit, 5+ unit) at the national, state, metro, county, and permit-issuing place levels. An early indicator of housing supply and construction activity.",timeseries/buildingpermits/annual,BPSANN,Economic Indicator Programs -BUILDINGPERMITSMONTHLY,Monthly Residential Building Permits,Monthly Residential Building Permits report the number of authorized new housing units by structure type at sub-annual frequency. Used by economists as a leading indicator of residential construction and housing market conditions.,timeseries/buildingpermits/monthly,BPSMON,Economic Monthly Indicators -BUILDINGPERMITSYTD,Year To Date Residential Building Permits,"Year-to-Date Residential Building Permits aggregate monthly permit authorizations through the current month of the reference year, enabling in-year tracking of cumulative new housing supply relative to prior years.",timeseries/buildingpermits/ytd,BPSYTD,Economic Year to Date Indicators -BDSFIRMS,Firm Statistics,"Business Dynamics Statistics (BDS) Firm Statistics measure business entry, exit, expansion, and contraction at the firm level (enterprise), distinct from the establishment-level BDS series. Useful for studying firm lifecycle dynamics.",timeseries/bds/firms,BDS,Business Dynamics Statistics -ISLANDAREAS,Economic Census of Island Areas,"Economic Census of Island Areas provides the official five-year economic measure for U.S. territories (Puerto Rico, U.S. Virgin Islands, Guam, CNMI, American Samoa), covering establishments, employment, payroll, and revenue by NAICS industry.",ecn/islandareas,ECNIA,Economic Census of Island Areas -ISLANDAREASCOMP,Economic Census of Island Areas,"Economic Census of Island Areas Comparative Statistics compare current census results to the prior census for U.S. territories, enabling analysis of economic change over the five-year period by NAICS industry.",ecn/islandareas/comp,ECNIA,Economic Census of Island Areas -ISLANDAREASIND,Economic Census of Island Areas,"Economic Census of Island Areas Industry Data provide detailed NAICS-industry tabulations of establishment, employment, payroll, and revenue for individual U.S. territories.",ecn/islandareas/ind,ECNIA,Economic Census of Island Areas -ISLANDAREASLINES,Economic Census of Island Areas,"Economic Census of Island Areas Lines of Business Data report sales and revenue by major product or service line for establishments in U.S. territories, organized by kind of business.",ecn/islandareas/lines,ECNIA,Economic Census of Island Areas -ISLANDAREASNAPCS,Economic Census of Island Areas,"Economic Census of Island Areas NAPCS Data report revenue by NAPCS product line for establishments in U.S. territories, providing product-level economic detail for territorial economies.",ecn/islandareas/napcs,ECNIA,Economic Census of Island Areas -CFSHAZMAT,Commodity Flow Survey Hazmat Data,"Commodity Flow Survey (CFS) Hazardous Materials Data focus specifically on shipments of DOT-regulated hazardous materials, reporting value, weight, mode, and commodity type to support transportation safety planning and emergency preparedness.",cfshazmat,ECNSVY,Economic Surveys -ASMVALUE2017,Annual Survey of Manufactures Value,"Annual Survey of Manufactures (ASM) Value Series (2017 benchmark) provides updated manufacturing value-of-shipments, inventories, and value-added statistics anchored to the 2017 Economic Census benchmark.",timeseries/asm/value2017,ECNSVY,Economic Surveys -ASMBENCHMARK2017,Annual Survey of Manufactures Benchmark 2017,"Annual Survey of Manufactures (ASM) Benchmark 2017 provides the final benchmarked national manufacturing statistics for the 2017 ASM cycle, aligned to the 2017 Economic Census for the most accurate ASM time series.",timeseries/asm/benchmark2017,ECNSVY,Economic Surveys -ASMAREA2012,Annual Survey of Manufactures Area,"Annual Survey of Manufactures (ASM) Geographic Area Series (2012 benchmark) provides establishment counts, employment, payroll, and production statistics for manufacturing industries at state and sub-state levels, using the 2012 Economic Census as anchor.",timeseries/asm/area2012,ECNSVY,Economic Surveys -EITSQTAX,Quarterly Summary of State and Local Tax Revenue Timeseries,"Quarterly Summary of State and Local Government Tax Revenue (QTAX) provides quarterly tax collections for all 50 states and the District of Columbia, broken down by type of tax (property, sales, income, etc.). Key indicator of state fiscal capacity.",timeseries/eits/qtax,ECNSVY,Economic Surveys -CFSAREA,Commodity Flow Survey - Geographic Area Data,"Commodity Flow Survey (CFS) Geographic Area Data report shipment value, weight, and mode of transport by origin state and NAICS industry sector, providing a national picture of freight flows from every U.S. region.",cfsarea,ECNSVY,Economic Surveys -CFSTEMP,Commodity Flow Survey Temperature Data,"Commodity Flow Survey (CFS) Temperature-Controlled Shipments Data report freight shipped under refrigerated or heated conditions, covering food, pharmaceuticals, and other temperature-sensitive commodities by mode and region.",cfstemp,ECNSVY,Economic Surveys -CFSEXPORT,Commodity Flow Survey Export Data,"Commodity Flow Survey (CFS) Export Data report the characteristics of shipments destined for export (value, weight, commodity, mode, origin) from U.S. locations, linking domestic freight flows to international trade.",cfsexport,ECNSVY,Economic Surveys -VIUSA,All Vehicles,"Vehicle Inventory and Use Survey (VIUS) - All Vehicles provides detailed data on the characteristics and use of trucks operated by U.S. businesses, including fleet size, vehicle type, fuel, mileage, and cargo. Conducted periodically by the Census Bureau for DOT.",viusa,ECNSVY,Economic Surveys -CBP,County Business Patterns,"County Business Patterns (CBP) provides annual establishment counts, employment, and payroll by NAICS industry for every U.S. county, metro area, state, and the nation. Released annually, CBP is widely used for local economic analysis, market research, and policy planning.",cbp,ECNSVY,Economic Surveys -NONEMP,Nonemployer Statistics,"Nonemployer Statistics (NES) are annual data on non-farm businesses without paid employees-primarily sole proprietors and partnerships with no payroll. Covers establishment counts and receipts by NAICS industry at the national, state, and county levels.",nonemp,ECNSVY,Economic Surveys -BDS,Business Dynamics Statistics,"Business Dynamics Statistics (BDS) measure annual changes in employment and establishment counts, capturing births, deaths, expansions, and contractions of firms and establishments. Provides a unique longitudinal view of U.S. business dynamics by industry, geography, firm age, and firm size.",timeseries/bds,ECNSVY,Economic Surveys -ASMVALUE2012,Annual Survey of Manufactures Value,"Annual Survey of Manufactures (ASM) Value Series (2012 benchmark) provides value-of-shipments, inventories, and value-added estimates for manufacturing industries at national and state levels, anchored to the 2012 Economic Census benchmark.",timeseries/asm/value2012,ECNSVY,Economic Surveys -ABSTCB,Annual Business Survey,"Annual Business Survey (ABS) provides data on business ownership by race, ethnicity, gender, and veteran status, along with R&D activity, innovation, and technology use for non-farm employer businesses. Combines and replaces the Survey of Business Owners and Annual Survey of Entrepreneurs.",abstcb,ECNSVY,Economic Surveys -ASECBO,Annual Survey of Entrepreneurs Characteristics of Business Owners,"Annual Survey of Entrepreneurs (ASE) Characteristics of Business Owners provides owner demographic and socioeconomic profiles including race, gender, education, and immigration status. Predecessor to the ABS owner module.",ase/cscbo,ECNSVY,Economic Surveys -ASECB,Annual Survey of Entrepreneurs Characteristics of Businesses,"Annual Survey of Entrepreneurs (ASE) Characteristics of Businesses provides data on business financing, technology use, government contracting, and other operational characteristics for employer businesses, by owner demographics. Predecessor to the ABS.",ase/cscb,ECNSVY,Economic Surveys -ASECS,Annual Survey of Entrepreneurs Company Summary,"Annual Survey of Entrepreneurs (ASE) Company Summary provides aggregate employment, payroll, and receipts by owner race/ethnicity, gender, veteran status, and firm size. Predecessor to the ABS company summary.",ase/csa,ECNSVY,Economic Surveys -ASMBENCHMARK,Annual Survey of Manufactures Benchmark,"Annual Survey of Manufactures (ASM) Benchmark provides the most recent benchmarked national manufacturing statistics aligned to the latest Economic Census, serving as the authoritative ASM reference point.",timeseries/asm/benchmark2022,ECNSVY,Economic Surveys -CFSPRELIM,Commodity Flow Survey Preliminary Data,"Commodity Flow Survey (CFS) Preliminary Data provide early-release national totals for shipment value, weight, and ton-miles before the full geographic and commodity detail is available, offering a first look at current freight activity.",cfsprelim,ECNSVY,Economic Surveys -ABSCB,Annual Business Survey,"Annual Business Survey (ABS) Characteristics of Businesses module provides detailed data on business ownership demographics, financing, and operational characteristics for employer businesses.",abscb,ECNSVY,Economic Surveys -ABSCBO,Annual Business Survey,"Annual Business Survey (ABS) Characteristics of Business Owners module provides demographic and socioeconomic profiles of business owners (race, gender, veteran status, education, citizenship) for employer businesses.",abscbo,ECNSVY,Economic Surveys -SBOCS,Survey of Business Owners Company Summary,"Survey of Business Owners (SBO) Company Summary provides aggregate counts, receipts, payroll, and employment by owner race/ethnicity, sex, and veteran status for non-farm employer and nonemployer businesses.",sbo/cs,ECNSVY,Economic Surveys -SBOCB,Survey of Business Owners Characteristics of Business,"Survey of Business Owners (SBO) Characteristics of Business provides detailed data on business financing, contracting, and operations by owner race, ethnicity, and gender for non-farm employer businesses. The primary predecessor to the ABS.",sbo/cscb,ECNSVY,Economic Surveys -SBOCBO,Survey of Business Owners Characteristics of Business Owners,"Survey of Business Owners (SBO) Characteristics of Business Owners provides demographic profiles of business owners including race, sex, veteran status, and education for non-farm employer businesses.",sbo/cscbo,ECNSVY,Economic Surveys -VIUSPUF,Vehicle Inventory and Use Survey Public Use File,"Vehicle Inventory and Use Survey (VIUS) Public Use File contains record-level microdata (with identifying information removed) for individual trucks in the VIUS sample, enabling custom analyses of commercial vehicle characteristics and use patterns.",viuspuf,ECNSVY,Economic Surveys -ASMAREA2017,Annual Survey of Manufactures Area,"Annual Survey of Manufactures (ASM) Geographic Area Series (2017 benchmark) provides state and sub-state manufacturing statistics (employment, payroll, shipments) using the 2017 Economic Census as anchor.",timeseries/asm/area2017,ECNSVY,Economic Surveys -EITSQSPP,Time Series Economic Indicators Time Series: Quarterly Survey of Public Pensions,"Quarterly Survey of Public Pensions (QSPP) measures quarterly assets, liabilities, revenue, and expenditures of state and local government retirement systems. Provides timely data on the fiscal health of public pension funds.",timeseries/eits/qspp,ECNSVY,Economic Surveys -ITMONTHLYEXPORTSENDUSE,Time Series International Trade: Monthly U.S. Exports by End-use Code,"Monthly U.S. Exports by End-Use Code classify goods exports by the Bureau of Economic Analysis end-use category (capital goods, consumer goods, industrial supplies, etc.), providing an economic-purpose view of export composition.",timeseries/intltrade/exports/enduseexport,ECNSVY,Economic Surveys -ABSCS,Annual Business Survey,"Annual Business Survey (ABS) Company Summary module provides aggregate employment, payroll, and receipts by race/ethnicity, gender, veteran status, and firm size at national and state levels.",abscs,ECNSVY,Economic Surveys -ITMONTHLYEXPORTSHITECH,Monthly U.S. Exports by Advanced Technology Code,"Monthly U.S. Exports by Advanced Technology Code report exports of products classified as high-tech under the BEA technology classification, enabling tracking of U.S. technology export trends.",timeseries/intltrade/exports/hitech,ECNSVY,Economic Surveys -ITMONTHLYEXPORTSHS,Time Series International Trade: Monthly U.S. Exports by Harmonized System (HS) Code,Monthly U.S. Exports by Harmonized System (HS) Code provide the most detailed commodity-level view of U.S. merchandise exports using the international HS classification system.,timeseries/intltrade/exports/hsexport,ECNSVY,Economic Surveys -ITMONTHLYEXPORTSNAICS,Monthly U.S. Exports by North American Industry Classification System (NAICS) Code,"Monthly U.S. Exports by NAICS Industry Code cross-reference merchandise exports to the producing industry using NAICS codes, bridging trade and production statistics.",timeseries/intltrade/exports/naics,ECNSVY,Economic Surveys -ITMONTHLYEXPORTSPORTHS,Monthly U.S. Exports by Port and Harmonized System (HS) Code,"Monthly U.S. Exports by Port and HS Code provide export statistics at the district/port of export level combined with HS commodity codes, supporting port-level trade analysis.",timeseries/intltrade/exports/porths,ECNSVY,Economic Surveys -ITMONTHLYEXPORTSSITC,Monthly U.S. Exports by Standard International Trade Classification (SITC) Code,"Monthly U.S. Exports by Standard International Trade Classification (SITC) Code provide exports in the UN-standard SITC classification, enabling international comparisons of U.S. trade patterns.",timeseries/intltrade/exports/sitc,ECNSVY,Economic Surveys -ITMONTHLYEXPORTSSTATEHS,Monthly U.S. Exports by State and Harmonized System (HS) Code,"Monthly U.S. Exports by State and HS Code report the origin state of export goods combined with HS commodity codes, linking sub-national production geography to international trade flows.",timeseries/intltrade/exports/statehs,ECNSVY,Economic Surveys -ITMONTHLYEXPORTSSTATENAICS,Monthly U.S. Exports by State and North American Industry Classification System (NAICS),"Monthly U.S. Exports by State and NAICS Code report export values by the origin state of the exporting industry using NAICS codes, enabling state-level export performance analysis by industry.",timeseries/intltrade/exports/statenaics,ECNSVY,Economic Surveys -ITMONTHLYEXPORTSUSDA,Monthly U.S. Exports by Department of Agriculture Code,"Monthly U.S. Exports by USDA Agricultural Code report agricultural commodity exports using the USDA's own classification system, supporting agricultural trade policy and market analysis.",timeseries/intltrade/exports/usda,ECNSVY,Economic Surveys -ITMONTHLYIMPORTSENDUSE,Monthly U.S. Imports by End-use Code,"Monthly U.S. Imports by End-Use Code classify goods imports by economic purpose (capital goods, consumer goods, industrial supplies, etc.), providing a BEA-category view of import composition.",timeseries/intltrade/imports/enduse,ECNSVY,Economic Surveys -ITMONTHLYIMPORTSHITECH,Monthly U.S. Imports by Advanced Technology Code,"Monthly U.S. Imports by Advanced Technology Code report imports of high-tech products under the BEA technology classification, enabling tracking of technology trade balances.",timeseries/intltrade/imports/hitech,ECNSVY,Economic Surveys -ITMONTHLYIMPORTSHS,Monthly U.S. Imports by Harmonized System (HS) Code,Monthly U.S. Imports by Harmonized System (HS) Code provide the most detailed commodity-level view of U.S. merchandise imports using the international HS classification.,timeseries/intltrade/imports/hs,ECNSVY,Economic Surveys -ITMONTHLYIMPORTSNAICS,Monthly U.S. Imports by North American Industry Classification System (NAICS) Code,"Monthly U.S. Imports by NAICS Industry Code cross-reference merchandise imports to the consuming industry, bridging trade and production statistics for import-demand analysis.",timeseries/intltrade/imports/naics,ECNSVY,Economic Surveys -ITMONTHLYIMPORTSPORTHS,Monthly U.S. Imports by Port and Harmonized System (HS) Code,"Monthly U.S. Imports by Port and HS Code provide import statistics at the district/port-of-entry level combined with HS commodity codes, supporting port-level trade analysis.",timeseries/intltrade/imports/porths,ECNSVY,Economic Surveys -ITMONTHLYIMPORTSSITC,Monthly U.S. Imports by Standard International Trade Classification (SITC) Code,"Monthly U.S. Imports by SITC Code provide imports in the UN-standard SITC classification, enabling international comparisons of U.S. import patterns.",timeseries/intltrade/imports/sitc,ECNSVY,Economic Surveys -ITMONTHLYIMPORTSSTATEHS,Monthly U.S. Imports by State and Harmonized System (HS) Code,"Monthly U.S. Imports by State of Destination and HS Code link import flows to the U.S. state where goods are ultimately consumed or processed, combined with HS commodity detail.",timeseries/intltrade/imports/statehs,ECNSVY,Economic Surveys -ITMONTHLYIMPORTSSTATENAICS,Monthly U.S. Imports by State and North American Industry Classification System (NAICS),"Monthly U.S. Imports by State of Destination and NAICS Code link import flows to the destination state using industry codes, supporting sub-national import demand analysis.",timeseries/intltrade/imports/statenaics,ECNSVY,Economic Surveys -ITMONTHLYIMPORTSUSDA,Monthly U.S. Imports by Department of Agriculture Code,"Monthly U.S. Imports by USDA Agricultural Code report agricultural commodity imports under the USDA classification, supporting agricultural trade policy and food security analysis.",timeseries/intltrade/imports/usda,ECNSVY,Economic Surveys -DECENNIALSF1ES,Compendio de Datos 1 (SF1),"Compendio de Datos 1 (SF1) is the Spanish-language version of the Decennial Census Summary File 1 100-percent data for Puerto Rico, providing population and housing counts by age, sex, race, and Hispanic origin down to the census block.",es/dec/sf1,DECIA,Decennial Census of Island Areas -DECENNIALAS,American Samoa Summary File,"Decennial Census American Samoa Summary File provides 100-percent population and housing counts for American Samoa, including age, sex, race, and housing tenure at all available geographic levels within the territory.",dec/as,DECIA,Decennial Census of Island Areas -DECENNIALYOEMP,Commonwealth of the Northern Mariana Islands Year of Entry File,"Decennial Census Commonwealth of the Northern Mariana Islands Year of Entry File provides population counts cross-tabulated by year of entry into the CNMI, enabling analysis of migration patterns and resident tenure within the territory.",dec/mpyoe,DECIA,Decennial Census of Island Areas -DECENNIALYOEGU,Guam Year of Entry File,"Decennial Census Guam Year of Entry File provides population counts cross-tabulated by year of entry into Guam, enabling analysis of migration patterns and length of residence within the territory.",dec/guyoe,DECIA,Decennial Census of Island Areas -DECENNIALYOEAS,American Samoa Year of Entry File,"Decennial Census American Samoa Year of Entry File provides population counts cross-tabulated by year of entry into American Samoa, supporting analysis of migration flows and length of residence within the territory.",dec/asyoe,DECIA,Decennial Census of Island Areas -DECENNIALMP,Commonwealth of the Northern Mariana Islands Summary File,Decennial Census Commonwealth of the Northern Mariana Islands (CNMI) Summary File provides 100-percent population and housing counts for CNMI at all available geographic levels within the territory.,dec/mp,DECIA,Decennial Census of Island Areas -DECENNIALGU,Guam Summary File,"Decennial Census Guam Summary File provides 100-percent population and housing counts for Guam, including age, sex, race, and housing characteristics at all available geographic levels within the territory.",dec/gu,DECIA,Decennial Census of Island Areas -DECENNIALVI,U.S. Virgin Islands Summary File,"Decennial Census U.S. Virgin Islands Summary File provides 100-percent population and housing counts for the U.S. Virgin Islands at all available geographic levels, including age, sex, race, Hispanic origin, and housing tenure.",dec/vi,DECIA,Decennial Census of Island Areas -DECENNIALCROSSTABVI,U.S. Virgin Islands Detailed Crosstabulations,Decennial Census U.S. Virgin Islands Detailed Crosstabulations provide additional multi-way cross-tabulations of population and housing characteristics for the U.S. Virgin Islands beyond those available in the standard summary file.,dec/crosstabvi,DECIA,Decennial Census of Island Areas -SOMA,Survey of Market Absorption,"Survey of Market Absorption (SOMA) tracks how quickly newly completed apartments are rented in the private rental market. Provides quarterly absorption rates by rent level and number of bedrooms for the U.S., regions, and selected metro areas, supporting rental housing market analysis.",timeseries/soma,SOMA,Survey of Market Absorption -AHSHC,American Housing Survey Housing Costs,"AHS Housing Costs tabulation presents detailed owner and renter housing cost data derived from the American Housing Survey, including mortgage payments, insurance, taxes, utilities, and rent, used to measure affordability and cost burden.",ahs/hc,AHS,American Housing Survey -AHS10,American Housing Survey Housing Costs,"AHS 2010 wave dataset contains the American Housing Survey data collected in 2010, covering structural characteristics, neighborhood conditions, move history, and housing costs for the national housing stock panel.",ahs/10,AHS,American Housing Survey -AHS,American Housing Survey,"American Housing Survey (AHS) is the most comprehensive national housing survey, collecting data biennially on structural characteristics, neighborhood quality, housing costs, move history, and occupant characteristics. It follows a fixed panel of housing units rather than a fresh sample each round.",ahs,AHS,American Housing Survey -AHSHCST,American Housing Survey Housing Costs,AHS Housing Costs Statistics tabulation provides summary statistics on housing cost burden-the share of income devoted to housing-and related cost variables from the American Housing Survey.,ahs/hcst,AHS,American Housing Survey -AHSPWSD,"American Housing Survey Plumbing, Water, and Sewage Disposal","AHS Plumbing, Water, and Sewage Disposal tabulation reports on access to complete plumbing facilities, the primary source of water supply, and sewage disposal method from the American Housing Survey. Used to monitor substandard housing conditions.",ahs/pwsd,AHS,American Housing Survey -SIPP2008CORE,Core,"Survey of Income and Program Participation (SIPP) 2008 Panel Core data are longitudinal household interview records tracking income, program participation, employment, and family dynamics over multiple years. The 2008 panel followed households through 2013 using quarterly interviews.",sipp/core,SIPP,Survey of Income and Program Participation -HHPULSE,High Frequency Social and Economic Data,"Household Pulse Survey (HPS) is an experimental high-frequency online survey measuring how the COVID-19 pandemic and its aftermath affected households across social and economic dimensions-employment, food sufficiency, housing stability, mental health, and access to health care. Released weekly or biweekly in rotating phases.",timeseries/hhpulse,HPS,Household Pulse Survey -GEOINFO,Geography Information,"Geographic Information (GEOINFO) provides reference data on Census geographic units-including FIPS codes, names, geographic types, and vintage information-for all summary levels used across Census Bureau data products. Used to look up and validate geography identifiers for API queries.",geoinfo,GEO,Geography -CRE,Community Resilience Estimates,"Community Resilience Estimates (CRE) measure the capacity of communities to absorb, endure, and recover from adverse situations. The CRE assigns estimated risk factor counts to every census tract based on social vulnerability indicators from ACS data, supporting disaster preparedness and public health response planning.",cre,CRE,Community Resilience Estimates +COMPONENT_STRING,COMPONENT_LABEL,COMPONENT_DESCRIPTION,API_SHORT_NAME,PROGRAM_STRING,PROGRAM_LABEL,FREQUENCY,FREQUENCY_NOTES,PROGRAM_DESCRIPTION +ACSSE,1-Year Supplemental Estimates,"ACS 1-Year Supplemental Estimates extend standard 1-year ACS coverage to smaller geographic areas. Available for areas with populations of 20,000 or more (vs. 65,000+ for standard 1-year estimates), these simplified tables (K20-series) trade some detail for broader geographic reach. Released roughly one month after the standard 1-year products.",acs/acsse,ACS,American Community Survey,annual,"Supplemental estimates covering geographies with populations 20,000–65,000, which fall below the main 1-year threshold.","Annual household survey covering demographics, income, education, housing, and commuting for all U.S. geographies. The primary source for small-area socioeconomic estimates between decennial censuses." +ACSDT5Y,Detailed Tables 5-Year,"ACS 5-Year Detailed Tables (B/C-series) pool five years of survey data and are the most geographically comprehensive ACS product-available for every area down to the census block group, regardless of population size. With 64,000+ variables, these tables provide the deepest cross-tabulations across all ACS topics.",acs/acs5,ACS,American Community Survey,annual,,"Annual household survey covering demographics, income, education, housing, and commuting for all U.S. geographies. The primary source for small-area socioeconomic estimates between decennial censuses." +ACSSPP1Y,Selected Population Profiles 1-Year,"ACS 1-Year Selected Population Profiles (SPP) provide broad social, economic, and housing summaries for race, ethnic, ancestry, and country/region-of-birth groups. Available for geographic areas with 500,000+ total population and group populations of 65,000+. Presenting data as counts and percentages across 300+ variables.",acs/acs1/spp,ACS,American Community Survey,annual,,"Annual household survey covering demographics, income, education, housing, and commuting for all U.S. geographies. The primary source for small-area socioeconomic estimates between decennial censuses." +ACSST3Y,Subject Tables 3-Year,"ACS 3-Year Subject Tables (S-series) summarize topic-level estimates for areas with 20,000+ population, pooling three years of data. Discontinued after the 2013 (2011-2013) release.",acs/acs3/subject,ACS,American Community Survey,triennial,3-year estimates series discontinued after 2013.,"Annual household survey covering demographics, income, education, housing, and commuting for all U.S. geographies. The primary source for small-area socioeconomic estimates between decennial censuses." +ACSDP3Y,Data Profiles 3-Year,"ACS 3-Year Data Profiles (DP-series, 4 tables) summarize social, economic, housing, and demographic estimates for areas with 20,000+ population, pooling three years of data. Discontinued after the 2013 (2011-2013) release.",acs/acs3/profile,ACS,American Community Survey,triennial,3-year estimates series discontinued after 2013.,"Annual household survey covering demographics, income, education, housing, and commuting for all U.S. geographies. The primary source for small-area socioeconomic estimates between decennial censuses." +ACSST1Y,Subject Tables 1-Year,"ACS 1-Year Subject Tables (S-series) summarize estimates by topic-such as income, commuting, or educational attainment-for a broader geographic range than detailed tables. Presenting data as both counts and percentages, they cover 66,000+ variables for areas with 65,000+ population.",acs/acs1/subject,ACS,American Community Survey,annual,,"Annual household survey covering demographics, income, education, housing, and commuting for all U.S. geographies. The primary source for small-area socioeconomic estimates between decennial censuses." +ACSPUMS1YPR,Puerto Rico Public Use Microdata Sample,"Puerto Rico Community Survey (PRCS) 1-Year PUMS contains individual-level person and housing unit records representing approximately 1% of Puerto Rico's population. Separate from the national ACS PUMS (state FIPS 72), it enables custom tabulations at the state and PUMA levels for Puerto Rico.",acs/acs1/pumspr,ACS,American Community Survey,annual,,"Annual household survey covering demographics, income, education, housing, and commuting for all U.S. geographies. The primary source for small-area socioeconomic estimates between decennial censuses." +ACSCP3Y,Comparison Profiles 3-Year,"ACS 3-Year Comparison Profiles (CP-series) compare current 3-year estimates against prior 5-year estimates with statistical significance testing, for areas with 20,000+ population. Discontinued after the 2013 (2011-2013) release. Contains 3,000+ variables.",acs/acs3/cprofile,ACS,American Community Survey,triennial,3-year estimates series discontinued after 2013.,"Annual household survey covering demographics, income, education, housing, and commuting for all U.S. geographies. The primary source for small-area socioeconomic estimates between decennial censuses." +ACSCP5Y,Comparison Profiles 5-Year,"ACS 5-Year Comparison Profiles (CP-series) mirror the Data Profile format but include comparisons to prior 5-year estimates with statistical significance testing, enabling trend analysis for all geographies down to the tract level. Contains 2,400+ variables.",acs/acs5/cprofile,ACS,American Community Survey,annual,,"Annual household survey covering demographics, income, education, housing, and commuting for all U.S. geographies. The primary source for small-area socioeconomic estimates between decennial censuses." +ACSCP1Y,Comparison Profiles 1-Year,"ACS 1-Year Comparison Profiles (CP-series) mirror the Data Profile format but add year-over-year comparisons with the four preceding 1-year estimates, including statistical significance testing. Useful for tracking change over time for areas with 65,000+ population. Contains 1,000+ variables.",acs/acs1/cprofile,ACS,American Community Survey,annual,,"Annual household survey covering demographics, income, education, housing, and commuting for all U.S. geographies. The primary source for small-area socioeconomic estimates between decennial censuses." +ACSDT3Y,Detailed Tables 3-Year,"ACS 3-Year Detailed Tables (B/C-series) pooled data collected over three consecutive years to produce estimates for areas with 20,000+ population, including counties and places too small for 1-year reliability. Discontinued after the 2013 (2011-2013) release.",acs/acs3,ACS,American Community Survey,triennial,3-year estimates series discontinued after 2013.,"Annual household survey covering demographics, income, education, housing, and commuting for all U.S. geographies. The primary source for small-area socioeconomic estimates between decennial censuses." +ACSCD113,1-Year Data Profile CD113,"ACS 1-Year Data Profiles for the 113th Congressional Districts provide the four standard DP-series tables (social, economic, housing, demographic) tailored to each of the 435 congressional districts as defined for the 113th Congress.",acs/acs1/cd113,ACS,American Community Survey,annual,Data aligned to 113th Congressional District boundaries.,"Annual household survey covering demographics, income, education, housing, and commuting for all U.S. geographies. The primary source for small-area socioeconomic estimates between decennial censuses." +ACSCD115,1-Year Data Profile 115th Congressional District,"ACS 1-Year Data Profiles for the 115th Congressional Districts provide the four standard DP-series tables (social, economic, housing, demographic) tailored to each of the 435 congressional districts as defined for the 115th Congress.",acs/acs1/cd115,ACS,American Community Survey,annual,Data aligned to 115th Congressional District boundaries.,"Annual household survey covering demographics, income, education, housing, and commuting for all U.S. geographies. The primary source for small-area socioeconomic estimates between decennial censuses." +ACSDT1Y,Detailed Tables 1-Year,"ACS 1-Year Detailed Tables (B/C-series) are the most granular ACS pre-tabulated product, offering 31,000+ cross-tabulations of demographic, social, economic, and housing characteristics. Published for areas with 65,000+ population: nation, all states, DC, Puerto Rico, congressional districts, metro areas, and qualifying counties and places.",acs/acs1,ACS,American Community Survey,annual,,"Annual household survey covering demographics, income, education, housing, and commuting for all U.S. geographies. The primary source for small-area socioeconomic estimates between decennial censuses." +ACSDP5Y,Data Profiles 5-Year,"ACS 5-Year Data Profiles (DP-series, 4 tables) provide broad social, economic, housing, and demographic summaries as both counts and percentages. Available for all geographies down to the census tract level, with 2,400+ variables. The most widely used ACS product for local-area planning and research.",acs/acs5/profile,ACS,American Community Survey,annual,,"Annual household survey covering demographics, income, education, housing, and commuting for all U.S. geographies. The primary source for small-area socioeconomic estimates between decennial censuses." +ACSFLOWS,5-Year Migration Flows,"ACS 5-Year Migration Flows derive county-level migration statistics from the ACS 'Where did you live 1 year ago?' question. The dataset provides flow estimates between state/world-region origins and current county of residence, plus supplemental geographic mobility statistics (nonmovers, inter-state movers, arrivals from abroad) for each county.",acs/flows,ACS,American Community Survey,annual,,"Annual household survey covering demographics, income, education, housing, and commuting for all U.S. geographies. The primary source for small-area socioeconomic estimates between decennial censuses." +ACSDP5YSPT,Selected Population Data Profiles 5-Year,"ACS 5-Year Selected Population Data Profiles provide DP-style summary tables for detailed race, Hispanic origin, tribal, and ancestry population groups. Released every five years for areas with sufficient group population size.",acs/acs5/sptprofile,ACS,American Community Survey,annual,,"Annual household survey covering demographics, income, education, housing, and commuting for all U.S. geographies. The primary source for small-area socioeconomic estimates between decennial censuses." +ACSPUMS1Y,Public Use Microdata Sample,ACS 1-Year Public Use Microdata Sample (PUMS) contains individual-level (person and housing unit) records representing approximately 1% of the U.S. population-with all identifying information removed. Enables custom tabulations not available in pre-tabulated products. Available at the state and Public Use Microdata Area (PUMA) levels.,acs/acs1/pums,ACS,American Community Survey,annual,,"Annual household survey covering demographics, income, education, housing, and commuting for all U.S. geographies. The primary source for small-area socioeconomic estimates between decennial censuses." +ACSDT5YSPT,Selected Population Detailed Tables 5-Year,"ACS 5-Year Selected Population Detailed Tables (SPT) provide the full range of B/C-series cross-tabulations for detailed race, Hispanic origin, tribal, and ancestry groups. Released every five years, they allow analysis of smaller population subgroups that cannot support estimates in standard detailed tables.",acs/acs5/spt,ACS,American Community Survey,annual,,"Annual household survey covering demographics, income, education, housing, and commuting for all U.S. geographies. The primary source for small-area socioeconomic estimates between decennial censuses." +ACSDP5YAIAN,American Indian and Alaska Native Data Profiles 5-Year,ACS 5-Year American Indian and Alaska Native (AIAN) Data Profiles provide DP-style summaries for tribal populations using more detailed tribal categories than standard SPT products. Released every five years.,acs/acs5/aianprofile,ACS,American Community Survey,annual,,"Annual household survey covering demographics, income, education, housing, and commuting for all U.S. geographies. The primary source for small-area socioeconomic estimates between decennial censuses." +ACSDT5YAIAN,American Indian and Alaska Native Detailed Tables 5-Year,"ACS 5-Year American Indian and Alaska Native (AIAN) Detailed Tables provide B/C-series cross-tabulations specifically for tribal populations, using more granular tribal categories than those available in the standard Selected Population Tables. Released every five years.",acs/acs5/aian,ACS,American Community Survey,annual,,"Annual household survey covering demographics, income, education, housing, and commuting for all U.S. geographies. The primary source for small-area socioeconomic estimates between decennial censuses." +ACSST5Y,Subject Tables 5-Year,"ACS 5-Year Subject Tables (S-series) provide topic-organized summaries (e.g., poverty, language, commuting) as both counts and percentages for all geographies down to the census tract. With 66,000+ variables, they offer a middle ground between data profiles and detailed tables.",acs/acs5/subject,ACS,American Community Survey,annual,,"Annual household survey covering demographics, income, education, housing, and commuting for all U.S. geographies. The primary source for small-area socioeconomic estimates between decennial censuses." +ACSSPP3Y,Selected Population Profiles 3-Year,"ACS 3-Year Selected Population Profiles (SPP) provide social, economic, and housing summaries for detailed population groups in areas with 20,000+ population. Discontinued after the 2013 (2011-2013) release.",acs/acs3/spp,ACS,American Community Survey,triennial,3-year estimates series discontinued after 2013.,"Annual household survey covering demographics, income, education, housing, and commuting for all U.S. geographies. The primary source for small-area socioeconomic estimates between decennial censuses." +ACSPUMS5YPR,Puerto Rico Public Use Microdata Sample,"Puerto Rico Community Survey (PRCS) 5-Year PUMS pools five years of PRCS records, representing approximately 5% of Puerto Rico's population. Separate from the national ACS PUMS (state FIPS 72), it supports custom analyses at the state and PUMA levels for smaller Puerto Rico subpopulations.",acs/acs5/pumspr,ACS,American Community Survey,annual,,"Annual household survey covering demographics, income, education, housing, and commuting for all U.S. geographies. The primary source for small-area socioeconomic estimates between decennial censuses." +ACSEEO5Y,Equal Employment Opportunity 5-Year,"ACS 5-Year Equal Employment Opportunity (EEO) Tabulation cross-tabulates detailed occupation by sex, race, Hispanic origin, and educational attainment for the civilian employed population. Produced jointly with the EEOC, OFCCP, and OPM to support civil rights enforcement and workforce analysis. Available at multiple geography levels.",acs/acs5/eeo,ACS,American Community Survey,annual,,"Annual household survey covering demographics, income, education, housing, and commuting for all U.S. geographies. The primary source for small-area socioeconomic estimates between decennial censuses." +ACSDIMCUBE1Y,Detailed Tables 1-Year,Experimental ACS 1-Year Dimensional Cube Demonstration explores a multidimensional data model for delivering ACS detailed table estimates. This prototype format is not a production data product and is intended for evaluation of alternative API delivery methods.,acs/acsdimcube1,ACS,American Community Survey,annual,,"Annual household survey covering demographics, income, education, housing, and commuting for all U.S. geographies. The primary source for small-area socioeconomic estimates between decennial censuses." +ACSDP1Y,Data Profiles 1-Year,"ACS 1-Year Data Profiles (DP-series, 4 tables) summarize the most widely used social, economic, housing, and demographic estimates for a single geography. Presenting data as both counts and percentages, they cover 2,400+ variables for areas with 65,000+ population.",acs/acs1/profile,ACS,American Community Survey,annual,,"Annual household survey covering demographics, income, education, housing, and commuting for all U.S. geographies. The primary source for small-area socioeconomic estimates between decennial censuses." +ACSPUMS5Y,Public Use Microdata Sample,ACS 5-Year Public Use Microdata Sample (PUMS) pools five 1-year PUMS files to represent approximately 5% of the U.S. population. Individual person and housing unit records (with identifiers removed) allow custom analyses. Available at the state and PUMA levels. Larger sample enables estimates for smaller subpopulations than the 1-year PUMS.,acs/acs5/pums,ACS,American Community Survey,annual,,"Annual household survey covering demographics, income, education, housing, and commuting for all U.S. geographies. The primary source for small-area socioeconomic estimates between decennial censuses." +CPSBASIC,Basic Monthly,"CPS Basic Monthly Survey is the core labor force survey conducted each month for approximately 60,000 households. It produces the official national unemployment rate and major employment statistics (employed, unemployed, not in labor force) by demographic characteristics.",cps/basic,CPS,Current Population Survey,monthly,,"Monthly labor force survey providing official U.S. unemployment statistics. Supplemental topics include health insurance, poverty, voting, school enrollment, and food security." +CPSASEC,Annual Social and Economic (March) Supplement,"CPS Annual Social and Economic (ASEC/March) Supplement is the source for official national poverty statistics and median household income. Collected annually in March from an expanded sample (~100,000 households), it covers prior-year income, health insurance, and poverty status in detail.",cps/asec,CPS,Current Population Survey,annual,,"Monthly labor force survey providing official U.S. unemployment statistics. Supplemental topics include health insurance, poverty, voting, school enrollment, and food security." +CPSVOTING,Voting Supplement,"CPS Voting and Registration Supplement collects self-reported voter registration and voting participation data after major federal elections, providing the source for official estimates of voter turnout by age, sex, race, citizenship, and education.",cps/voting,CPS,Current Population Survey,biennial,Fielded in November of even-numbered years following national elections; collected since 1964.,"Monthly labor force survey providing official U.S. unemployment statistics. Supplemental topics include health insurance, poverty, voting, school enrollment, and food security." +CPSFOODSECURITY,Food Security Supplement,"CPS Food Security Supplement measures household-level food security status and hunger using a validated scale. Administered annually in December, it is the source for official USDA national and state food insecurity estimates.",cps/foodsec,CPS,Current Population Survey,annual,,"Monthly labor force survey providing official U.S. unemployment statistics. Supplemental topics include health insurance, poverty, voting, school enrollment, and food security." +CPSTOBACCOUSE,Tobacco Use Supplement,"CPS Tobacco Use Supplement (TUS-CPS) is the primary source of national and state-level data on cigarette, cigar, and smokeless tobacco use for adults. Conducted three times per two-year cycle, it supports public health surveillance and tobacco control policy.",cps/tobacco,CPS,Current Population Survey,biennial,Fielded in odd-numbered years on a biennial basis; sponsored by the National Cancer Institute.,"Monthly labor force survey providing official U.S. unemployment statistics. Supplemental topics include health insurance, poverty, voting, school enrollment, and food security." +CPSSCHOOL,School Enrollment Supplement,"CPS School Enrollment Supplement collects detailed data on enrollment status, school type (public/private), and grade level for the population 3 years and older. Fielded annually in October, it is the source for official school enrollment estimates.",cps/school,CPS,Current Population Survey,triennial,,"Monthly labor force survey providing official U.S. unemployment statistics. Supplemental topics include health insurance, poverty, voting, school enrollment, and food security." +CPSVOLUNTEER,Volunteering and Civic Life Supplement,"CPS Volunteering and Civic Life Supplement measures formal volunteering through organizations, informal helping activities, and civic engagement behaviors (e.g., attending community meetings). Fielded annually through a partnership with AmeriCorps.",cps/volunteer,CPS,Current Population Survey,annual,,"Monthly labor force survey providing official U.S. unemployment statistics. Supplemental topics include health insurance, poverty, voting, school enrollment, and food security." +CPSVETS,Veterans Supplement,"CPS Veterans Supplement collects detailed data on military service history, period of service, disability status, and service-connected disabilities for the veteran population. Fielded periodically in August.",cps/vets,CPS,Current Population Survey,periodic,Fielded periodically with no fixed recurrence; sponsor-driven scheduling.,"Monthly labor force survey providing official U.S. unemployment statistics. Supplemental topics include health insurance, poverty, voting, school enrollment, and food security." +CPSMARITAL,Fertility and Marital History Supplement,"CPS Fertility and Marital History Supplement (combined) collects information on marriage and divorce history alongside birth history, enabling analysis of family formation patterns and their relationship to fertility.",cps/marital,CPS,Current Population Survey,periodic,Fielded periodically; combined fertility and marital history content has varied across collection years.,"Monthly labor force survey providing official U.S. unemployment statistics. Supplemental topics include health insurance, poverty, voting, school enrollment, and food security." +CPSDISWORKJOBTEN,"Displaced Worker, Employee Tenure, and Occupational Mobility Supplement","CPS Displaced Worker, Employee Tenure, and Occupational Mobility Supplement covers job loss due to plant closings or layoffs (displaced workers), length of time with current employer (tenure), and occupational change. Fielded biennially in January.",cps/dwjt,CPS,Current Population Survey,biennial,Biennial supplement fielded in odd-numbered years.,"Monthly labor force survey providing official U.S. unemployment statistics. Supplemental topics include health insurance, poverty, voting, school enrollment, and food security." +CPSFERTILITY,Fertility Supplement,"CPS Fertility Supplement collects data on birth history, expected future births, and childlessness for women aged 15-50. Fielded periodically in June, it is used to estimate lifetime fertility rates and understand childbearing patterns.",cps/fertility,CPS,Current Population Survey,periodic,Fielded periodically in June; collection years not contiguous.,"Monthly labor force survey providing official U.S. unemployment statistics. Supplemental topics include health insurance, poverty, voting, school enrollment, and food security." +CPSIMMIGRATION,Immigration/Emigration Supplement,"CPS Immigration/Emigration Supplement collects detailed data on immigration history, year of entry, and emigration intentions for the foreign-born population. Used to study immigrant integration and population dynamics.",cps/immigration,CPS,Current Population Survey,periodic,Fielded periodically with no fixed recurrence; sponsor-driven scheduling.,"Monthly labor force survey providing official U.S. unemployment statistics. Supplemental topics include health insurance, poverty, voting, school enrollment, and food security." +CPSUNBANKED,Unbanked/Underbanked Supplement,CPS Unbanked/Underbanked Supplement (conducted for the FDIC) measures household access to mainstream banking services-checking/savings accounts-and use of alternative financial services. It is the source for the FDIC's biennial National Survey of Unbanked and Underbanked Households.,cps/unbank,CPS,Current Population Survey,biennial,,"Monthly labor force survey providing official U.S. unemployment statistics. Supplemental topics include health insurance, poverty, voting, school enrollment, and food security." +CPSINTERNET,Computer and Internet Use Supplement,"CPS Computer and Internet Use Supplement collects data on household computer ownership and internet access by connection type, speed, and device, along with individual-level internet use patterns. Key source for digital divide measurement.",cps/internet,CPS,Current Population Survey,biennial,"Fielded biennially since 2013; prior to 2013 collected sporadically (1984, 1989, 1993, 1997, 2000–2003, 2007–2012).","Monthly labor force survey providing official U.S. unemployment statistics. Supplemental topics include health insurance, poverty, voting, school enrollment, and food security." +CPSDISABILITY,Disability Supplement,"CPS Disability Supplement collects detailed disability status information including type of disability, severity, and work limitations, enabling analysis of labor force participation and economic well-being for the disabled population.",cps/disability,CPS,Current Population Survey,periodic,Fielded on an irregular basis; not a recurring supplement. Most recent standalone collection was May 2012.,"Monthly labor force survey providing official U.S. unemployment statistics. Supplemental topics include health insurance, poverty, voting, school enrollment, and food security." +CPSCIVICENGAGE,Civic Engagement Supplement,"CPS Civic Engagement Supplement measures participation in community and civic activities beyond formal volunteering, such as attending public meetings, contacting officials, and participating in neighborhood groups.",cps/civic,CPS,Current Population Survey,annual,Fielded annually in September since 2021 (in partnership with AmeriCorps); prior collections in 2008–2011 and 2013 were irregular.,"Monthly labor force survey providing official U.S. unemployment statistics. Supplemental topics include health insurance, poverty, voting, school enrollment, and food security." +POVERTY,Time Series Current Population Survey: Poverty Status,"CPS Historical Poverty Time Series provides long-running national poverty statistics derived from the Current Population Survey ASEC supplement. Data span back to the 1960s and track poverty rates by family type, race, age, and other characteristics over time.",timeseries/poverty/histpov2,CPS,Current Population Survey,annual,,"Monthly labor force survey providing official U.S. unemployment statistics. Supplemental topics include health insurance, poverty, voting, school enrollment, and food security." +PEPPOP,Population Estimates,"Population Estimates Program (PEP) Population Estimates provide annually updated resident population counts for the nation, states, counties, and places. These are the Census Bureau's official intercensal estimates, produced using the cohort-component method combining birth, death, and migration data.",pep/population,PEP,Population Estimates,annual,,"Annual intercensal estimates of population, housing units, and components of change (births, deaths, migration) for the nation, states, counties, and cities." +PEPNATMONTHLY,National Monthly Population,"PEP National Monthly Population provides a simplified monthly total resident population series for the nation, supporting high-frequency population tracking between annual estimate releases.",pep/natmonthly,PEP,Population Estimates,monthly,,"Annual intercensal estimates of population, housing units, and components of change (births, deaths, migration) for the nation, states, counties, and cities." +PEPMONTHLYNATCHAR5,"National Monthly Population Estimates by Single Year of Age, Sex, 5 Races, Hispanic Origin, and Universe","PEP National Monthly Population Estimates by Single Year of Age, Sex, 5 Races, Hispanic Origin, and Universe provide sub-annual (monthly) national demographic estimates-useful for tracking rapid population changes or reconciling with vital statistics data.",pep/monthlynatchar5,PEP,Population Estimates,monthly,,"Annual intercensal estimates of population, housing units, and components of change (births, deaths, migration) for the nation, states, counties, and cities." +PEPMONTHLYNATCHAR6,"National Monthly Population Estimates by Single Year of Age, Sex, 6 Races, Hispanic Origin, and Universe","PEP National Monthly Population Estimates by Single Year of Age, Sex, 6 Races, Hispanic Origin, and Universe are the 6-race counterpart to PEPMONTHLYNATCHAR5, providing monthly national demographic estimates with added NHOPI race detail.",pep/monthlynatchar6,PEP,Population Estimates,monthly,,"Annual intercensal estimates of population, housing units, and components of change (births, deaths, migration) for the nation, states, counties, and cities." +PEPUSDAILY,US Daily Population and Components of Change Increments,"PEP U.S. Daily Population and Components of Change Increments provide daily estimates of the national resident population and its incremental changes from births, deaths, and net migration-used for real-time population clock applications.",pep/daily,PEP,Population Estimates,daily,Daily increments published during intercensal periods only; not available during active decennial collection.,"Annual intercensal estimates of population, housing units, and components of change (births, deaths, migration) for the nation, states, counties, and cities." +PEPAGESEX,National Annual Resident Population Estimates by Single Year of Age and Sex,"PEP National Annual Resident Population Estimates by Single Year of Age and Sex provide fine-grained age-sex distributions for the national resident population for each year between censuses, supporting life-table calculations, program eligibility modeling, and demographic analysis.",pep/agesex,PEP,Population Estimates,annual,,"Annual intercensal estimates of population, housing units, and components of change (births, deaths, migration) for the nation, states, counties, and cities." +PEPCTY,County Total Population and Components of Change,"PEP County Total Population and Components of Change estimates provide annual resident population counts and the four components of change (births, deaths, net domestic migration, net international migration) for every U.S. county.",pep/cty,PEP,Population Estimates,annual,,"Annual intercensal estimates of population, housing units, and components of change (births, deaths, migration) for the nation, states, counties, and cities." +PEPCOCHAR5,"County Population Estimates by 5 Year Age Groups, Sex, 5 Races, and Hispanic Origin","PEP County Population Estimates by 5-Year Age Groups, Sex, 5 Races, and Hispanic Origin provide detailed annual demographic breakdowns at the county level, using a 5-race classification (White, Black, AIAN, Asian, NHOPI). Used for program planning and civil rights compliance.",pep/cochar5,PEP,Population Estimates,annual,Uses 5-year age groupings for county-level detail; annual release cadence.,"Annual intercensal estimates of population, housing units, and components of change (births, deaths, migration) for the nation, states, counties, and cities." +PEPCOCHAR6,"County Population Estimates by 5 Year Age Groups, Sex, 6 Races, and Hispanic Origin","PEP County Population Estimates by 5-Year Age Groups, Sex, 6 Races, and Hispanic Origin provide annual county-level demographic breakdowns using a 6-race classification that adds Native Hawaiian and Other Pacific Islander as a separate category. Supports detailed minority population analyses.",pep/cochar6,PEP,Population Estimates,annual,Uses 5-year age groupings for county-level detail; annual release cadence.,"Annual intercensal estimates of population, housing units, and components of change (births, deaths, migration) for the nation, states, counties, and cities." +PEPSTCHAR5,"State Population Estimates by Single Year of Age, Sex, 5 Races, and Hispanic Origin","PEP State Population Estimates by Single Year of Age, Sex, 5 Races, and Hispanic Origin provide detailed annual demographic breakdowns at the state level using single-year age groups and a 5-race classification.",pep/stchar5,PEP,Population Estimates,annual,,"Annual intercensal estimates of population, housing units, and components of change (births, deaths, migration) for the nation, states, counties, and cities." +PEPSTCHAR6,"State Population Estimates by Single Year of Age, Sex, 6 Races, and Hispanic Origin","PEP State Population Estimates by Single Year of Age, Sex, 6 Races, and Hispanic Origin provide detailed annual demographic breakdowns at the state level using single-year age groups and a 6-race classification.",pep/stchar6,PEP,Population Estimates,annual,,"Annual intercensal estimates of population, housing units, and components of change (births, deaths, migration) for the nation, states, counties, and cities." +PEPAGESPECIAL5,"National, State, County Annual Resident Population Estimates by Age Groups, Sex, 5 Races, and Hispanic Origin","PEP National/State/County Annual Resident Population Estimates by Age Groups, Sex, 5 Races, and Hispanic Origin provide cross-tabulated demographic estimates across multiple geography levels in a single combined file using 5-race classification.",pep/agespecial5,PEP,Population Estimates,annual,,"Annual intercensal estimates of population, housing units, and components of change (births, deaths, migration) for the nation, states, counties, and cities." +PEPAGESPECIAL6,"National, State, County Annual Resident Population Estimates by Age Groups, Sex, 6 Races, and Hispanic Origin","PEP National/State/County Annual Resident Population Estimates by Age Groups, Sex, 6 Races, and Hispanic Origin provide cross-tabulated demographic estimates across multiple geography levels in a single combined file using 6-race classification.",pep/agespecial6,PEP,Population Estimates,annual,,"Annual intercensal estimates of population, housing units, and components of change (births, deaths, migration) for the nation, states, counties, and cities." +PEPAGESPECIALPR,Puerto Rico Commonwealth and Municipios Annual Resident Population Estimates by Age Groups and Sex,PEP Puerto Rico Commonwealth and Municipios Annual Resident Population Estimates by Age Groups and Sex provide a combined file covering both territory-wide and municipio-level annual demographic estimates for Puerto Rico.,pep/agespecialpr,PEP,Population Estimates,annual,,"Annual intercensal estimates of population, housing units, and components of change (births, deaths, migration) for the nation, states, counties, and cities." +PEPPRCAGESEX,Puerto Rico Commonwealth Estimates by Single Year of Age and Sex,"PEP Puerto Rico Commonwealth Estimates by Single Year of Age and Sex provide fine-grained annual age-sex breakdowns for Puerto Rico's total resident population, supporting actuarial, demographic, and program planning analyses for the territory.",pep/prcagesex,PEP,Population Estimates,annual,,"Annual intercensal estimates of population, housing units, and components of change (births, deaths, migration) for the nation, states, counties, and cities." +PEPPRMAGESEX,Puerto Rico Municipios Estimates by 5-Year Age Groups and Sex,"PEP Puerto Rico Municipios Estimates by 5-Year Age Groups and Sex provide annual demographic breakdowns for each of Puerto Rico's 78 municipios, enabling sub-territorial age-sex analyses.",pep/prmagesex,PEP,Population Estimates,annual,Uses 5-year age groupings for municipio-level detail; annual release cadence.,"Annual intercensal estimates of population, housing units, and components of change (births, deaths, migration) for the nation, states, counties, and cities." +PEPPRM,Puerto Rico Municipios Total Population,"PEP Puerto Rico Municipios Total Population estimates provide annual resident population counts for each of Puerto Rico's 78 municipios, the primary administrative subdivisions of the territory.",pep/prm,PEP,Population Estimates,annual,,"Annual intercensal estimates of population, housing units, and components of change (births, deaths, migration) for the nation, states, counties, and cities." +PEPSUBCTY,Subcounty Population Places and MCDs,"PEP Subcounty Population Estimates cover all legally incorporated places and minor civil divisions (MCDs), providing annual resident population counts below the county level for cities, towns, villages, and townships.",pep/subcty,PEP,Population Estimates,annual,,"Annual intercensal estimates of population, housing units, and components of change (births, deaths, migration) for the nation, states, counties, and cities." +PEPHOUSING,"Housing Unit Estimates for US, States, and Counties","PEP Housing Unit Estimates provide annual counts of total housing units for the nation, states, and counties, estimated from building permits, demolitions, and other administrative data. Distinct from occupied/vacant measures in the ACS or census.",pep/housing,PEP,Population Estimates,annual,,"Annual intercensal estimates of population, housing units, and components of change (births, deaths, migration) for the nation, states, counties, and cities." +PEPNATSTPRC,"US, State, and PR Total Population and Components of Change","PEP national, state, and Puerto Rico total population and components of change estimates break down annual population change into births, deaths, net domestic migration, and net international migration for the nation, each state, and Puerto Rico.",pep/natstprc,PEP,Population Estimates,annual,,"Annual intercensal estimates of population, housing units, and components of change (births, deaths, migration) for the nation, states, counties, and cities." +PEPNATSTPRC18,"US, State, and PR Population Age 18+","PEP national, state, and Puerto Rico population age 18 and older estimates provide annual counts of the adult resident population-used for apportionment, program planning, and electoral analyses.",pep/natstprc18,PEP,Population Estimates,annual,,"Annual intercensal estimates of population, housing units, and components of change (births, deaths, migration) for the nation, states, counties, and cities." +PEPCHARAGE,"Estimates by Age, Sex, Race, and Hispanic Origin","PEP Estimates by Age, Sex, Race, and Hispanic Origin combine detailed demographic dimensions (single-year age, sex, race, Hispanic origin) into a unified file spanning national, state, and county geographies.",pep/charage,PEP,Population Estimates,annual,,"Annual intercensal estimates of population, housing units, and components of change (births, deaths, migration) for the nation, states, counties, and cities." +PEPCHARAGEGROUPS,"Estimates by Age Group, Sex, Race, and Hispanic Origin","PEP Estimates by Age Group, Sex, Race, and Hispanic Origin present the same multi-variable demographic breakdowns as PEPCHARAGE but use 5-year age groups rather than single-year ages, reducing file size while retaining demographic detail.",pep/charagegroups,PEP,Population Estimates,annual,Uses 5-year age groupings; annual release cadence.,"Annual intercensal estimates of population, housing units, and components of change (births, deaths, migration) for the nation, states, counties, and cities." +PEPCOMPONENTS,Components of Change Estimates,"PEP Components of Change Estimates provide annual data on the four drivers of population change-births, deaths, net domestic migration, and net international migration-for the nation, states, and counties. Enables decomposition of population growth or decline by its underlying demographic components.",pep/components,PEP,Population Estimates,annual,,"Annual intercensal estimates of population, housing units, and components of change (births, deaths, migration) for the nation, states, counties, and cities." +PEPINTERCENSALHOUSING,Housing Units,"PEP Intercensal Housing Units estimates provide revised annual housing unit counts for states and counties for the intercensal period, reconciled between two decennial censuses to correct for revisions made after the initial estimate release.",pep/int_housingunits,PEP,Population Estimates,decennial,Covers the intercensal period between two decennial censuses; single release per intercensal period.,"Annual intercensal estimates of population, housing units, and components of change (births, deaths, migration) for the nation, states, counties, and cities." +PEPINTERCENSALCHARAGEGROUPS,"County Estimates by 5 Year Age Groups, Race by Sex, and Hispanic Origin","PEP Intercensal County Estimates by 5-Year Age Groups, Race by Sex, and Hispanic Origin provide revised annual county-level demographic estimates for the intercensal period, reconciling forward and backward projections between two censuses.",pep/int_charagegroups,PEP,Population Estimates,periodic,Covers the intercensal period between two decennial censuses; single release per intercensal period. Uses 5-year age groupings.,"Annual intercensal estimates of population, housing units, and components of change (births, deaths, migration) for the nation, states, counties, and cities." +PEPINTERCENSALNATRESAFO,United States Resident plus Armed Forces Overseas Population Estimates by Age and Sex,"PEP Intercensal United States Resident plus Armed Forces Overseas (RESAFO) Population Estimates by Age and Sex include both the domestic resident population and U.S. military and federal civilian employees stationed overseas, for intercensal years.",pep/int_natresafo,PEP,Population Estimates,annual,Covers the intercensal period between two decennial censuses; single release per intercensal period.,"Annual intercensal estimates of population, housing units, and components of change (births, deaths, migration) for the nation, states, counties, and cities." +PEPINTERCENSALNATCIVPOP,United States Civilian Population Estimates by Age and Sex,"PEP Intercensal United States Civilian Population Estimates by Age and Sex exclude active-duty military from the national population total, providing a civilian-only series for intercensal years. Useful for labor force and program eligibility analyses.",pep/int_natcivpop,PEP,Population Estimates,annual,Covers the intercensal period between two decennial censuses; single release per intercensal period.,"Annual intercensal estimates of population, housing units, and components of change (births, deaths, migration) for the nation, states, counties, and cities." +PEPINTERCENSALNATRESPOP,United States Resident Population Estimates by Age and Sex,"PEP Intercensal United States Resident Population Estimates by Age and Sex provide revised annual national age-sex distributions for the intercensal period, reconciling estimates between two successive decennial censuses.",pep/int_natrespop,PEP,Population Estimates,decennial,Covers the intercensal period between two decennial censuses; single release per intercensal period.,"Annual intercensal estimates of population, housing units, and components of change (births, deaths, migration) for the nation, states, counties, and cities." +POPPROJBIRTHS,"Projected Births by Sex, Race, and Hispanic Origin for the United States: 2016-2060","Projected Births by Sex, Race, and Hispanic Origin extend projected birth counts through 2060, providing one of the three components of change (alongside deaths and migration) underlying the national population projections series.",popproj/births,POPPROJ,National Population Projections,projection,Single-vintage release; projections are updated irregularly when methodology or base population data are revised.,"Long-range national population projections by age, sex, race, and Hispanic origin through 2060. Used for policy planning and demographic trend analysis." +POPPROJDEATHS,"Projected Population by Single Year of Age, Sex, Race, and Hispanic Origin for the United States: 2016-2060","Projected Deaths by Sex, Race, and Hispanic Origin extend projected death counts through 2060, providing the mortality component underlying the national population projections and enabling cause-specific mortality research.",popproj/deaths,POPPROJ,National Population Projections,projection,Single-vintage release; projections are updated irregularly when methodology or base population data are revised.,"Long-range national population projections by age, sex, race, and Hispanic origin through 2060. Used for policy planning and demographic trend analysis." +POPPROJNAT,"Projected Population by Single Year of Age, Sex, Race, and Hispanic Origin, and Nativity for the United States: 2016-2060","Projected Population by Nativity (native-born vs. foreign-born), in addition to single year of age, sex, race, and Hispanic origin, through 2060. Supports analyses of immigration's contribution to future population growth.",popproj/nat,POPPROJ,National Population Projections,projection,Single-vintage release; projections are updated irregularly when methodology or base population data are revised.,"Long-range national population projections by age, sex, race, and Hispanic origin through 2060. Used for policy planning and demographic trend analysis." +POPPROJNIM,"Projected Net International Migration by Single Year of Age, Sex, Race, and Hispanic Origin for the United States: 2016-2060","Projected Net International Migration by Single Year of Age, Sex, Race, and Hispanic Origin through 2060, providing the migration component underlying national population projections. Useful for immigration policy analysis.",popproj/nim,POPPROJ,National Population Projections,projection,Single-vintage release; projections are updated irregularly when methodology or base population data are revised.,"Long-range national population projections by age, sex, race, and Hispanic origin through 2060. Used for policy planning and demographic trend analysis." +POPPROJPOP,"Projected Population by Single Year of Age, Sex, Race, and Hispanic Origin for the United States: 2016-2060","National Population Projections by Single Year of Age, Sex, Race, and Hispanic Origin project the resident U.S. population through 2060 under a set of fertility, mortality, and migration assumptions. The primary projections series from the Census Bureau's national projections program.",popproj/pop,POPPROJ,National Population Projections,projection,Single-vintage release; projections are updated irregularly when methodology or base population data are revised.,"Long-range national population projections by age, sex, race, and Hispanic origin through 2060. Used for policy planning and demographic trend analysis." +PROJAGEGROUPS,"Projected Population by Age Group, Sex, Race, and Hispanic Origin for the United States: 2016-2060","National Population Projections by Age Group, Sex, Race, and Hispanic Origin aggregate single-year projections into broader age bands (e.g., 0-4, 5-9), making the data more accessible for program planning and policy applications.",popproj/agegroups,POPPROJ,National Population Projections,projection,Single-vintage release; projections are updated irregularly when methodology or base population data are revised.,"Long-range national population projections by age, sex, race, and Hispanic origin through 2060. Used for policy planning and demographic trend analysis." +DECENNIALSF1,Summary File 1,"Decennial Census Summary File 1 (SF1) contains 100-percent data-counts collected from all households-on population and housing subjects including age, sex, race, Hispanic origin, household relationship, and housing occupancy/tenure. Available at all geographic levels down to the census block.",dec/sf1,DEC,Decennial Census,decennial,,Constitutionally mandated count of every U.S. resident conducted every 10 years. Authoritative source for population and housing counts used for congressional apportionment and redistricting. +DECENNIALCD113,113th Congressional District Summary File,"Decennial Census 113th Congressional District Summary File provides 100-percent population and housing counts (race, Hispanic origin, age, sex, housing tenure) tabulated to the boundaries of the 435 congressional districts as defined for the 113th Congress.",dec/cd113,DEC,Decennial Census,decennial,,Constitutionally mandated count of every U.S. resident conducted every 10 years. Authoritative source for population and housing counts used for congressional apportionment and redistricting. +DECENNIALCD115,115th Congressional District Summary File,Decennial Census 115th Congressional District Summary File provides 100-percent population and housing counts tabulated to the boundaries of the 435 congressional districts as defined for the 115th Congress.,dec/cd115,DEC,Decennial Census,decennial,,Constitutionally mandated count of every U.S. resident conducted every 10 years. Authoritative source for population and housing counts used for congressional apportionment and redistricting. +DECENNIALPL,Redistricting Data (PL 94-171),"Decennial Census Redistricting Data (P.L. 94-171) is the first detailed data product released after each census. Required by law within one year of Census Day, it provides race, Hispanic origin, voting-age population, housing occupancy, and group quarters counts down to the census block for use in legislative redistricting.",dec/pl,DEC,Decennial Census,quarterly,Released on a rolling quarterly basis during census year as states certify redistricting data; not a standalone survey.,Constitutionally mandated count of every U.S. resident conducted every 10 years. Authoritative source for population and housing counts used for congressional apportionment and redistricting. +DECENNIALSF3,Summary File 3,"Decennial Census Summary File 3 (SF3) contains sample (long-form) data on social, economic, and housing characteristics collected from approximately 1-in-6 households. Covers topics such as income, education, commuting, and housing costs at geography levels down to the census block group. Replaced by the ACS after 2000.",dec/sf3,DEC,Decennial Census,decennial,,Constitutionally mandated count of every U.S. resident conducted every 10 years. Authoritative source for population and housing counts used for congressional apportionment and redistricting. +DECENNIALDPAIAN,American Indian and Alaska Native Demographic Profile,"Decennial Census American Indian and Alaska Native Demographic Profile provides 100-percent population and housing counts specifically for federally recognized American Indian Areas, Alaska Native Areas, and Hawaiian Home Lands.",dec/aianprofile,DEC,Decennial Census,decennial,,Constitutionally mandated count of every U.S. resident conducted every 10 years. Authoritative source for population and housing counts used for congressional apportionment and redistricting. +DECENNIALCD116,116th Congressional District Summary File,Decennial Census 116th Congressional District Summary File provides 100-percent population and housing counts tabulated to the boundaries of the 435 congressional districts as defined for the 116th Congress.,dec/cd116,DEC,Decennial Census,decennial,,Constitutionally mandated count of every U.S. resident conducted every 10 years. Authoritative source for population and housing counts used for congressional apportionment and redistricting. +DECENNIALDPCD110H,110th Congressional District Demographic Profile (100-Percent),Decennial Census 110th Congressional District Demographic Profile (100-Percent) presents key population and housing counts from the 100-percent (short-form) census data tabulated to 110th Congress district boundaries.,dec/cd110hprofile,DEC,Decennial Census,decennial,,Constitutionally mandated count of every U.S. resident conducted every 10 years. Authoritative source for population and housing counts used for congressional apportionment and redistricting. +DECENNIALDPCD110S,110th Congressional District Demographic Profile (Sample),"Decennial Census 110th Congressional District Demographic Profile (Sample) presents social, economic, and housing estimates from the long-form sample data tabulated to 110th Congress district boundaries.",dec/cd110sprofile,DEC,Decennial Census,decennial,,Constitutionally mandated count of every U.S. resident conducted every 10 years. Authoritative source for population and housing counts used for congressional apportionment and redistricting. +DECENNIALAIAN,American Indian and Alaska Native Summary File,"Decennial Census American Indian and Alaska Native Summary File provides full 100-percent detailed cross-tabulations for the population within federally recognized tribal areas, including American Indian Areas, Alaska Native Areas, and Hawaiian Home Lands.",dec/aian,DEC,Decennial Census,decennial,,Constitutionally mandated count of every U.S. resident conducted every 10 years. Authoritative source for population and housing counts used for congressional apportionment and redistricting. +DECENNIALRR,Decennial Self-Response Rate,"Decennial Self-Response Rate dataset tracks the cumulative rate at which households responded to the census on their own (internet, phone, or mail) before enumerator follow-up, reported daily at the tract, county, state, and national levels during the collection period.",dec/responserate,DEC,Decennial Census,daily,Daily self-response rate tracking published during active census collection period only.,Constitutionally mandated count of every U.S. resident conducted every 10 years. Authoritative source for population and housing counts used for congressional apportionment and redistricting. +DECENNIALDPCD115,115th Congressional District Demographic Profile,"Decennial Census 115th Congressional District Demographic Profile provides a DP-style summary of social, economic, housing, and demographic characteristics for each congressional district under the 115th Congress boundary definitions.",dec/cd115profile,DEC,Decennial Census,decennial,,Constitutionally mandated count of every U.S. resident conducted every 10 years. Authoritative source for population and housing counts used for congressional apportionment and redistricting. +DECENNIALDPCD113,113th Congressional District Demographic Profile,"Decennial Census 113th Congressional District Demographic Profile provides a DP-style summary of social, economic, housing, and demographic characteristics for each congressional district under the 113th Congress boundary definitions.",dec/cd113profile,DEC,Decennial Census,decennial,,Constitutionally mandated count of every U.S. resident conducted every 10 years. Authoritative source for population and housing counts used for congressional apportionment and redistricting. +DECENNIALDPSLDH,State Legislative District Demographic Profile (100-Percent),Decennial Census State Legislative District Demographic Profile (100-Percent) provides key demographic and housing counts from short-form census data tabulated to upper-chamber state legislative district boundaries.,dec/sldhprofile,DEC,Decennial Census,decennial,,Constitutionally mandated count of every U.S. resident conducted every 10 years. Authoritative source for population and housing counts used for congressional apportionment and redistricting. +DECENNIALSLDH,State Legislative District Summary File (100-Percent),"Decennial Census State Legislative District Summary File (100-Percent) provides detailed cross-tabulations of 100-percent data (race, age, sex, housing tenure) for upper-chamber state legislative districts.",dec/sldh,DEC,Decennial Census,decennial,,Constitutionally mandated count of every U.S. resident conducted every 10 years. Authoritative source for population and housing counts used for congressional apportionment and redistricting. +DECENNIALCQR,Count Question Resolution,Decennial Count Question Resolution (CQR) program allows governments to challenge population or housing counts they believe are in error. This dataset contains population and housing unit counts before and after any corrections accepted through the CQR process.,dec/cqr,DEC,Decennial Census,decennial,Released post-census to resolve count discrepancies; one-time product per decennial cycle.,Constitutionally mandated count of every U.S. resident conducted every 10 years. Authoritative source for population and housing counts used for congressional apportionment and redistricting. +DECENNIALCD110H,110th Congressional District Summary File (100-Percent),Decennial Census 110th Congressional District Summary File (100-Percent) provides detailed cross-tabulations of short-form census data for each district under 110th Congress boundary definitions.,dec/cd110h,DEC,Decennial Census,decennial,,Constitutionally mandated count of every U.S. resident conducted every 10 years. Authoritative source for population and housing counts used for congressional apportionment and redistricting. +DECENNIALSF2,Summary File 2,"Decennial Census Summary File 2 (SF2) provides 100-percent population and housing counts iterated for 250 race and Hispanic origin groups, American Indian and Alaska Native tribes, and ancestry groups-enabling analysis of detailed population subgroups at geography levels down to the census tract.",dec/sf2,DEC,Decennial Census,decennial,,Constitutionally mandated count of every U.S. resident conducted every 10 years. Authoritative source for population and housing counts used for congressional apportionment and redistricting. +DECENNIALTESTING,Decennial Testing Data,"Decennial Testing Data contains experimental or dress-rehearsal census counts released for research and evaluation purposes. These data are not official census counts and are intended to test questionnaire design, processing, or geographic methods ahead of a production census.",dec/testing,DEC,Decennial Census,decennial,Collected during census test years; not a regular decennial product.,Constitutionally mandated count of every U.S. resident conducted every 10 years. Authoritative source for population and housing counts used for congressional apportionment and redistricting. +DECENNIALPES,Decennial Post Enumeration Survey,Decennial Post-Enumeration Survey (PES) is an independent survey conducted after the census to estimate net coverage error-how many people were over- or undercounted. Results inform methodological improvements and evaluate the accuracy of decennial enumeration by demographic group and geography.,dec/pes,DEC,Decennial Census,decennial,Post-Enumeration Survey conducted immediately after each decennial; one product per cycle.,Constitutionally mandated count of every U.S. resident conducted every 10 years. Authoritative source for population and housing counts used for congressional apportionment and redistricting. +DECENNIALDP,Demographic Profile,"Decennial Census Demographic Profile provides selected demographic and housing characteristics (age, sex, race, Hispanic origin, household type, housing tenure) for areas down to the census tract. The 2020 version is equivalent to the 2010 Demographic Profile and serves as a concise summary of census 100-percent data.",dec/dp,DEC,Decennial Census,decennial,,Constitutionally mandated count of every U.S. resident conducted every 10 years. Authoritative source for population and housing counts used for congressional apportionment and redistricting. +DECENNIALTESTING2,Decennial Testing Data 2,"Decennial Testing Data 2 is a secondary experimental dataset released alongside or following Decennial Testing Data, supporting further evaluation of census methodologies, disclosure avoidance approaches, or data products under development.",dec/testing2,DEC,Decennial Census,decennial,Collected during census test years; not a regular decennial product.,Constitutionally mandated count of every U.S. resident conducted every 10 years. Authoritative source for population and housing counts used for congressional apportionment and redistricting. +DECENNIALDDHCA,Detailed Demographic and Housing Characteristics File A,"Decennial Census Detailed Demographic and Housing Characteristics File A (DHC-A) provides comprehensive cross-tabulations of population and housing variables-including age, sex, race, Hispanic origin, household type, and tenure-at geography levels down to the census block. The 2020 successor to prior century's SF1/SF2 detailed tables.",dec/ddhca,DEC,Decennial Census,decennial,,Constitutionally mandated count of every U.S. resident conducted every 10 years. Authoritative source for population and housing counts used for congressional apportionment and redistricting. +DECENNIALPUMS1PCT,Public Use Microdata Sample - 1 Percent Sample,"Decennial Census Public Use Microdata Sample (1-Percent) contains individual-level person and housing unit records representing approximately 1% of the population, with all identifying information removed. Enables custom cross-tabulations of census 100-percent variables at the state and PUMA levels.",dec/pums1pct,DECENNIAL,Decennial Census of Population and Housing,decennial,,"Full decennial census of population and housing characteristics. Covers detailed demographic, social, economic, and housing topics collected from all U.S. households." +DECENNIALSF1ES,Compendio de Datos 1 (SF1),"Compendio de Datos 1 (SF1) is the Spanish-language version of the Decennial Census Summary File 1 100-percent data for Puerto Rico, providing population and housing counts by age, sex, race, and Hispanic origin down to the census block.",es/dec/sf1,DECIA,Decennial Census of Island Areas,decennial,,"Decennial census for U.S. island territories providing population and housing counts for Puerto Rico, Guam, CNMI, American Samoa, and the U.S. Virgin Islands." +DECENNIALAS,American Samoa Summary File,"Decennial Census American Samoa Summary File provides 100-percent population and housing counts for American Samoa, including age, sex, race, and housing tenure at all available geographic levels within the territory.",dec/as,DECIA,Decennial Census of Island Areas,decennial,,"Decennial census for U.S. island territories providing population and housing counts for Puerto Rico, Guam, CNMI, American Samoa, and the U.S. Virgin Islands." +DECENNIALYOEMP,Commonwealth of the Northern Mariana Islands Year of Entry File,"Decennial Census Commonwealth of the Northern Mariana Islands Year of Entry File provides population counts cross-tabulated by year of entry into the CNMI, enabling analysis of migration patterns and resident tenure within the territory.",dec/mpyoe,DECIA,Decennial Census of Island Areas,decennial,,"Decennial census for U.S. island territories providing population and housing counts for Puerto Rico, Guam, CNMI, American Samoa, and the U.S. Virgin Islands." +DECENNIALYOEGU,Guam Year of Entry File,"Decennial Census Guam Year of Entry File provides population counts cross-tabulated by year of entry into Guam, enabling analysis of migration patterns and length of residence within the territory.",dec/guyoe,DECIA,Decennial Census of Island Areas,decennial,,"Decennial census for U.S. island territories providing population and housing counts for Puerto Rico, Guam, CNMI, American Samoa, and the U.S. Virgin Islands." +DECENNIALYOEAS,American Samoa Year of Entry File,"Decennial Census American Samoa Year of Entry File provides population counts cross-tabulated by year of entry into American Samoa, supporting analysis of migration flows and length of residence within the territory.",dec/asyoe,DECIA,Decennial Census of Island Areas,decennial,,"Decennial census for U.S. island territories providing population and housing counts for Puerto Rico, Guam, CNMI, American Samoa, and the U.S. Virgin Islands." +DECENNIALMP,Commonwealth of the Northern Mariana Islands Summary File,Decennial Census Commonwealth of the Northern Mariana Islands (CNMI) Summary File provides 100-percent population and housing counts for CNMI at all available geographic levels within the territory.,dec/mp,DECIA,Decennial Census of Island Areas,decennial,,"Decennial census for U.S. island territories providing population and housing counts for Puerto Rico, Guam, CNMI, American Samoa, and the U.S. Virgin Islands." +DECENNIALGU,Guam Summary File,"Decennial Census Guam Summary File provides 100-percent population and housing counts for Guam, including age, sex, race, and housing characteristics at all available geographic levels within the territory.",dec/gu,DECIA,Decennial Census of Island Areas,decennial,,"Decennial census for U.S. island territories providing population and housing counts for Puerto Rico, Guam, CNMI, American Samoa, and the U.S. Virgin Islands." +DECENNIALVI,U.S. Virgin Islands Summary File,"Decennial Census U.S. Virgin Islands Summary File provides 100-percent population and housing counts for the U.S. Virgin Islands at all available geographic levels, including age, sex, race, Hispanic origin, and housing tenure.",dec/vi,DECIA,Decennial Census of Island Areas,decennial,,"Decennial census for U.S. island territories providing population and housing counts for Puerto Rico, Guam, CNMI, American Samoa, and the U.S. Virgin Islands." +DECENNIALCROSSTABVI,U.S. Virgin Islands Detailed Crosstabulations,Decennial Census U.S. Virgin Islands Detailed Crosstabulations provide additional multi-way cross-tabulations of population and housing characteristics for the U.S. Virgin Islands beyond those available in the standard summary file.,dec/crosstabvi,DECIA,Decennial Census of Island Areas,decennial,,"Decennial census for U.S. island territories providing population and housing counts for Puerto Rico, Guam, CNMI, American Samoa, and the U.S. Virgin Islands." +ISLANDAREAS,Economic Census of Island Areas,"Economic Census of Island Areas provides the official five-year economic measure for U.S. territories (Puerto Rico, U.S. Virgin Islands, Guam, CNMI, American Samoa), covering establishments, employment, payroll, and revenue by NAICS industry.",ecn/islandareas,ECNIA,Economic Census of Island Areas,quinquennial,"Conducted in years ending in 2 or 7, aligned with the Economic Census cycle.","Economic census for U.S. island territories (Puerto Rico, Guam, CNMI, USVI, American Samoa). Covers employment, payroll, and revenue by industry for each territory." +ISLANDAREASCOMP,Economic Census of Island Areas,"Economic Census of Island Areas Comparative Statistics compare current census results to the prior census for U.S. territories, enabling analysis of economic change over the five-year period by NAICS industry.",ecn/islandareas/comp,ECNIA,Economic Census of Island Areas,quinquennial,"Conducted in years ending in 2 or 7, aligned with the Economic Census cycle.","Economic census for U.S. island territories (Puerto Rico, Guam, CNMI, USVI, American Samoa). Covers employment, payroll, and revenue by industry for each territory." +ISLANDAREASIND,Economic Census of Island Areas,"Economic Census of Island Areas Industry Data provide detailed NAICS-industry tabulations of establishment, employment, payroll, and revenue for individual U.S. territories.",ecn/islandareas/ind,ECNIA,Economic Census of Island Areas,quinquennial,"Conducted in years ending in 2 or 7, aligned with the Economic Census cycle.","Economic census for U.S. island territories (Puerto Rico, Guam, CNMI, USVI, American Samoa). Covers employment, payroll, and revenue by industry for each territory." +ISLANDAREASLINES,Economic Census of Island Areas,"Economic Census of Island Areas Lines of Business Data report sales and revenue by major product or service line for establishments in U.S. territories, organized by kind of business.",ecn/islandareas/lines,ECNIA,Economic Census of Island Areas,quinquennial,"Conducted in years ending in 2 or 7, aligned with the Economic Census cycle.","Economic census for U.S. island territories (Puerto Rico, Guam, CNMI, USVI, American Samoa). Covers employment, payroll, and revenue by industry for each territory." +ISLANDAREASNAPCS,Economic Census of Island Areas,"Economic Census of Island Areas NAPCS Data report revenue by NAPCS product line for establishments in U.S. territories, providing product-level economic detail for territorial economies.",ecn/islandareas/napcs,ECNIA,Economic Census of Island Areas,quinquennial,"Conducted in years ending in 2 or 7, aligned with the Economic Census cycle.","Economic census for U.S. island territories (Puerto Rico, Guam, CNMI, USVI, American Samoa). Covers employment, payroll, and revenue by industry for each territory." +SIPP2008CORE,Core,"Survey of Income and Program Participation (SIPP) 2008 Panel Core data are longitudinal household interview records tracking income, program participation, employment, and family dynamics over multiple years. The 2008 panel followed households through 2013 using quarterly interviews.",sipp/core,SIPP,Survey of Income and Program Participation,quarterly,"Quarterly core interviews from the 2008 SIPP panel; panel-based design means data represent a fixed cohort followed over time, not a recurring cross-sectional sample.","Longitudinal panel survey tracking income, program participation, employment, and family dynamics for U.S. households over multiple years. Key source for poverty and benefit eligibility analysis." +PDBTRACT,Planning Database Tract Level,"Planning Database (PDB) Tract-Level file compiles ACS 5-year estimates alongside Census Bureau operational data (mail return rates, use of administrative records) at the census tract level. Designed to help survey planners identify hard-to-survey populations and target resources.",pdb/tract,PDB,Census Planning Database,annual,Updated annually following each new ACS 5-year release; not independently fielded.,Tract- and county-level planning database combining Census operational data with ACS estimates. Used to identify hard-to-count populations and plan census outreach. +PDBBLOCKGROUP,Planning Database Block Group Level,Planning Database (PDB) Block Group-Level file provides ACS 5-year estimates and operational indicators at the census block group level-the most granular geography available in the PDB-for local-area hard-to-survey population analysis.,pdb/blockgroup,PDB,Census Planning Database,annual,Updated annually following each new ACS 5-year release; not independently fielded.,Tract- and county-level planning database combining Census operational data with ACS estimates. Used to identify hard-to-count populations and plan census outreach. +PDBSTATECOUNTY,Planning Database - State and County Level,"Planning Database (PDB) State and County-Level file aggregates ACS 5-year socioeconomic estimates and census operational metrics to the county and state level, enabling state-wide and county-wide analyses of survey participation barriers.",pdb/statecounty,PDB,Census Planning Database,annual,Updated annually following each new ACS 5-year release; not independently fielded.,Tract- and county-level planning database combining Census operational data with ACS estimates. Used to identify hard-to-count populations and plan census outreach. +SAHIE,Small Area Health Insurance Estimates,"Small Area Health Insurance Estimates (SAHIE) provide annually updated estimates of health insurance coverage status for all counties and states, modeled using CPS, Medicaid/CHIP enrollment, tax, and census data. The primary source for sub-state uninsurance rates.",timeseries/healthins/sahie,SAHIE,Small Area Health Insurance Estimates,annual,,Annual model-based estimates of health insurance coverage by demographic subgroup for all U.S. counties and states. Used for public health planning and program eligibility. +SAIPESCHOOLDISTRICTS,Small Area Income and Poverty Estimates: School Districts,SAIPE School District Poverty Estimates provide annually updated counts and rates of children aged 5-17 in poverty for all U.S. school districts. Required by the Elementary and Secondary Education Act to allocate Title I education funding.,timeseries/poverty/saipe/schdist,SAIPE,Small Area Income and Poverty Estimates,annual,,Annual model-based estimates of income and poverty for all U.S. counties and school districts. Used to allocate federal education funding under Title I. +SAIPESTATECOUNTY,Small Area Income and Poverty Estimates: State and County,"Small Area Income and Poverty Estimates (SAIPE) State and County file provides annually updated estimates of median household income and poverty rates for every U.S. county, state, and the nation. SAIPE combines CPS, tax, and administrative data to produce more current estimates than ACS for smaller areas.",poverty/saipe,SAIPE,Small Area Income and Poverty Estimates,annual,,Annual model-based estimates of income and poverty for all U.S. counties and school districts. Used to allocate federal education funding under Title I. +PSEOFLOWS,Post-Secondary Employment Outcomes (PSEO) - Flows,Post-Secondary Employment Outcomes (PSEO) Flows data measure the geographic mobility of graduates-tracking where they work relative to where they attended school-providing industry and state-level employment flows for postsecondary completers.,timeseries/pseo/flows,PSEO,Post-Secondary Employment Outcomes (PSEO),annual,Experimental data product; coverage expands as new institutional data-sharing agreements are added. Annual releases.,"Earnings and employment outcomes for college graduates linked to unemployment insurance records. Covers outcomes by institution, degree level, and field of study." +PSEOEARNINGS,Post-Secondary Employment Outcomes (PSEO) - Earnings,"Post-Secondary Employment Outcomes (PSEO) Earnings data link postsecondary transcripts to longitudinal employment records to measure earnings outcomes by institution, field of study, degree level, and graduate cohort year.",timeseries/pseo/earnings,PSEO,Post-Secondary Employment Outcomes (PSEO),annual,Experimental data product; coverage expands as new institutional data-sharing agreements are added. Annual releases.,"Earnings and employment outcomes for college graduates linked to unemployment insurance records. Covers outcomes by institution, degree level, and field of study." +FTD14IMPEXPHIST,Historical Imports and Exports,"Historical Imports and Exports (FTD) provide long time-series of U.S. merchandise trade by commodity and country partner, compiled from historical trade statistics reports. Useful for trend analysis of U.S. trade patterns over multiple decades.",intltrade/imp_exp,IT,International Trade,annual,Annual compilation of historical import/export data; not an independently fielded survey.,"Monthly and annual statistics on U.S. imports and exports by commodity, country, port, and mode of transport. The official source for U.S. international trade data." +SUSB,Statistics of U.S. Businesses,"Statistics of U.S. Businesses (SUSB) provide establishment-level tabulations of employment and payroll by NAICS industry, enterprise employment size class, and geography (national, state, metro, county). Widely used for analyzing the size distribution of employer businesses.",ecnsusb,SUB,Statistics of U.S. Businesses,annual,,"Annual statistics on the number of businesses, employment, and payroll by industry, geography, and firm size. Covers both employer and nonemployer businesses." +EITSADVM3,Economic Indicators Advanced M3,"Advance Monthly Survey of Manufacturers' Shipments, Inventories and Orders (M3/ADV-M3) provides early-release monthly data on shipments, new orders, unfilled orders, and inventories for durable and nondurable goods manufacturers. A leading economic indicator for manufacturing sector activity.",timeseries/eitsadvm3,EITS,Economic Indicators,monthly,,"Monthly and quarterly economic indicator releases covering construction, manufacturing, retail trade, and wholesale trade. Used for real-time tracking of U.S. economic activity." +IDBSINGLEYEAR,Time Series International Database: International Populations by Single Year of Age and Sex,"International Database (IDB) Single-Year Age and Sex data provide annual population estimates and projections for all countries and territories through 2050, broken down by single year of age and sex. Used for global demographic research and international program planning.",timeseries/idb/1year,IDB,International Database,annual,Updated periodically as new country-level data become available; release schedule is irregular.,"Demographic and socioeconomic estimates and projections for countries and regions worldwide. Covers population, age structure, fertility, mortality, and migration." +IDB5YR,Time Series International Database: International Populations by Single Year of Age and Sex,"International Database (IDB) 5-Year Age Group data aggregate IDB single-year estimates into standard 5-year age bands, providing a more manageable format for global comparative demographic analysis.",timeseries/idb/5year,IDB,International Database,periodic,Uses 5-year age groupings but is not collected on a quinquennial schedule; updated periodically as country-level data become available.,"Demographic and socioeconomic estimates and projections for countries and regions worldwide. Covers population, age structure, fertility, mortality, and migration." +HHPULSE,High Frequency Social and Economic Data,"Household Pulse Survey (HPS) is an experimental high-frequency online survey measuring how the COVID-19 pandemic and its aftermath affected households across social and economic dimensions-employment, food sufficiency, housing stability, mental health, and access to health care. Released weekly or biweekly in rotating phases.",timeseries/hhpulse,HPS,Household Pulse Survey,weekly,Deployed rapidly in response to emergent crises; collection cadence and active phases vary. Original phase launched March 2020 in response to COVID-19.,"Rapid-turnaround online survey measuring household experiences during and after national emergencies, including employment, housing stability, food security, and mental health." +GEOINFO,Geography Information,"Geographic Information (GEOINFO) provides reference data on Census geographic units-including FIPS codes, names, geographic types, and vintage information-for all summary levels used across Census Bureau data products. Used to look up and validate geography identifiers for API queries.",geoinfo,GEO,Geography,annual,Updated annually to reflect geographies disseminated across all active Census programs that calendar year; not an independently fielded survey.,"Reference data for all Census Bureau geographic entities including summary levels, FIPS codes, names, and vintage information. Used to look up and validate geography identifiers for API queries." +CRE,Community Resilience Estimates,"Community Resilience Estimates (CRE) measure the capacity of communities to absorb, endure, and recover from adverse situations. The CRE assigns estimated risk factor counts to every census tract based on social vulnerability indicators from ACS data, supporting disaster preparedness and public health response planning.",cre,CRE,Community Resilience Estimates,annual,"Released on the annual ACS cycle; derived from ACS microdata, not an independently fielded survey.","Tract-level estimates of population vulnerability to disasters based on ACS social indicators. Used for emergency preparedness, public health response, and resilience planning." +GOVS,Public Sector Annual Surveys and Census of Governments,"Public Sector Annual Surveys and Census of Governments time series provide annual statistics on the finances (revenues, expenditures, debt) and employment of state and local governments, aggregated from annual surveys and the quinquennial Census of Governments. Key source for public finance and intergovernmental fiscal analysis.",timeseries/govs,PUB,Public Sector,quinquennial,Census of Governments conducted in years ending in 2 or 7; annual surveys conducted in intervening years. API data reflects the quinquennial census component.,"Annual and quinquennial statistics on the finances, employment, and operations of state and local governments, including revenues, expenditures, debt, and pension funds." +BUILDINGPERMITSANNUAL,Annual Residential Building Permits,"Annual Residential Building Permits report the number of authorized new housing units by structure type (single-family, 2-4 unit, 5+ unit) at the national, state, metro, county, and permit-issuing place levels. An early indicator of housing supply and construction activity.",timeseries/buildingpermits/annual,BPSANN,Economic Indicator Programs,annual,,Annual building permits data for residential construction by structure type and geography. Used to track housing supply trends and construction activity. +BUILDINGPERMITSMONTHLY,Monthly Residential Building Permits,Monthly Residential Building Permits report the number of authorized new housing units by structure type at sub-annual frequency. Used by economists as a leading indicator of residential construction and housing market conditions.,timeseries/buildingpermits/monthly,BPSMON,Economic Monthly Indicators,monthly,,Monthly building permits data for residential construction. Provides early-indicator data on housing starts and construction activity at national and local levels. +BUILDINGPERMITSYTD,Year To Date Residential Building Permits,"Year-to-Date Residential Building Permits aggregate monthly permit authorizations through the current month of the reference year, enabling in-year tracking of cumulative new housing supply relative to prior years.",timeseries/buildingpermits/ytd,BPSYTD,Economic Year to Date Indicators,monthly,,Year-to-date cumulative building permits data for residential construction. Useful for tracking permit trends within a calendar year. +BDSFIRMS,Firm Statistics,"Business Dynamics Statistics (BDS) Firm Statistics measure business entry, exit, expansion, and contraction at the firm level (enterprise), distinct from the establishment-level BDS series. Useful for studying firm lifecycle dynamics.",timeseries/bds/firms,BDS,Business Dynamics Statistics,annual,,"Annual statistics on business formation, job creation, and destruction by firm age, size, and industry. Used to study entrepreneurship, economic dynamism, and labor market flows." +ZBP,Zipcode Business Patterns,"ZIP Code Business Patterns (ZBP) provide annual establishment counts, employment size distributions, and payroll by NAICS industry at the 5-digit ZIP code level. Useful for local market research, service-area analysis, and economic development planning at fine geographic granularity.",zbp,ANN,Annual Economic Surveys,annual,,"Annual economic surveys providing timely estimates of revenue, employment, and payroll between economic census years for key sectors including retail, services, and construction." +SOMA,Survey of Market Absorption,"Survey of Market Absorption (SOMA) tracks how quickly newly completed apartments are rented in the private rental market. Provides quarterly absorption rates by rent level and number of bedrooms for the U.S., regions, and selected metro areas, supporting rental housing market analysis.",timeseries/soma,SOMA,Survey of Market Absorption,quarterly,Tracks absorption of new rental units at 3-month intervals for up to 12 months after completion; each survey wave is tied to a specific construction completion cohort.,Quarterly survey tracking the absorption rate of new privately owned unsubsidized rental apartments into the housing market. Used for rental housing market analysis. +AHSHC,American Housing Survey Housing Costs,"AHS Housing Costs tabulation presents detailed owner and renter housing cost data derived from the American Housing Survey, including mortgage payments, insurance, taxes, utilities, and rent, used to measure affordability and cost burden.",ahs/hc,AHS,American Housing Survey,biennial,Conducted in odd-numbered years.,"Longitudinal survey of U.S. housing units tracking housing quality, costs, neighborhood conditions, and household mobility. Fielded biennially at national and select metro levels." +AHS10,American Housing Survey Housing Costs,"AHS 2010 wave dataset contains the American Housing Survey data collected in 2010, covering structural characteristics, neighborhood conditions, move history, and housing costs for the national housing stock panel.",ahs/10,AHS,American Housing Survey,biennial,Conducted in odd-numbered years.,"Longitudinal survey of U.S. housing units tracking housing quality, costs, neighborhood conditions, and household mobility. Fielded biennially at national and select metro levels." +AHS,American Housing Survey,"American Housing Survey (AHS) is the most comprehensive national housing survey, collecting data biennially on structural characteristics, neighborhood quality, housing costs, move history, and occupant characteristics. It follows a fixed panel of housing units rather than a fresh sample each round.",ahs,AHS,American Housing Survey,biennial,"Conducted in odd-numbered years. Sample redrawn in 1985, 2015, and 2025; cross-year comparisons should account for redesign breaks.","Longitudinal survey of U.S. housing units tracking housing quality, costs, neighborhood conditions, and household mobility. Fielded biennially at national and select metro levels." +AHSHCST,American Housing Survey Housing Costs,AHS Housing Costs Statistics tabulation provides summary statistics on housing cost burden-the share of income devoted to housing-and related cost variables from the American Housing Survey.,ahs/hcst,AHS,American Housing Survey,biennial,Conducted in odd-numbered years.,"Longitudinal survey of U.S. housing units tracking housing quality, costs, neighborhood conditions, and household mobility. Fielded biennially at national and select metro levels." +AHSPWSD,"American Housing Survey Plumbing, Water, and Sewage Disposal","AHS Plumbing, Water, and Sewage Disposal tabulation reports on access to complete plumbing facilities, the primary source of water supply, and sewage disposal method from the American Housing Survey. Used to monitor substandard housing conditions.",ahs/pwsd,AHS,American Housing Survey,biennial,Conducted in odd-numbered years.,"Longitudinal survey of U.S. housing units tracking housing quality, costs, neighborhood conditions, and household mobility. Fielded biennially at national and select metro levels." +CBP,County Business Patterns,"County Business Patterns (CBP) provides annual establishment counts, employment, and payroll by NAICS industry for every U.S. county, metro area, state, and the nation. Released annually, CBP is widely used for local economic analysis, market research, and policy planning.",cbp,ECNSVY,Economic Surveys,annual,,Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +NONEMP,Nonemployer Statistics,"Nonemployer Statistics (NES) are annual data on non-farm businesses without paid employees-primarily sole proprietors and partnerships with no payroll. Covers establishment counts and receipts by NAICS industry at the national, state, and county levels.",nonemp,ECNSVY,Economic Surveys,annual,,Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +BDS,Business Dynamics Statistics,"Business Dynamics Statistics (BDS) measure annual changes in employment and establishment counts, capturing births, deaths, expansions, and contractions of firms and establishments. Provides a unique longitudinal view of U.S. business dynamics by industry, geography, firm age, and firm size.",timeseries/bds,ECNSVY,Economic Surveys,annual,,Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +CFSHAZMAT,Commodity Flow Survey Hazmat Data,"Commodity Flow Survey (CFS) Hazardous Materials Data focus specifically on shipments of DOT-regulated hazardous materials, reporting value, weight, mode, and commodity type to support transportation safety planning and emergency preparedness.",cfshazmat,ECNSVY,Economic Surveys,quinquennial,"Conducted in years ending in 2 or 7, aligned with the Economic Census cycle.",Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +CFSAREA,Commodity Flow Survey - Geographic Area Data,"Commodity Flow Survey (CFS) Geographic Area Data report shipment value, weight, and mode of transport by origin state and NAICS industry sector, providing a national picture of freight flows from every U.S. region.",cfsarea,ECNSVY,Economic Surveys,quinquennial,"Conducted in years ending in 2 or 7, aligned with the Economic Census cycle.",Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +CFSTEMP,Commodity Flow Survey Temperature Data,"Commodity Flow Survey (CFS) Temperature-Controlled Shipments Data report freight shipped under refrigerated or heated conditions, covering food, pharmaceuticals, and other temperature-sensitive commodities by mode and region.",cfstemp,ECNSVY,Economic Surveys,quinquennial,"Conducted in years ending in 2 or 7, aligned with the Economic Census cycle.",Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +CFSEXPORT,Commodity Flow Survey Export Data,"Commodity Flow Survey (CFS) Export Data report the characteristics of shipments destined for export (value, weight, commodity, mode, origin) from U.S. locations, linking domestic freight flows to international trade.",cfsexport,ECNSVY,Economic Surveys,quinquennial,"Conducted in years ending in 2 or 7, aligned with the Economic Census cycle.",Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +CFSPRELIM,Commodity Flow Survey Preliminary Data,"Commodity Flow Survey (CFS) Preliminary Data provide early-release national totals for shipment value, weight, and ton-miles before the full geographic and commodity detail is available, offering a first look at current freight activity.",cfsprelim,ECNSVY,Economic Surveys,quinquennial,"Conducted in years ending in 2 or 7, aligned with the Economic Census cycle.",Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +VIUSA,All Vehicles,"Vehicle Inventory and Use Survey (VIUS) - All Vehicles provides detailed data on the characteristics and use of trucks operated by U.S. businesses, including fleet size, vehicle type, fuel, mileage, and cargo. Conducted periodically by the Census Bureau for DOT.",viusa,ECNSVY,Economic Surveys,periodic,"Conducted periodically; collected as part of Economic Census cycles 1963–2002, discontinued, then resumed in 2021.",Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +VIUSPUF,Vehicle Inventory and Use Survey Public Use File,"Vehicle Inventory and Use Survey (VIUS) Public Use File contains record-level microdata (with identifying information removed) for individual trucks in the VIUS sample, enabling custom analyses of commercial vehicle characteristics and use patterns.",viuspuf,ECNSVY,Economic Surveys,quinquennial,"Conducted every 5 years as part of Economic Census cycles 1963–2002, then discontinued; resumed in 2021.",Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +EITSQTAX,Quarterly Summary of State and Local Tax Revenue Timeseries,"Quarterly Summary of State and Local Government Tax Revenue (QTAX) provides quarterly tax collections for all 50 states and the District of Columbia, broken down by type of tax (property, sales, income, etc.). Key indicator of state fiscal capacity.",timeseries/eits/qtax,ECNSVY,Economic Surveys,quarterly,,Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +EITSQSPP,Time Series Economic Indicators Time Series: Quarterly Survey of Public Pensions,"Quarterly Survey of Public Pensions (QSPP) measures quarterly assets, liabilities, revenue, and expenditures of state and local government retirement systems. Provides timely data on the fiscal health of public pension funds.",timeseries/eits/qspp,ECNSVY,Economic Surveys,quarterly,,Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +ASMVALUE2012,Annual Survey of Manufactures Value,"Annual Survey of Manufactures (ASM) Value Series (2012 benchmark) provides value-of-shipments, inventories, and value-added estimates for manufacturing industries at national and state levels, anchored to the 2012 Economic Census benchmark.",timeseries/asm/value2012,ECNSVY,Economic Surveys,annual,,Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +ASMVALUE2017,Annual Survey of Manufactures Value,"Annual Survey of Manufactures (ASM) Value Series (2017 benchmark) provides updated manufacturing value-of-shipments, inventories, and value-added statistics anchored to the 2017 Economic Census benchmark.",timeseries/asm/value2017,ECNSVY,Economic Surveys,annual,,Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +ASMBENCHMARK2017,Annual Survey of Manufactures Benchmark 2017,"Annual Survey of Manufactures (ASM) Benchmark 2017 provides the final benchmarked national manufacturing statistics for the 2017 ASM cycle, aligned to the 2017 Economic Census for the most accurate ASM time series.",timeseries/asm/benchmark2017,ECNSVY,Economic Surveys,annual,,Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +ASMBENCHMARK,Annual Survey of Manufactures Benchmark,"Annual Survey of Manufactures (ASM) Benchmark provides the most recent benchmarked national manufacturing statistics aligned to the latest Economic Census, serving as the authoritative ASM reference point.",timeseries/asm/benchmark2022,ECNSVY,Economic Surveys,annual,,Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +ASMAREA2012,Annual Survey of Manufactures Area,"Annual Survey of Manufactures (ASM) Geographic Area Series (2012 benchmark) provides establishment counts, employment, payroll, and production statistics for manufacturing industries at state and sub-state levels, using the 2012 Economic Census as anchor.",timeseries/asm/area2012,ECNSVY,Economic Surveys,annual,,Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +ASMAREA2017,Annual Survey of Manufactures Area,"Annual Survey of Manufactures (ASM) Geographic Area Series (2017 benchmark) provides state and sub-state manufacturing statistics (employment, payroll, shipments) using the 2017 Economic Census as anchor.",timeseries/asm/area2017,ECNSVY,Economic Surveys,annual,,Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +ABSTCB,Annual Business Survey,"Annual Business Survey (ABS) provides data on business ownership by race, ethnicity, gender, and veteran status, along with R&D activity, innovation, and technology use for non-farm employer businesses. Combines and replaces the Survey of Business Owners and Annual Survey of Entrepreneurs.",abstcb,ECNSVY,Economic Surveys,annual,Annual collection beginning with survey year 2017; replaced the quinquennial Survey of Business Owners (SBO) for employer businesses.,Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +ABSCB,Annual Business Survey,"Annual Business Survey (ABS) Characteristics of Businesses module provides detailed data on business ownership demographics, financing, and operational characteristics for employer businesses.",abscb,ECNSVY,Economic Surveys,annual,Annual collection beginning with survey year 2017; replaced the quinquennial Survey of Business Owners (SBO) for employer businesses.,Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +ABSCBO,Annual Business Survey,"Annual Business Survey (ABS) Characteristics of Business Owners module provides demographic and socioeconomic profiles of business owners (race, gender, veteran status, education, citizenship) for employer businesses.",abscbo,ECNSVY,Economic Surveys,annual,Annual collection beginning with survey year 2017; replaced the quinquennial Survey of Business Owners (SBO) for employer businesses.,Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +ABSCS,Annual Business Survey,"Annual Business Survey (ABS) Company Summary module provides aggregate employment, payroll, and receipts by race/ethnicity, gender, veteran status, and firm size at national and state levels.",abscs,ECNSVY,Economic Surveys,annual,Annual collection beginning with survey year 2017; replaced the quinquennial Survey of Business Owners (SBO) for employer businesses.,Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +ASECB,Annual Survey of Entrepreneurs Characteristics of Businesses,"Annual Survey of Entrepreneurs (ASE) Characteristics of Businesses provides data on business financing, technology use, government contracting, and other operational characteristics for employer businesses, by owner demographics. Predecessor to the ABS.",ase/cscb,ECNSVY,Economic Surveys,annual,Annual collection for survey years 2014–2016; superseded by the Annual Business Survey (ABS) starting 2017.,Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +ASECBO,Annual Survey of Entrepreneurs Characteristics of Business Owners,"Annual Survey of Entrepreneurs (ASE) Characteristics of Business Owners provides owner demographic and socioeconomic profiles including race, gender, education, and immigration status. Predecessor to the ABS owner module.",ase/cscbo,ECNSVY,Economic Surveys,annual,Annual collection for survey years 2014–2016; superseded by the Annual Business Survey (ABS) starting 2017.,Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +ASECS,Annual Survey of Entrepreneurs Company Summary,"Annual Survey of Entrepreneurs (ASE) Company Summary provides aggregate employment, payroll, and receipts by owner race/ethnicity, gender, veteran status, and firm size. Predecessor to the ABS company summary.",ase/csa,ECNSVY,Economic Surveys,annual,Annual collection for survey years 2014–2016; superseded by the Annual Business Survey (ABS) starting 2017.,Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +SBOCS,Survey of Business Owners Company Summary,"Survey of Business Owners (SBO) Company Summary provides aggregate counts, receipts, payroll, and employment by owner race/ethnicity, sex, and veteran status for non-farm employer and nonemployer businesses.",sbo/cs,ECNSVY,Economic Surveys,quinquennial,Conducted in years ending in 2 or 7; discontinued after 2012 and superseded by the Annual Business Survey (ABS) starting 2017.,Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +SBOCB,Survey of Business Owners Characteristics of Business,"Survey of Business Owners (SBO) Characteristics of Business provides detailed data on business financing, contracting, and operations by owner race, ethnicity, and gender for non-farm employer businesses. The primary predecessor to the ABS.",sbo/cscb,ECNSVY,Economic Surveys,quinquennial,Conducted in years ending in 2 or 7; discontinued after 2012 and superseded by the Annual Business Survey (ABS) starting 2017.,Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +SBOCBO,Survey of Business Owners Characteristics of Business Owners,"Survey of Business Owners (SBO) Characteristics of Business Owners provides demographic profiles of business owners including race, sex, veteran status, and education for non-farm employer businesses.",sbo/cscbo,ECNSVY,Economic Surveys,quinquennial,Conducted in years ending in 2 or 7; discontinued after 2012 and superseded by the Annual Business Survey (ABS) starting 2017.,Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +ITMONTHLYEXPORTSENDUSE,Time Series International Trade: Monthly U.S. Exports by End-use Code,"Monthly U.S. Exports by End-Use Code classify goods exports by the Bureau of Economic Analysis end-use category (capital goods, consumer goods, industrial supplies, etc.), providing an economic-purpose view of export composition.",timeseries/intltrade/exports/enduseexport,ECNSVY,Economic Surveys,monthly,,Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +ITMONTHLYEXPORTSHITECH,Monthly U.S. Exports by Advanced Technology Code,"Monthly U.S. Exports by Advanced Technology Code report exports of products classified as high-tech under the BEA technology classification, enabling tracking of U.S. technology export trends.",timeseries/intltrade/exports/hitech,ECNSVY,Economic Surveys,monthly,,Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +ITMONTHLYEXPORTSHS,Time Series International Trade: Monthly U.S. Exports by Harmonized System (HS) Code,Monthly U.S. Exports by Harmonized System (HS) Code provide the most detailed commodity-level view of U.S. merchandise exports using the international HS classification system.,timeseries/intltrade/exports/hsexport,ECNSVY,Economic Surveys,monthly,,Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +ITMONTHLYEXPORTSNAICS,Monthly U.S. Exports by North American Industry Classification System (NAICS) Code,"Monthly U.S. Exports by NAICS Industry Code cross-reference merchandise exports to the producing industry using NAICS codes, bridging trade and production statistics.",timeseries/intltrade/exports/naics,ECNSVY,Economic Surveys,monthly,,Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +ITMONTHLYEXPORTSPORTHS,Monthly U.S. Exports by Port and Harmonized System (HS) Code,"Monthly U.S. Exports by Port and HS Code provide export statistics at the district/port of export level combined with HS commodity codes, supporting port-level trade analysis.",timeseries/intltrade/exports/porths,ECNSVY,Economic Surveys,monthly,,Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +ITMONTHLYEXPORTSSITC,Monthly U.S. Exports by Standard International Trade Classification (SITC) Code,"Monthly U.S. Exports by Standard International Trade Classification (SITC) Code provide exports in the UN-standard SITC classification, enabling international comparisons of U.S. trade patterns.",timeseries/intltrade/exports/sitc,ECNSVY,Economic Surveys,monthly,,Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +ITMONTHLYEXPORTSSTATEHS,Monthly U.S. Exports by State and Harmonized System (HS) Code,"Monthly U.S. Exports by State and HS Code report the origin state of export goods combined with HS commodity codes, linking sub-national production geography to international trade flows.",timeseries/intltrade/exports/statehs,ECNSVY,Economic Surveys,monthly,,Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +ITMONTHLYEXPORTSSTATENAICS,Monthly U.S. Exports by State and North American Industry Classification System (NAICS),"Monthly U.S. Exports by State and NAICS Code report export values by the origin state of the exporting industry using NAICS codes, enabling state-level export performance analysis by industry.",timeseries/intltrade/exports/statenaics,ECNSVY,Economic Surveys,monthly,,Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +ITMONTHLYEXPORTSUSDA,Monthly U.S. Exports by Department of Agriculture Code,"Monthly U.S. Exports by USDA Agricultural Code report agricultural commodity exports using the USDA's own classification system, supporting agricultural trade policy and market analysis.",timeseries/intltrade/exports/usda,ECNSVY,Economic Surveys,monthly,,Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +ITMONTHLYIMPORTSENDUSE,Monthly U.S. Imports by End-use Code,"Monthly U.S. Imports by End-Use Code classify goods imports by economic purpose (capital goods, consumer goods, industrial supplies, etc.), providing a BEA-category view of import composition.",timeseries/intltrade/imports/enduse,ECNSVY,Economic Surveys,monthly,,Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +ITMONTHLYIMPORTSHITECH,Monthly U.S. Imports by Advanced Technology Code,"Monthly U.S. Imports by Advanced Technology Code report imports of high-tech products under the BEA technology classification, enabling tracking of technology trade balances.",timeseries/intltrade/imports/hitech,ECNSVY,Economic Surveys,monthly,,Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +ITMONTHLYIMPORTSHS,Monthly U.S. Imports by Harmonized System (HS) Code,Monthly U.S. Imports by Harmonized System (HS) Code provide the most detailed commodity-level view of U.S. merchandise imports using the international HS classification.,timeseries/intltrade/imports/hs,ECNSVY,Economic Surveys,monthly,,Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +ITMONTHLYIMPORTSNAICS,Monthly U.S. Imports by North American Industry Classification System (NAICS) Code,"Monthly U.S. Imports by NAICS Industry Code cross-reference merchandise imports to the consuming industry, bridging trade and production statistics for import-demand analysis.",timeseries/intltrade/imports/naics,ECNSVY,Economic Surveys,monthly,,Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +ITMONTHLYIMPORTSPORTHS,Monthly U.S. Imports by Port and Harmonized System (HS) Code,"Monthly U.S. Imports by Port and HS Code provide import statistics at the district/port-of-entry level combined with HS commodity codes, supporting port-level trade analysis.",timeseries/intltrade/imports/porths,ECNSVY,Economic Surveys,monthly,,Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +ITMONTHLYIMPORTSSITC,Monthly U.S. Imports by Standard International Trade Classification (SITC) Code,"Monthly U.S. Imports by SITC Code provide imports in the UN-standard SITC classification, enabling international comparisons of U.S. import patterns.",timeseries/intltrade/imports/sitc,ECNSVY,Economic Surveys,monthly,,Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +ITMONTHLYIMPORTSSTATEHS,Monthly U.S. Imports by State and Harmonized System (HS) Code,"Monthly U.S. Imports by State of Destination and HS Code link import flows to the U.S. state where goods are ultimately consumed or processed, combined with HS commodity detail.",timeseries/intltrade/imports/statehs,ECNSVY,Economic Surveys,monthly,,Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +ITMONTHLYIMPORTSSTATENAICS,Monthly U.S. Imports by State and North American Industry Classification System (NAICS),"Monthly U.S. Imports by State of Destination and NAICS Code link import flows to the destination state using industry codes, supporting sub-national import demand analysis.",timeseries/intltrade/imports/statenaics,ECNSVY,Economic Surveys,monthly,,Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +ITMONTHLYIMPORTSUSDA,Monthly U.S. Imports by Department of Agriculture Code,"Monthly U.S. Imports by USDA Agricultural Code report agricultural commodity imports under the USDA classification, supporting agricultural trade policy and food security analysis.",timeseries/intltrade/imports/usda,ECNSVY,Economic Surveys,monthly,,Time-series economic surveys including Annual Survey of Manufactures and international trade data products. Provides annual estimates between economic census benchmarks. +ECNTYPE,"Mining: Detailed Statistics by Type of Operation for the U.S., States, and Offshore Areas","Economic Census Mining Detailed Statistics by Type of Operation break down mining sector employment, payroll, and receipts by operational type (e.g., surface vs. underground mining) for the U.S., states, and offshore areas.",ecntype,ECN,Economic Census,quinquennial,Conducted in years ending in 2 or 7.,"Comprehensive economic census conducted every 5 years covering employment, payroll, revenue, and operations for all U.S. industries and geographies. The benchmark for U.S. economic statistics." +ECNLOCMINE,"Mining: Location of Mines by Employment Size for Subsectors and Industries for the U.S., States, and Offshore Area","Economic Census Mining Location of Mines by Employment Size reports the number and distribution of mining establishments across employment size classes by NAICS subsector and industry, for the U.S., states, and offshore areas.",ecnlocmine,ECN,Economic Census,quinquennial,Conducted in years ending in 2 or 7.,"Comprehensive economic census conducted every 5 years covering employment, payroll, revenue, and operations for all U.S. industries and geographies. The benchmark for U.S. economic statistics." +ECNLOCMFG,"Manufacturing: Location of Manufacturing Establishments by Employment Size for the U.S., States, and Counties","Economic Census Manufacturing Location of Establishments by Employment Size reports the number of manufacturing establishments distributed across employment size classes by NAICS industry, for the U.S., states, and counties.",ecnlocmfg,ECN,Economic Census,quinquennial,Conducted in years ending in 2 or 7.,"Comprehensive economic census conducted every 5 years covering employment, payroll, revenue, and operations for all U.S. industries and geographies. The benchmark for U.S. economic statistics." +ECNBASIC,"Summary Statistics for the U.S., States, and Selected Geographies: 2022","Economic Census Summary Statistics for the U.S., States, and Selected Geographies provide the core business activity measures-number of establishments, sales/revenue, payroll, and employment-by NAICS industry sector at national, state, metro, county, and place levels. The primary entry point for Economic Census data.",ecnbasic,ECN,Economic Census,quinquennial,Conducted in years ending in 2 or 7.,"Comprehensive economic census conducted every 5 years covering employment, payroll, revenue, and operations for all U.S. industries and geographies. The benchmark for U.S. economic statistics." \ No newline at end of file diff --git a/mcp-db/migrations/1773071716018_create-programs-and-components-search-functions.ts b/mcp-db/migrations/1773071716018_create-programs-and-components-search-functions.ts new file mode 100644 index 0000000..5b76d8c --- /dev/null +++ b/mcp-db/migrations/1773071716018_create-programs-and-components-search-functions.ts @@ -0,0 +1,176 @@ +import { MigrationBuilder } from 'node-pg-migrate' +import { fileURLToPath } from 'url' +import path from 'path' +import { readFileSync } from 'fs' +import { parse } from 'csv-parse/sync' + +const __filename = fileURLToPath(import.meta.url) +const __dirname = path.dirname(__filename) + +interface CsvRow { + PROGRAM_STRING: string + PROGRAM_DESCRIPTION: string + COMPONENT_STRING: string + FREQUENCY: string + FREQUENCY_NOTES: string +} + +const csvPath = path.resolve(__dirname, '../data/components-programs.csv') +const csvData = parse(readFileSync(csvPath, 'utf8'), { + columns: true, + skip_empty_lines: true, +}) + +const escapeSql = (value: string | null | undefined): string => { + if (value === null || value === undefined || value.trim() === '') + return 'NULL' + return `'${value.replace(/'/g, "''")}'` +} +const programMap = new Map() +for (const row of csvData as CsvRow[]) { + const acronym = row.PROGRAM_STRING?.trim() + if (!acronym) continue + const description = row.PROGRAM_DESCRIPTION?.trim() + if (!programMap.has(acronym)) { + programMap.set(acronym, description ?? '') + } +} + +const programValues = Array.from(programMap.entries()) + .map( + ([acronym, description]) => + `(${escapeSql(acronym)}, ${escapeSql(description)})`, + ) + .join(',\n ') + +const componentValues = (csvData as CsvRow[]) + .map( + (row) => + `(${escapeSql(row.COMPONENT_STRING)}, ${escapeSql(row.FREQUENCY)}, ${escapeSql(row.FREQUENCY_NOTES)})`, + ) + .join(',\n ') + +export const listSurveyProgramsSQL = ` + CREATE OR REPLACE FUNCTION list_survey_programs() + RETURNS TABLE ( + program_label TEXT, + program_string VARCHAR(15), + description TEXT, + table_count INT + ) + LANGUAGE sql STABLE + AS $$ + SELECT + p.label AS program_label, + p.acronym AS program_string, + -- Prefer the explicit program description; fall back to the first + -- non-null component description so that programs without a + -- programs.description still get orientation text. + COALESCE( + NULLIF(TRIM(p.description), ''), + ( + SELECT c2.description + FROM components c2 + WHERE c2.program_id = p.id + AND c2.description IS NOT NULL + ORDER BY c2.id + LIMIT 1 + ) + ) AS description, + COUNT(DISTINCT dt.id)::INT AS table_count + FROM programs p + LEFT JOIN components c ON c.program_id = p.id + LEFT JOIN datasets d ON d.component_id = c.id + LEFT JOIN data_table_datasets dtd ON dtd.dataset_id = d.id + LEFT JOIN data_tables dt ON dt.id = dtd.data_table_id + GROUP BY p.id, p.label, p.acronym, p.description + ORDER BY p.label + $$; +` + +export const listSurveyComponentsSQL = ` + CREATE OR REPLACE FUNCTION list_survey_components(p_program_string TEXT) + RETURNS TABLE ( + component_label TEXT, + component_string VARCHAR(60), + api_endpoint VARCHAR(60), + frequency VARCHAR(50), + frequency_notes TEXT, + vintage_start INT, + vintage_end INT, + has_gaps BOOLEAN, + table_count INT, + description TEXT + ) + LANGUAGE sql STABLE + AS $$ + SELECT + c.label AS component_label, + c.component_id AS component_string, + c.api_endpoint, + c.frequency, + c.frequency_notes, + MIN(y.year)::INT AS vintage_start, + MAX(y.year)::INT AS vintage_end, + -- has_gaps: true when the year range is not fully contiguous. + -- NULL when no datasets are linked (nothing to compare). + CASE + WHEN COUNT(DISTINCT y.year) = 0 THEN NULL + ELSE (MAX(y.year) - MIN(y.year) + 1) != COUNT(DISTINCT y.year) + END AS has_gaps, + COUNT(DISTINCT dt.id)::INT AS table_count, + c.description + FROM programs p + JOIN components c ON c.program_id = p.id + LEFT JOIN datasets d ON d.component_id = c.id + LEFT JOIN years y ON y.id = d.year_id + LEFT JOIN data_table_datasets dtd ON dtd.dataset_id = d.id + LEFT JOIN data_tables dt ON dt.id = dtd.data_table_id + WHERE p.acronym = p_program_string + GROUP BY c.id, c.label, c.component_id, c.api_endpoint, + c.frequency, c.frequency_notes, c.description + ORDER BY c.label + $$; +` +export const updateProgramComponentColumns = ` + DO $$ + BEGIN + IF EXISTS (SELECT 1 FROM programs LIMIT 1) AND EXISTS (SELECT 1 FROM components LIMIT 1) THEN + + UPDATE programs SET description = v.description + FROM (VALUES + ${programValues} + ) AS v(acronym, description) + WHERE programs.acronym = v.acronym; + + UPDATE components SET + frequency = v.frequency, + frequency_notes = v.frequency_notes + FROM (VALUES + ${componentValues} + ) AS v(component_id, frequency, frequency_notes) + WHERE components.component_id = v.component_id; + + ELSE + RAISE NOTICE 'programs or components table is empty, skipping backfill for frequency and description columns.'; + END IF; + END $$; +` + +export async function up(pgm: MigrationBuilder): Promise { + pgm.addColumns('components', { + frequency: { type: 'varchar(50)' }, + frequency_notes: { type: 'text' }, + }) + + pgm.sql(updateProgramComponentColumns) + pgm.sql(listSurveyProgramsSQL) + pgm.sql(listSurveyComponentsSQL) +} + +export async function down(pgm: MigrationBuilder): Promise { + pgm.sql('DROP FUNCTION IF EXISTS list_survey_components(TEXT)') + pgm.sql('DROP FUNCTION IF EXISTS list_survey_programs()') + pgm.dropColumns('components', ['frequency', 'frequency_notes']) + pgm.sql('UPDATE programs SET description = NULL;') +} diff --git a/mcp-db/src/schema/components.schema.ts b/mcp-db/src/schema/components.schema.ts index 54ee0ed..c459472 100644 --- a/mcp-db/src/schema/components.schema.ts +++ b/mcp-db/src/schema/components.schema.ts @@ -6,6 +6,8 @@ export const RawComponentSchema = z.object({ COMPONENT_DESCRIPTION: z.string(), API_SHORT_NAME: z.string(), PROGRAM_STRING: z.string(), + FREQUENCY: z.string().optional(), + FREQUENCY_NOTES: z.string().optional(), }) export const RawComponentsArraySchema = z.array(RawComponentSchema) @@ -16,6 +18,8 @@ export const ComponentRecordSchema = z.object({ description: z.string(), api_endpoint: z.string(), program_id: z.number(), + frequency: z.string().optional(), + frequency_notes: z.string().optional(), }) export type ComponentRecord = z.infer @@ -65,6 +69,8 @@ export function transformComponentData( description: row.COMPONENT_DESCRIPTION, api_endpoint: row.API_SHORT_NAME, program_id: programId, + frequency: row.FREQUENCY, + frequency_notes: row.FREQUENCY_NOTES, }) } }) diff --git a/mcp-db/src/schema/program.schema.ts b/mcp-db/src/schema/program.schema.ts index da62955..1567855 100644 --- a/mcp-db/src/schema/program.schema.ts +++ b/mcp-db/src/schema/program.schema.ts @@ -3,6 +3,7 @@ import { z } from 'zod' export const RawProgramSchema = z.object({ PROGRAM_STRING: z.string(), PROGRAM_LABEL: z.string(), + PROGRAM_DESCRIPTION: z.string().optional(), }) export const RawProgramsArraySchema = z.array(RawProgramSchema) @@ -10,6 +11,7 @@ export const RawProgramsArraySchema = z.array(RawProgramSchema) export const ProgramRecordSchema = z.object({ acronym: z.string(), label: z.string(), + description: z.string().optional(), }) export type ProgramRecord = z.infer @@ -42,6 +44,7 @@ export function transformProgramData(rawData: unknown): { uniquePrograms.set(row.PROGRAM_STRING, { acronym: row.PROGRAM_STRING, label: row.PROGRAM_LABEL, + description: row.PROGRAM_DESCRIPTION, }) } }) diff --git a/mcp-db/tests/migrations/1773071716018_create-programs-and-components-search-functions.test.ts b/mcp-db/tests/migrations/1773071716018_create-programs-and-components-search-functions.test.ts new file mode 100644 index 0000000..e2b2fc3 --- /dev/null +++ b/mcp-db/tests/migrations/1773071716018_create-programs-and-components-search-functions.test.ts @@ -0,0 +1,148 @@ +import { afterEach, beforeEach, describe, it, expect, vi } from 'vitest' +import { MigrationBuilder } from 'node-pg-migrate' + +vi.mock('fs', () => ({ + readFileSync: vi + .fn() + .mockReturnValue( + `COMPONENT_STRING,COMPONENT_LABEL,COMPONENT_DESCRIPTION,API_SHORT_NAME,PROGRAM_STRING,PROGRAM_LABEL,FREQUENCY,FREQUENCY_NOTES,PROGRAM_DESCRIPTION\n` + + `acs/acs1,1-Year Estimates,ACS 1-year estimates,acs/acs1,ACS,American Community Survey,Annual,,Continuous monthly survey pooled into 1-year and 5-year estimates\n` + + `dec/dec1,Summary File 1,Decennial summary file,dec/dec1,DEC,It's the Decennial Census,,Notes with 'quotes',It's the Decennial Census description\n`, + ), +})) + +describe('Migration - Create Programs and Components Search Functions', () => { + let mockPgm: MigrationBuilder + let addColumnsSpy: ReturnType + let dropColumnsSpy: ReturnType + let sqlSpy: ReturnType + + beforeEach(async () => { + addColumnsSpy = vi.fn().mockResolvedValue(undefined) + dropColumnsSpy = vi.fn().mockResolvedValue(undefined) + sqlSpy = vi.fn().mockResolvedValue(undefined) + + mockPgm = { + addColumns: addColumnsSpy, + dropColumns: dropColumnsSpy, + sql: sqlSpy, + } as Partial as MigrationBuilder + }) + + afterEach(() => { + vi.clearAllMocks() + vi.resetModules() + }) + + describe('updateProgramComponentColumns SQL', () => { + let updateProgramComponentColumns: string + + beforeEach(async () => { + const migration = await import( + '../../migrations/1773071716018_create-programs-and-components-search-functions' + ) + updateProgramComponentColumns = migration.updateProgramComponentColumns + }) + + it('escapes single quotes in program descriptions', () => { + expect(updateProgramComponentColumns).toContain( + `'It''s the Decennial Census description'`, + ) + }) + + it('escapes single quotes in component frequency_notes', () => { + expect(updateProgramComponentColumns).toContain(`'Notes with ''quotes'''`) + }) + + it('converts empty frequency to NULL', () => { + expect(updateProgramComponentColumns).toContain(`'dec/dec1', NULL,`) + }) + + it('converts empty frequency_notes to NULL', () => { + expect(updateProgramComponentColumns).toContain( + `'acs/acs1', 'Annual', NULL`, + ) + }) + + it('includes valid program values', () => { + expect(updateProgramComponentColumns).toContain( + `'ACS', 'Continuous monthly survey pooled into 1-year and 5-year estimates'`, + ) + }) + }) + + describe('up', () => { + beforeEach(async () => { + const { up } = await import( + '../../migrations/1773071716018_create-programs-and-components-search-functions' + ) + await up(mockPgm) + }) + + it('adds frequency and frequency_notes columns to components', () => { + expect(addColumnsSpy).toHaveBeenCalledWith('components', { + frequency: { type: 'varchar(50)' }, + frequency_notes: { type: 'text' }, + }) + }) + + it('runs the backfill SQL for program and component columns', async () => { + const { updateProgramComponentColumns } = vi.mocked( + await import( + '../../migrations/1773071716018_create-programs-and-components-search-functions' + ), + ) + expect(sqlSpy).toHaveBeenCalledWith(updateProgramComponentColumns) + }) + + it('runs backfill before creating survey functions', () => { + const backfillOrder = sqlSpy.mock.invocationCallOrder[0] + const programsFnOrder = sqlSpy.mock.invocationCallOrder[1] + const componentsFnOrder = sqlSpy.mock.invocationCallOrder[2] + + expect(backfillOrder).toBeLessThan(programsFnOrder) + expect(backfillOrder).toBeLessThan(componentsFnOrder) + }) + }) + + describe('down', () => { + beforeEach(async () => { + const { down } = await import( + '../../migrations/1773071716018_create-programs-and-components-search-functions' + ) + await down(mockPgm) + }) + + it('drops the list_survey_components function', () => { + expect(sqlSpy).toHaveBeenCalledWith( + 'DROP FUNCTION IF EXISTS list_survey_components(TEXT)', + ) + }) + + it('drops the list_survey_programs function', () => { + expect(sqlSpy).toHaveBeenCalledWith( + 'DROP FUNCTION IF EXISTS list_survey_programs()', + ) + }) + + it('drops frequency and frequency_notes columns from components', () => { + expect(dropColumnsSpy).toHaveBeenCalledWith('components', [ + 'frequency', + 'frequency_notes', + ]) + }) + + it('nulls out program descriptions', () => { + expect(sqlSpy).toHaveBeenCalledWith( + 'UPDATE programs SET description = NULL;', + ) + }) + + it('drops functions before dropping columns', () => { + const dropColumnsOrder = dropColumnsSpy.mock.invocationCallOrder[0] + const dropComponentsFnOrder = sqlSpy.mock.invocationCallOrder[0] + + expect(dropComponentsFnOrder).toBeLessThan(dropColumnsOrder) + }) + }) +}) diff --git a/mcp-db/tests/schema/component.schema.test.ts b/mcp-db/tests/schema/component.schema.test.ts index d5e1549..8cb582e 100644 --- a/mcp-db/tests/schema/component.schema.test.ts +++ b/mcp-db/tests/schema/component.schema.test.ts @@ -13,6 +13,18 @@ const validRawComponentData = { 'ACS 1-Year Supplemental Estimates extend standard 1-year ACS coverage to smaller geographic areas.', API_SHORT_NAME: 'acs/acsse', PROGRAM_STRING: 'ACS', + FREQUENCY: 'Annual', + FREQUENCY_NOTES: + 'Supplemental estimates released roughly one month after standard 1-year products.', +} + +const validRawComponentDataNoOptionals = { + COMPONENT_STRING: 'ACSSE', + COMPONENT_LABEL: '1-Year Supplemental Estimates', + COMPONENT_DESCRIPTION: + 'ACS 1-Year Supplemental Estimates extend standard 1-year ACS coverage to smaller geographic areas.', + API_SHORT_NAME: 'acs/acsse', + PROGRAM_STRING: 'ACS', } const invalidRawComponentData = { @@ -28,6 +40,8 @@ const multipleRawComponents = [ COMPONENT_DESCRIPTION: 'ACS 1-Year Supplemental Estimates.', API_SHORT_NAME: 'acs/acsse', PROGRAM_STRING: 'ACS', + FREQUENCY: 'Annual', + FREQUENCY_NOTES: '', }, { COMPONENT_STRING: 'ACSDT5Y', @@ -35,6 +49,8 @@ const multipleRawComponents = [ COMPONENT_DESCRIPTION: 'ACS 5-Year Detailed Tables.', API_SHORT_NAME: 'acs/acs5', PROGRAM_STRING: 'ACS', + FREQUENCY: 'Annual', + FREQUENCY_NOTES: '', }, { COMPONENT_STRING: 'ACSSE', @@ -42,6 +58,8 @@ const multipleRawComponents = [ COMPONENT_DESCRIPTION: 'ACS 1-Year Supplemental Estimates.', API_SHORT_NAME: 'acs/acsse', PROGRAM_STRING: 'ACS', + FREQUENCY: 'Annual', + FREQUENCY_NOTES: '', }, ] @@ -76,6 +94,13 @@ describe('ComponentsSchema', () => { expect(result.success).toBe(true) }) + it('should validate without optional FREQUENCY and FREQUENCY_NOTES', () => { + const result = RawComponentSchema.safeParse( + validRawComponentDataNoOptionals, + ) + expect(result.success).toBe(true) + }) + it('should invalidate missing COMPONENT_DESCRIPTION', () => { const result = RawComponentSchema.safeParse({ ...validRawComponentData, @@ -102,7 +127,20 @@ describe('ComponentsSchema', () => { }) describe('ComponentRecordSchema', () => { - it('validates a complete record', () => { + it('validates a complete record with optional fields', () => { + const result = ComponentRecordSchema.safeParse({ + component_id: 'ACSSE', + label: '1-Year Supplemental Estimates', + description: 'ACS 1-Year Supplemental Estimates.', + api_endpoint: 'acs/acsse', + program_id: 1, + frequency: 'Annual', + frequency_notes: 'Released roughly one month after standard products.', + }) + expect(result.success).toBe(true) + }) + + it('validates a record without optional frequency fields', () => { const result = ComponentRecordSchema.safeParse({ component_id: 'ACSSE', label: '1-Year Supplemental Estimates', @@ -141,7 +179,7 @@ describe('ComponentsSchema', () => { expect(result).toHaveLength(2) // ACSSE and ACSDT5Y }) - it('transforms data with correct field mappings', () => { + it('transforms data with correct field mappings including frequency fields', () => { const result = transformComponentData( [validRawComponentData], programIdMap, @@ -153,9 +191,39 @@ describe('ComponentsSchema', () => { 'ACS 1-Year Supplemental Estimates extend standard 1-year ACS coverage to smaller geographic areas.', api_endpoint: 'acs/acsse', program_id: 1, + frequency: 'Annual', + frequency_notes: + 'Supplemental estimates released roughly one month after standard 1-year products.', }) }) + it('maps frequency when present', () => { + const result = transformComponentData( + [validRawComponentData], + programIdMap, + ) + expect(result[0].frequency).toBe('Annual') + }) + + it('maps frequency_notes when present', () => { + const result = transformComponentData( + [validRawComponentData], + programIdMap, + ) + expect(result[0].frequency_notes).toBe( + 'Supplemental estimates released roughly one month after standard 1-year products.', + ) + }) + + it('omits frequency and frequency_notes when not present in source', () => { + const result = transformComponentData( + [validRawComponentDataNoOptionals], + programIdMap, + ) + expect(result[0].frequency).toBeUndefined() + expect(result[0].frequency_notes).toBeUndefined() + }) + it('deduplicates components by component_id', () => { const result = transformComponentData(multipleRawComponents, programIdMap) expect(result).toHaveLength(2) diff --git a/mcp-db/tests/seeds/configs/components.config.test.ts b/mcp-db/tests/seeds/configs/components.config.test.ts new file mode 100644 index 0000000..27df07c --- /dev/null +++ b/mcp-db/tests/seeds/configs/components.config.test.ts @@ -0,0 +1,115 @@ +import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest' +import { Client } from 'pg' + +import { ComponentsConfig } from '../../../src/seeds/configs/components.config' + +vi.mock('../../../src/schema/components.schema', async (importOriginal) => { + const actual = + await importOriginal< + typeof import('../../../src/schema/components.schema') + >() + return { + ...actual, + transformComponentData: vi.fn(actual.transformComponentData), + } +}) + +import { transformComponentData } from '../../../src/schema/components.schema' + +const fixtureRows = [ + { + COMPONENT_STRING: 'ACSSE', + COMPONENT_LABEL: '1-Year Supplemental Estimates', + COMPONENT_DESCRIPTION: 'ACS 1-Year Supplemental Estimates.', + API_SHORT_NAME: 'acs/acsse', + PROGRAM_STRING: 'ACS', + PROGRAM_LABEL: 'American Community Survey', + FREQUENCY: 'Annual', + FREQUENCY_NOTES: + 'Released roughly one month after standard 1-year products.', + PROGRAM_DESCRIPTION: + 'Continuous monthly survey pooled into 1-year and 5-year estimates.', + }, + { + COMPONENT_STRING: 'ACSDT5Y', + COMPONENT_LABEL: 'Detailed Tables 5-Year', + COMPONENT_DESCRIPTION: 'ACS 5-Year Detailed Tables.', + API_SHORT_NAME: 'acs/acs5', + PROGRAM_STRING: 'ACS', + PROGRAM_LABEL: 'American Community Survey', + FREQUENCY: 'Annual', + FREQUENCY_NOTES: '', + PROGRAM_DESCRIPTION: + 'Continuous monthly survey pooled into 1-year and 5-year estimates.', + }, +] + +describe('Components Config', () => { + let client: Client + let mockProgramIdMap: Map + + afterEach(() => { + vi.clearAllMocks() + }) + + beforeEach(() => { + mockProgramIdMap = new Map([['ACS', 1]]) + + client = { + query: vi.fn().mockResolvedValue({ + rows: [{ id: 1, acronym: 'ACS' }], + rowCount: 1, + }), + } as unknown as Client + }) + + it('should have valid configuration structure', () => { + expect(ComponentsConfig).toBeDefined() + expect(ComponentsConfig.table).toBe('components') + expect(ComponentsConfig.file).toBe('components-programs.csv') + expect(ComponentsConfig.conflictColumn).toBe('component_id') + expect(ComponentsConfig.beforeSeed).toBeDefined() + }) + + describe('beforeSeed logic', () => { + it('should query programs from the database', async () => { + const rawData: unknown[] = [...fixtureRows] + await ComponentsConfig.beforeSeed!(client, rawData) + expect(client.query).toHaveBeenCalledWith( + 'SELECT id, acronym FROM programs', + ) + }) + + it('should call transformComponentData with rawData and programIdMap', async () => { + const rawData: unknown[] = [...fixtureRows] + await ComponentsConfig.beforeSeed!(client, rawData) + expect(transformComponentData).toHaveBeenCalledWith( + rawData, + mockProgramIdMap, + ) + }) + + it('should replace rawData in place with transformed components', async () => { + const rawData: unknown[] = [...fixtureRows] + await ComponentsConfig.beforeSeed!(client, rawData) + + expect((rawData[0] as Record).component_id).toBeDefined() + expect( + (rawData[0] as Record).COMPONENT_STRING, + ).toBeUndefined() + }) + + it('should handle empty data array', async () => { + client = { + query: vi.fn().mockResolvedValue({ + rows: [], + rowCount: 0, + }), + } as unknown as Client + + await expect(ComponentsConfig.beforeSeed!(client, [])).rejects.toThrow( + 'transformComponentData called with empty programIdMap — ensure programs are seeded before components', + ) + }) + }) +}) diff --git a/mcp-db/tests/seeds/configs/programs.config.test.ts b/mcp-db/tests/seeds/configs/programs.config.test.ts new file mode 100644 index 0000000..5d936cd --- /dev/null +++ b/mcp-db/tests/seeds/configs/programs.config.test.ts @@ -0,0 +1,95 @@ +import { describe, it, expect, afterEach, vi } from 'vitest' + +vi.mock('../../../src/schema/program.schema', async (importOriginal) => { + const actual = + await importOriginal() + return { + ...actual, + transformProgramData: vi.fn(actual.transformProgramData), + } +}) + +import { Client } from 'pg' +import { ProgramsConfig } from '../../../src/seeds/configs/programs.config' +import { transformProgramData } from '../../../src/schema/program.schema' + +const fixturePrograms = [ + { + COMPONENT_STRING: 'ACSSE', + COMPONENT_LABEL: '1-Year Supplemental Estimates', + COMPONENT_DESCRIPTION: 'ACS 1-Year Supplemental Estimates.', + API_SHORT_NAME: 'acs/acsse', + PROGRAM_STRING: 'ACS', + PROGRAM_LABEL: 'American Community Survey', + FREQUENCY: 'Annual', + FREQUENCY_NOTES: '', + PROGRAM_DESCRIPTION: + 'Continuous monthly survey pooled into 1-year and 5-year estimates, covering demographics, income, education, housing, and commuting for all U.S. geographies.', + }, + { + COMPONENT_STRING: 'ACSDT5Y', + COMPONENT_LABEL: 'Detailed Tables 5-Year', + COMPONENT_DESCRIPTION: 'ACS 5-Year Detailed Tables.', + API_SHORT_NAME: 'acs/acs5', + PROGRAM_STRING: 'ACS', + PROGRAM_LABEL: 'American Community Survey', + FREQUENCY: 'Annual', + FREQUENCY_NOTES: '', + PROGRAM_DESCRIPTION: + 'Continuous monthly survey pooled into 1-year and 5-year estimates, covering demographics, income, education, housing, and commuting for all U.S. geographies.', + }, + { + COMPONENT_STRING: 'CPSMARCH', + COMPONENT_LABEL: 'March Supplement', + COMPONENT_DESCRIPTION: 'Annual Social and Economic Supplement.', + API_SHORT_NAME: 'cps/march', + PROGRAM_STRING: 'CPS', + PROGRAM_LABEL: 'Current Population Survey', + FREQUENCY: 'Annual', + FREQUENCY_NOTES: '', + PROGRAM_DESCRIPTION: + 'Monthly labor force survey providing official U.S. unemployment statistics.', + }, +] + +describe('Programs Config', () => { + afterEach(() => { + vi.clearAllMocks() + }) + + it('should have valid configuration structure', () => { + expect(ProgramsConfig).toBeDefined() + expect(ProgramsConfig.table).toBe('programs') + expect(ProgramsConfig.file).toBe('components-programs.csv') + expect(ProgramsConfig.conflictColumn).toBe('acronym') + expect(ProgramsConfig.beforeSeed).toBeDefined() + }) + + describe('beforeSeed', () => { + it('should call transformProgramData with rawData', () => { + const mockClient = {} as Client + const rawData: unknown[] = [...fixturePrograms] + + ProgramsConfig.beforeSeed!(mockClient, rawData) + + expect(transformProgramData).toHaveBeenCalledWith(rawData) + }) + + it('should replace rawData in place with transformed programs', () => { + const mockClient = {} as Client + const rawData: unknown[] = [...fixturePrograms] + + ProgramsConfig.beforeSeed!(mockClient, rawData) + + expect((rawData[0] as Record).acronym).toBeDefined() + expect( + (rawData[0] as Record).PROGRAM_STRING, + ).toBeUndefined() + }) + + it('should handle empty data array', () => { + const mockClient = {} as Client + expect(() => ProgramsConfig.beforeSeed!(mockClient, [])).not.toThrow() + }) + }) +}) diff --git a/mcp-server/eslint.config.js b/mcp-server/eslint.config.js index d8a2534..f191708 100644 --- a/mcp-server/eslint.config.js +++ b/mcp-server/eslint.config.js @@ -15,4 +15,14 @@ export default defineConfig([ languageOptions: { globals: globals.node }, }, tseslint.configs.recommended, + { + files: ['**/*.{ts,mts,cts}'], + rules: { + '@typescript-eslint/no-unused-vars': ['error', { + argsIgnorePattern: '^_', + varsIgnorePattern: '^_', + caughtErrorsIgnorePattern: '^_', + }], + }, + }, ]) diff --git a/mcp-server/package.json b/mcp-server/package.json index 35d3fe0..bbbc325 100644 --- a/mcp-server/package.json +++ b/mcp-server/package.json @@ -7,7 +7,7 @@ "format": "prettier --write .", "format:check": "prettier --check .", "inspect": "npx @modelcontextprotocol/inspector node dist/index.js", - "lint": "eslint . --ext .js,.jsx,.ts,.tsx", + "lint": "eslint . --ext .js,.jsx,.ts,.tsx --ignore-pattern dist/ --ignore-pattern build/", "prepare": "npm run build", "test": "vitest --printConsoleTrace=true --silent=false", "test:coverage": "vitest --coverage", diff --git a/mcp-server/src/index.ts b/mcp-server/src/index.ts index 2a0ef9e..27f7e7f 100644 --- a/mcp-server/src/index.ts +++ b/mcp-server/src/index.ts @@ -12,6 +12,7 @@ import { MCPServer } from './server.js' import { FetchAggregateDataTool } from './tools/fetch-aggregate-data.tool.js' import { FetchDatasetGeographyTool } from './tools/fetch-dataset-geography.tool.js' import { ListDatasetsTool } from './tools/list-datasets.tool.js' +import { ListSurveyProgramsTool } from './tools/list-survey-programs.tool.js' import { ResolveGeographyFipsTool } from './tools/resolve-geography-fips.tool.js' import { SearchDataTablesTool } from './tools/search-data-tables.tool.js' @@ -28,6 +29,7 @@ async function main() { mcpServer.registerTool(new FetchAggregateDataTool()) mcpServer.registerTool(new FetchDatasetGeographyTool()) mcpServer.registerTool(new ListDatasetsTool()) + mcpServer.registerTool(new ListSurveyProgramsTool()) mcpServer.registerTool(new ResolveGeographyFipsTool()) mcpServer.registerTool(new SearchDataTablesTool()) diff --git a/mcp-server/src/schema/list-survey-programs.schema.ts b/mcp-server/src/schema/list-survey-programs.schema.ts new file mode 100644 index 0000000..b5689cd --- /dev/null +++ b/mcp-server/src/schema/list-survey-programs.schema.ts @@ -0,0 +1,4 @@ +import { z } from 'zod' + +export const ListSurveyProgramsInputSchema = z.object({}) +export type ListSurveyProgramsArgs = z.infer \ No newline at end of file diff --git a/mcp-server/src/tools/list-survey-programs.tool.ts b/mcp-server/src/tools/list-survey-programs.tool.ts new file mode 100644 index 0000000..54065e2 --- /dev/null +++ b/mcp-server/src/tools/list-survey-programs.tool.ts @@ -0,0 +1,98 @@ +import { Tool } from '@modelcontextprotocol/sdk/types.js' + +import { BaseTool } from './base.tool.js' +import { DatabaseService } from '../services/database.service.js' +import { + ListSurveyProgramsArgs, + ListSurveyProgramsInputSchema, +} from '../schema/list-survey-programs.schema.js' +import { SurveyProgramRow } from '../types/survey-program.types.js' +import { ToolContent } from '../types/base.types.js' + +export const toolDescription = ` + Returns a complete index of all Census Bureau survey programs available in this MCP server. Use this tool at the start of a session or to determine what data is available, which surveys are covered, and how to find a dataset. No input arguments are required. + + Each result object includes: + - program_label: human-readable name of the program (e.g., "American Community Survey") + - program_string: short acronym used to identify the program (e.g., "ACS") + - description: brief orientation text describing the program's scope and methodology + - table_count: number of indexed data tables available for this program + + Programs without tables have no indexed tables — use fetch-aggregate-data with known variable names for those programs instead. + Table coverage summary: ACS (~83%), CPS (~14%), SIPP (~3%). Decennial Census, Population Estimates, and Decennial Census of Island Areas have limited coverage. Economic Census, Economic Surveys, Geography, Census Planning Database, and several other programs have no indexed tables. +` + +export class ListSurveyProgramsTool extends BaseTool { + name = 'list-survey-programs' + description = toolDescription + readonly requiresApiKey = false + + private dbService: DatabaseService + + inputSchema: Tool['inputSchema'] = { + type: 'object', + properties: {}, + required: [], + } + + get argsSchema() { + return ListSurveyProgramsInputSchema + } + + constructor() { + super() + this.handler = this.handler.bind(this) + this.dbService = DatabaseService.getInstance() + } + + private async listSurveyPrograms(): Promise { + const result = await this.dbService.query( + `SELECT * FROM list_survey_programs()`, + [], + ) + + return result.rows + } + + async toolHandler( + _args: ListSurveyProgramsArgs, + ): Promise<{ content: ToolContent[] }> { + try { + const isDbHealthy = await this.dbService.healthCheck() + if (!isDbHealthy) { + return this.createErrorResponse( + 'Database connection failed - cannot list survey programs.', + ) + } + + const results = await this.listSurveyPrograms() + + if (results && results.length > 0) { + return { + content: [ + { + type: 'text', + text: `Found ${results.length} Survey Program${results.length === 1 ? '' : 's'}:\n\n${JSON.stringify(results, null, 2)}`, + }, + ], + } + } else { + return { + content: [ + { + type: 'text', + text: 'No survey programs found.', + }, + ], + } + } + } catch (error) { + const errorMessage = + error instanceof Error ? error.message : 'Unknown error occurred' + + return this.createErrorResponse( + `Failed to list survey programs: ${errorMessage}`, + ) + } + } +} \ No newline at end of file diff --git a/mcp-server/src/types/survey-program.types.ts b/mcp-server/src/types/survey-program.types.ts new file mode 100644 index 0000000..e9826f4 --- /dev/null +++ b/mcp-server/src/types/survey-program.types.ts @@ -0,0 +1,6 @@ +export interface SurveyProgramRow { + program_label: string + program_string: string + description: string | null + table_count: number +} \ No newline at end of file diff --git a/mcp-server/tests/helpers/get-response-text.ts b/mcp-server/tests/helpers/get-response-text.ts new file mode 100644 index 0000000..54a13e3 --- /dev/null +++ b/mcp-server/tests/helpers/get-response-text.ts @@ -0,0 +1,12 @@ +export function getResponseText( + response: { content: Array<{ type: string; text?: string }> }, + index = 0, +): string { + const item = response.content[index] + if (item.type !== 'text') { + throw new Error( + `Expected content[${index}] to be type "text", got "${item.type}"`, + ) + } + return (item as { type: 'text'; text: string }).text +} \ No newline at end of file diff --git a/mcp-server/tests/index.test.ts b/mcp-server/tests/index.test.ts index a565fda..1ab4e57 100644 --- a/mcp-server/tests/index.test.ts +++ b/mcp-server/tests/index.test.ts @@ -15,6 +15,12 @@ vi.mock('../src/tools/list-datasets.tool.js', () => ({ .mockImplementation(() => ({ name: 'list-datasets' })), })) +vi.mock('../src/tools/list-survey-programs.tool.js', () => ({ + ListSurveyProgramsTool: vi + .fn() + .mockImplementation(() => ({ name: 'list-survey-programs' })), +})) + vi.mock('../src/tools/fetch-dataset-geography.tool.js', () => ({ FetchDatasetGeographyTool: vi .fn() @@ -75,7 +81,7 @@ describe('main', () => { name: 'population-prompt', }) - expect(toolRegistrySpy).toHaveBeenCalledTimes(5) + expect(toolRegistrySpy).toHaveBeenCalledTimes(6) expect(toolRegistrySpy).toHaveBeenCalledWith({ name: 'fetch-aggregate-data', @@ -84,6 +90,11 @@ describe('main', () => { expect(toolRegistrySpy).toHaveBeenCalledWith({ name: 'list-datasets', }) + + expect(toolRegistrySpy).toHaveBeenCalledWith({ + name: 'list-survey-programs', + }) + expect(toolRegistrySpy).toHaveBeenCalledWith({ name: 'fetch-dataset-geography', }) diff --git a/mcp-server/tests/schema/list-survey-programs.schema.test.ts b/mcp-server/tests/schema/list-survey-programs.schema.test.ts new file mode 100644 index 0000000..8de587e --- /dev/null +++ b/mcp-server/tests/schema/list-survey-programs.schema.test.ts @@ -0,0 +1,14 @@ +import { describe, it, expect } from 'vitest' +import { ListSurveyProgramsInputSchema } from '../../src/schema/list-survey-programs.schema' + +describe('ListSurveyProgramsInputSchema', () => { + it('should accept an empty object', () => { + expect(() => ListSurveyProgramsInputSchema.parse({})).not.toThrow() + }) + + it('should ignore unknown keys', () => { + expect(() => + ListSurveyProgramsInputSchema.parse({ unexpected: 'value' }), + ).not.toThrow() + }) +}) \ No newline at end of file diff --git a/mcp-server/tests/tools/list-survey-programs/list-survey-programs.integration.test.ts b/mcp-server/tests/tools/list-survey-programs/list-survey-programs.integration.test.ts new file mode 100644 index 0000000..365be65 --- /dev/null +++ b/mcp-server/tests/tools/list-survey-programs/list-survey-programs.integration.test.ts @@ -0,0 +1,203 @@ +import { + describe, + it, + expect, + beforeAll, + afterAll, + beforeEach, + afterEach, +} from 'vitest' +import { Client } from 'pg' + +import { DatabaseService } from '../../../src/services/database.service' +import { databaseConfig } from '../../helpers/database-config' +import { getResponseText } from '../../helpers/get-response-text.js' +import { ListSurveyProgramsTool } from '../../../src/tools/list-survey-programs.tool' + +describe('ListSurveyProgramsTool - Integration Tests', () => { + let testClient: Client + let databaseService: DatabaseService + let tool: ListSurveyProgramsTool + + beforeAll(async () => { + testClient = new Client(databaseConfig) + await testClient.connect() + ;(DatabaseService as unknown as { instance: unknown }).instance = undefined + databaseService = DatabaseService.getInstance() + }) + + afterAll(async () => { + await testClient.end() + await databaseService.cleanup() + }) + + afterEach(async () => { + await testClient.query('DELETE FROM data_table_datasets WHERE true') + await testClient.query('DELETE FROM data_tables WHERE true') + await testClient.query('DELETE FROM datasets WHERE true') + await testClient.query('DELETE FROM years WHERE true') + await testClient.query('DELETE FROM components WHERE true') + await testClient.query('DELETE FROM programs WHERE true') + + await testClient.query( + 'ALTER SEQUENCE IF EXISTS data_table_datasets_id_seq RESTART WITH 1', + ) + await testClient.query( + 'ALTER SEQUENCE IF EXISTS data_tables_id_seq RESTART WITH 1', + ) + await testClient.query( + 'ALTER SEQUENCE IF EXISTS datasets_id_seq RESTART WITH 1', + ) + await testClient.query( + 'ALTER SEQUENCE IF EXISTS years_id_seq RESTART WITH 1', + ) + await testClient.query( + 'ALTER SEQUENCE IF EXISTS components_id_seq RESTART WITH 1', + ) + await testClient.query( + 'ALTER SEQUENCE IF EXISTS programs_id_seq RESTART WITH 1', + ) + }) + + beforeEach(async () => { + tool = new ListSurveyProgramsTool() + + await testClient.query(` + INSERT INTO programs (acronym, label, description) + VALUES + ('ACS', 'American Community Survey', 'Ongoing survey providing annual demographic, social, economic, and housing data.'), + ('ECN', 'Economic Census', 'Official five-year measure of American business and the economy.') + `) + + await testClient.query(` + INSERT INTO components (label, api_endpoint, description, component_id, program_id) + VALUES ( + 'ACS 1-Year Estimates', + 'acs/acs1', + 'ACS 1-Year Estimates', + 'ACS1', + (SELECT id FROM programs WHERE acronym = 'ACS') + ) + `) + + await testClient.query(` + INSERT INTO years (year) VALUES (2022) + `) + + await testClient.query(` + INSERT INTO datasets (dataset_id, name, description, type, api_endpoint, year_id, component_id) + VALUES ( + 'ACSY2022', + 'ACS 1-Year 2022', + 'ACS 1-Year Detailed Tables 2022', + 'aggregate', + 'acs/acs1', + (SELECT id FROM years WHERE year = 2022), + (SELECT id FROM components WHERE api_endpoint = 'acs/acs1') + ) + `) + + await testClient.query(` + INSERT INTO data_tables (data_table_id, label) + VALUES ('B01001', 'Sex By Age') + `) + + await testClient.query(` + INSERT INTO data_table_datasets (data_table_id, dataset_id, label) + VALUES ( + (SELECT id FROM data_tables WHERE data_table_id = 'B01001'), + (SELECT id FROM datasets WHERE dataset_id = 'ACSY2022'), + 'Sex By Age' + ) + `) + }) + + it('returns all seeded programs', async () => { + const response = await tool.handler({}) + const text = getResponseText(response) + + expect(text).toContain('Found 2 Survey Programs:') + expect(text).toContain('American Community Survey') + expect(text).toContain('Economic Census') + }) + + it('returns programs ordered alphabetically by label', async () => { + const response = await tool.handler({}) + const text = getResponseText(response) + const parsed = JSON.parse(text.split('\n\n')[1]) + + const labels = parsed.map((p: { program_label: string }) => p.program_label) + expect(labels).toEqual([...labels].sort()) + }) + + it('reflects correct table_count for a program with indexed tables', async () => { + const response = await tool.handler({}) + const text = getResponseText(response) + const parsed = JSON.parse(text.split('\n\n')[1]) + + const acs = parsed.find((p: { program_string: string }) => p.program_string === 'ACS') + expect(acs.table_count).toBe(1) + }) + + it('reflects table_count of 0 for a program with no indexed tables', async () => { + const response = await tool.handler({}) + const text = getResponseText(response) + const parsed = JSON.parse(text.split('\n\n')[1]) + + const ecn = parsed.find((p: { program_string: string }) => p.program_string === 'ECN') + expect(ecn.table_count).toBe(0) + }) + + it('includes description for programs with an explicit description', async () => { + const response = await tool.handler({}) + const text = getResponseText(response) + const parsed = JSON.parse(text.split('\n\n')[1]) + + const acs = parsed.find((p: { program_string: string }) => p.program_string === 'ACS') + expect(acs.description).toBe( + 'Ongoing survey providing annual demographic, social, economic, and housing data.', + ) + }) + + it('falls back to component description when program description is absent', async () => { + // Seed a program with no description but a component that has one + await testClient.query(` + INSERT INTO programs (acronym, label) + VALUES ('CPS', 'Current Population Survey') + `) + await testClient.query(` + INSERT INTO components (label, api_endpoint, description, component_id, program_id) + VALUES ( + 'CPS Basic Monthly', + 'cps/basic/nov', + 'Monthly survey of households conducted for the Bureau of Labor Statistics.', + 'CPSBASIC', + (SELECT id FROM programs WHERE acronym = 'CPS') + ) + `) + + const response = await tool.handler({}) + const text = getResponseText(response) + const parsed = JSON.parse(text.split('\n\n')[1]) + + const cps = parsed.find((p: { program_string: string }) => p.program_string === 'CPS') + expect(cps.description).toBe( + 'Monthly survey of households conducted for the Bureau of Labor Statistics.', + ) + }) + + it('returns a no-results message when the programs table is empty', async () => { + // Clear all data seeded in beforeEach + await testClient.query('DELETE FROM data_table_datasets WHERE true') + await testClient.query('DELETE FROM data_tables WHERE true') + await testClient.query('DELETE FROM datasets WHERE true') + await testClient.query('DELETE FROM years WHERE true') + await testClient.query('DELETE FROM components WHERE true') + await testClient.query('DELETE FROM programs WHERE true') + + const response = await tool.handler({}) + const text = getResponseText(response) + + expect(text).toBe('No survey programs found.') + }) +}) \ No newline at end of file diff --git a/mcp-server/tests/tools/list-survey-programs/list-survey-programs.unit.test.ts b/mcp-server/tests/tools/list-survey-programs/list-survey-programs.unit.test.ts new file mode 100644 index 0000000..1a54ea7 --- /dev/null +++ b/mcp-server/tests/tools/list-survey-programs/list-survey-programs.unit.test.ts @@ -0,0 +1,198 @@ +import { + describe, + it, + expect, + beforeAll, + beforeEach, + afterEach, + vi, + Mock, +} from 'vitest' +import { TextContent } from '@modelcontextprotocol/sdk/types.js' + +vi.mock('../../../src/services/database.service.js', () => ({ + DatabaseService: { + getInstance: vi.fn(), + }, +})) + +import { validateToolStructure } from '../../helpers/test-utils' + +import { DatabaseService } from '../../../src/services/database.service.js' +import { + ListSurveyProgramsTool, + toolDescription, +} from '../../../src/tools/list-survey-programs.tool' +import { SurveyProgramRow } from '../../../src/types/survey-program.types' + +const mockSurveyPrograms: SurveyProgramRow[] = [ + { + program_label: 'American Community Survey', + program_string: 'ACS', + description: + 'Ongoing survey providing annual demographic, social, economic, and housing data for communities across the United States.', + table_count: 1200, + searchable: true, + }, + { + program_label: 'Current Population Survey', + program_string: 'CPS', + description: + 'Monthly survey of households conducted by the Census Bureau for the Bureau of Labor Statistics.', + table_count: 300, + searchable: true, + }, + { + program_label: 'Economic Census', + program_string: 'ECN', + description: + 'Official five-year measure of American business and the economy.', + table_count: 0, + searchable: false, + }, +] + +function getTextContent( + response: Awaited>, + index = 0, +): TextContent { + const item = response.content[index] + if (item.type !== 'text') { + throw new Error( + `Expected content[${index}] to be type "text", got "${item.type}"`, + ) + } + return item as TextContent +} + +describe('ListSurveyProgramsTool', () => { + let tool: ListSurveyProgramsTool + let mockDbService: { + healthCheck: Mock + query: Mock + } + + beforeAll(() => { + mockDbService = { + healthCheck: vi.fn(), + query: vi.fn(), + } + ;(DatabaseService.getInstance as Mock).mockReturnValue(mockDbService) + }) + + beforeEach(() => { + mockDbService.healthCheck.mockReset().mockResolvedValue(true) + mockDbService.query.mockReset().mockResolvedValue({ rows: mockSurveyPrograms }) + + tool = new ListSurveyProgramsTool() + }) + + afterEach(() => { + vi.clearAllMocks() + }) + + it('should have the correct metadata', () => { + validateToolStructure(tool) + expect(tool.name).toBe('list-survey-programs') + expect(tool.description).toBe(toolDescription) + expect(tool.requiresApiKey).toBe(false) + }) + + it('should have a valid input schema with no properties or required fields', () => { + const schema = tool.inputSchema + + expect(schema.type).toBe('object') + expect(schema.properties).toEqual({}) + expect(schema.required).toEqual([]) + }) + + describe('args schema validation', () => { + it('should accept an empty object', () => { + expect(() => tool.argsSchema.parse({})).not.toThrow() + }) + + it('should ignore unknown keys', () => { + expect(() => + tool.argsSchema.parse({ unexpected: 'value' }), + ).not.toThrow() + }) + }) + + describe('Response Handling', () => { + describe('when results are found', () => { + it('returns all survey programs', async () => { + const result = await tool.handler({}) + + expect(result.content).toHaveLength(1) + expect(result.content[0].type).toBe('text') + expect(getTextContent(result).text).toContain( + 'Found 3 Survey Programs:', + ) + expect(getTextContent(result).text).toContain('American Community Survey') + expect(getTextContent(result).text).toContain('Current Population Survey') + expect(getTextContent(result).text).toContain('Economic Census') + }) + + it('uses singular form when exactly one result is returned', async () => { + mockDbService.query.mockResolvedValue({ rows: [mockSurveyPrograms[0]] }) + + const result = await tool.handler({}) + + expect(getTextContent(result).text).toContain('Found 1 Survey Program:') + expect(getTextContent(result).text).not.toContain('Survey Programs:') + }) + + it('serialises all fields for each program', async () => { + const result = await tool.handler({}) + const parsed = JSON.parse(getTextContent(result).text.split('\n\n')[1]) + + const acs = parsed.find( + (p: SurveyProgramRow) => p.program_string === 'ACS', + ) + expect(acs.program_label).toBe('American Community Survey') + expect(acs.table_count).toBe(1200) + expect(acs.searchable).toBe(true) + }) + + it('correctly reflects searchable: false for programs without indexed tables', async () => { + const result = await tool.handler({}) + const parsed = JSON.parse(getTextContent(result).text.split('\n\n')[1]) + + const ecn = parsed.find( + (p: SurveyProgramRow) => p.program_string === 'ECN', + ) + expect(ecn.table_count).toBe(0) + expect(ecn.searchable).toBe(false) + }) + + it('handles null description gracefully', async () => { + const programWithNullDescription: SurveyProgramRow = { + ...mockSurveyPrograms[0], + description: null, + } + mockDbService.query.mockResolvedValue({ + rows: [programWithNullDescription], + }) + + const result = await tool.handler({}) + const parsed = JSON.parse(getTextContent(result).text.split('\n\n')[1]) + + expect(parsed[0].description).toBeNull() + }) + }) + + describe('when no results are found', () => { + beforeEach(() => { + mockDbService.query.mockResolvedValue({ rows: [] }) + }) + + it('returns a no-results message', async () => { + const result = await tool.handler({}) + + expect(getTextContent(result).text).toBe( + 'No survey programs found.', + ) + }) + }) + }) +}) \ No newline at end of file diff --git a/mcp-server/tests/tools/search-data-tables/search-data-tables.tool.integration.test.ts b/mcp-server/tests/tools/search-data-tables/search-data-tables.tool.integration.test.ts index cabcd7c..edc4fbe 100644 --- a/mcp-server/tests/tools/search-data-tables/search-data-tables.tool.integration.test.ts +++ b/mcp-server/tests/tools/search-data-tables/search-data-tables.tool.integration.test.ts @@ -11,18 +11,9 @@ import { Client } from 'pg' import { DatabaseService } from '../../../src/services/database.service' import { databaseConfig } from '../../helpers/database-config' +import { getResponseText } from '../../helpers/get-response-text.js' import { SearchDataTablesTool } from '../../../src/tools/search-data-tables.tool' -function getResponseText( - response: Awaited>, -): string { - const item = response.content[0] - if (item.type !== 'text') { - throw new Error(`Expected text content, got "${item.type}"`) - } - return (item as { type: 'text'; text: string }).text -} - describe('SearchDataTablesTool - Integration Tests', () => { let testClient: Client let databaseService: DatabaseService