LEHD / LODES API

What you can build

All-job workplace/residence summaries and aggregated commuting flows, with source coverage limitations. 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 LEHD / LODES

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/employment?limit=1&dataset=lodes&geo_type=block_group&geoid=010010201001&metrics=C000%2CCA01%2CCA02%2CCA03%2CCD01%2CCD02" \
  -H "Authorization: Bearer $GEOAMCAN_API_KEY"

Saved response excerpt

{
  "source_attribution": {},
  "requested_area": {
    "geographic_resolution": "block_group",
    "geoid": "010010201001"
  },
  "data": [
    {
      "dataset": "lodes",
      "source": "Census Bureau",
      "release": "LODES8 2023",
      "geographic_resolution": "block_group",
      "geoid": "010010201001",
      "geography_vintage": "2020",
      "period": "2023",
      "naics": "",
      "component": "rac",
      "metrics": {
        "C000": 233,
        "CA01": 64,
        "CA02": 101,
        "CA03": 68,
        "CD01": 18,
        "CD02": 53
      },
      "margins_of_error": {},
      "flags": {
        "job_type": "JT00: all jobs",
        "coverage_note": "Residence job totals include only jobs in published workplace states; see release coverage limitations.",
        "firm_age_size": "not available for JT00",
        "education_universe": "workers age 30 and older"
      }
    }
  ],
  "availability": {
    "lodes": "available"
  },
  "next_offset": 1,
  "returned_count": 1,
  "complete": false,
  "snapshot": {
    "lodes": {
      "release_id": 5,
      "release": "LODES8 2023",
      "fingerprint": "d3608a46542181b454833f3481dcd256"
    }
  },
  "metric_definitions": {
    "lodes": {
      "C000": {
        "label": "All jobs",
        "unit": "jobs",
        "universe": null,
        "source_definition": {}
      },
      "CA01": {
        "label": "Jobs held by workers age 14–29",
        "unit": "jobs",
        "universe": null,
        "source_definition": {}
      },
      "CA02": {
        "label": "Jobs held by workers age 30–54",
        "unit": "jobs",
        "universe": null,
        "source_definition": {}
      },
      "CA03": {
        "label": "Jobs held by workers age 55–99",
        "unit": "jobs",
        "universe": null,
        "source_definition": {}
      },
      "CD01": {
        "label": "Jobs held by workers age 30+ without a high school diploma",
        "unit": "jobs",
        "universe": null,
        "source_definition": {}
      },
      "CD02": {
        "label": "Jobs held by workers age 30+ with high school education and no college",
        "unit": "jobs",
        "universe": null,
        "source_definition": {}
      }
    }
  },
  "coverage_limitations": {
    "lodes": [
      "pr/wac (not published by LODES)"
    ]
  },
  "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.

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: Census Bureau. 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

• ACS Transportation and Commuting
• Bureau of Labor Statistics
• ACS Workforce and Customer Characteristics
• Local Area Unemployment Statistics