---
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", "paid", "x402", "category:economics"]
---

# 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: one of:
  - API key in header `PAYMENT-SIGNATURE`
  - API key in header `Authorization`

BLS QCEW employment change over Census BPS permitted units, the permits share of ACS housing stock, cited benchmarks, and published critiques, for an address, for agents. Returns the same records as locus_housing_supply_balance. Use this when your client can only call paid x402 routes. Use locus_housing_supply_balance instead when you can call Locus free tools (REST tools/call or MCP).

## 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`

Atomic read result. A substantive result is paid; an empty/out-of-coverage result carries charged:false (x402 settlement suppressed).

- object

## Other responses

- `400`: Invalid request body.
- `402`: Payment Required. For x402 v2, repeat the identical request with a valid PAYMENT-SIGNATURE header (legacy X-PAYMENT is accepted for compatibility), or use Authorization: Payment for MPP Tempo when advertised in x-payment-info.offers.

---

[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)