---
title: "County jobs against housing units permitted (BLS QCEW + Census BPS)"
method: POST
path: "/api/locus_housing_supply_balance"
tags: ["investors", "housing-supply", "permits", "employment", "read-only", "free", "free"]
---

# County jobs against housing units permitted (BLS QCEW + Census BPS)

`POST /api/locus_housing_supply_balance`

## Request

- Base URL: `https://api.locus.report`
- URL: `https://api.locus.report/api/locus_housing_supply_balance`
- Auth: none required

County BLS QCEW annual-average job change against prior-year Census BPS housing units authorized by permit, plus permits as a share of ACS housing stock for an address or point. Returns published benchmarks and critiques without Locus labels. Zero denominator returns null with reason; component status is separate. National.
Use this when you can call Locus free tools (REST tools/call or MCP).
Use locus-housing-supply-balance instead when your client can only call paid x402 routes; it returns the same records. Direct flat-body route for this one free resource; no API key, payment, or catalog wrapper. Return only the cited bounded evidence described here; this route never produces a paid brief or full report.

## Request body

- object
  - `address` string: Optional US street address or place; NC uses AddressNC first, other areas use the national geocoder fallback when latitude/longitude are not provided.
  - `latitude` number: Optional decimal latitude; provide with longitude to skip address geocoding.
  - `longitude` number: Optional decimal longitude; provide with latitude to skip address geocoding.
  - `permitYear` integer: Optional permit-year override, e.g. 2024; default is the newest published Census BPS annual county year.

## Response `200`

Free cited evidence response.

- object

## Other responses

- `400`: Invalid request body.
- `429`: Rate limited.

---

[API](https://skmtc.dev/locus/apis/locus-api.md) · [All operations](https://skmtc.dev/locus/apis/locus-api/llms.txt) · [OpenAPI document](https://skmtc.dev/locus/apis/locus-api/revisions/ba7786b74adb?raw)