Consumer Expenditure Survey API

What you can build

Published mean spending, characteristics and uncertainty; no neighborhood spending imputation. Use this dataset as a sourced input to an application, analytical model or retrieval tool. Retain its native dimensions when joining it with your own records.

Query Consumer Expenditure Survey

The example below is a real bounded request against the available release. Replace the environment variable with your server-side API credential. Review endpoint parameters and response schemas before changing selectors.

curl --fail --get "https://api.geoamcan.com/v1/economy?limit=1&dataset=consumer-spending&geo_type=consumer_group&geoid=CE003b25a61d4a49aea8e8&metrics=value" \
  -H "Authorization: Bearer $GEOAMCAN_API_KEY"

Saved response excerpt

{
  "source_attribution": {},
  "requested_area": {
    "geographic_resolution": "consumer_group",
    "geoid": "CE003b25a61d4a49aea8e8"
  },
  "data": [
    {
      "dataset": "consumer-spending",
      "source": "Bureau of Labor Statistics",
      "release": "CE published tables through 2024 revision be6ee26dbf9d",
      "geographic_resolution": "consumer_group",
      "geoid": "CE003b25a61d4a49aea8e8",
      "geography_vintage": "source survey geography",
      "period": "source published table period",
      "naics": "",
      "component": "reference-person-age-by-income-25-34-2023-2024.xlsx|Table 3214|100",
      "metrics": {
        "value": 448
      },
      "margins_of_error": {},
      "flags": {
        "unit": "Source-defined item unit; monetary expenditures in USD per consumer unit; characteristics/counts/percentages retain their source item labels",
        "scope": "Published survey group/table. No neighborhood spending estimate.",
        "sheet": "Table 3214",
        "source_row": 100,
        "source_url": "https://www.bls.gov/cex/tables/cross-tab/mean/reference-person-age-by-income-25-34-2023-2024.xlsx",
        "source_item": "Other household products",
        "source_title": "Table 3214. Consumer units with reference person age 25 to 34 by income before taxes: Average annual expenditures and characteristics, Consumer Expenditure Surveys, 2023-2024",
        "column_labels": "$100,000\nand\nmore",
        "source_column": 9
      }
    }
  ],
  "availability": {
    "consumer-spending": "available"
  },
  "next_offset": 1,
  "returned_count": 1,
  "complete": false,
  "snapshot": {
    "consumer-spending": {
      "release_id": 31,
      "release": "CE published tables through 2024 revision be6ee26dbf9d",
      "fingerprint": "850f5d336d869bb9d8254e1e07a2d8e3"
    }
  },
  "metric_definitions": {
    "consumer-spending": {
      "value": {
        "label": "Published Consumer Expenditure table value",
        "unit": "source table unit; varies by item",
        "universe": null,
        "source_definition": {}
      }
    }
  },
  "coverage_limitations": {
    "consumer-spending": [
      "Published survey groups and source units only. Local spending must not be presented as directly measured neighborhood demand."
    ]
  },
  "native_area_contexts": {},
  "commuting_flows": []
}

Captured 2026-10-26. Excerpt omits pagination credentials and may shorten nested records. Download verified source responses.

Coverage and interpretation

Coverage is limited to published source geographies and releases. Missing, suppressed and unavailable observations must not be treated as zero. These are published consumer groups, not neighborhood spending estimates.

The active release shown here is a catalog snapshot. Check the live catalog and response provenance for current readiness. The underlying public source and Geoamcan access terms are separate; consult the source’s licensing and attribution requirements.

Source and methodology

Source: Bureau of Labor Statistics. Geoamcan is an independent API provider, with no agency affiliation or endorsement. Read our data methodology for source handling, geographic joins and update practices.

Related data

• Bureau of Economic Analysis
• Census Building Permits
• City and Town Building Permits