{"uid":"cap_vvzm6_JwGBMxw3ZuIBtwY","slug":"stationfx-new-residential-building-permits-total-units-6acb6ede","name":"StationFX: New Residential Building Permits (Total Units)","description":"Number of new residential building permits issued — a leading indicator of future housing construction activity. Leads housing starts by 1-3 months. Use for housing cycle analysis and construction sector modeling. Monthly frequency.","url":"https://stationfx.com/economic-data/housing/new-privately-owned-housing-units-authorized-in-permit-issuing-places-total-units?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http","description":"Always \"http\" for HTTP endpoints"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string","description":"HTTP method. Always GET for StationFX query endpoints"},"queryParams":{"type":"object","properties":{"fmt":{"enum":["json","toon"],"type":"string","description":"Response format. Use toon for compact agent-friendly output."},"fields":{"type":"string","description":"Comma-separated metric names"},"date_to":{"type":"string","description":"End date YYYY-MM-DD"},"date_from":{"type":"string","description":"Start date YYYY-MM-DD"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string","description":"Response format. Always \"json\" (or \"toon\" if fmt=toon was requested)"},"example":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","description":"Observation date YYYY-MM-DD"},"value":{"type":"number","description":"Raw observed value in series units"},"mom_pct":{"type":"number","description":"Month-over-month % change"},"yoy_pct":{"type":"number","description":"Year-over-year % change"},"zscore_5y":{"type":"number","description":"Z-score relative to trailing 5 years"},"mom_change":{"type":"number","description":"Month-over-month absolute change"},"yoy_change":{"type":"number","description":"Year-over-year absolute change"},"zscore_12m":{"type":"number","description":"Z-score relative to trailing 12 months"},"above_trend":{"type":"integer","description":"1 if value is above long-run trend, else 0"},"pct_rank_5y":{"type":"number","description":"Percentile rank over trailing 5 years (0-100)"},"rolling_3m_avg":{"type":"number","description":"3-month rolling average"},"rolling_12m_avg":{"type":"number","description":"12-month rolling average"},"trend_direction":{"type":"integer","description":"Trend: 1 rising, -1 falling, 0 flat"}}},"description":"Observations ordered by date ascending"},"meta":{"type":"object","description":"Series metadata: source_key (FRED series ID), units, frequency (D/W/M/Q/A), date_from, date_to, fields"}},"description":"Station f(x) response with metadata and pre-computed derived metrics"}}}}},"responseSchema":{"type":"json","schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","description":"Observation date YYYY-MM-DD"},"value":{"type":"number","description":"Raw observed value in series units"},"mom_pct":{"type":"number","description":"Month-over-month % change"},"yoy_pct":{"type":"number","description":"Year-over-year % change"},"zscore_5y":{"type":"number","description":"Z-score relative to trailing 5 years"},"mom_change":{"type":"number","description":"Month-over-month absolute change"},"yoy_change":{"type":"number","description":"Year-over-year absolute change"},"zscore_12m":{"type":"number","description":"Z-score relative to trailing 12 months"},"above_trend":{"type":"integer","description":"1 if value is above long-run trend, else 0"},"pct_rank_5y":{"type":"number","description":"Percentile rank over trailing 5 years (0-100)"},"rolling_3m_avg":{"type":"number","description":"3-month rolling average"},"rolling_12m_avg":{"type":"number","description":"12-month rolling average"},"trend_direction":{"type":"integer","description":"Trend: 1 rising, -1 falling, 0 flat"}}},"description":"Observations ordered by date ascending"},"meta":{"type":"object","description":"Series metadata: source_key (FRED series ID), units, frequency (D/W/M/Q/A), date_from, date_to, fields"}},"description":"Station f(x) response with metadata and pre-computed derived metrics"},"example":{"data":[{"date":"2024-01-01","value":5.33,"mom_pct":0,"yoy_change":0.5,"zscore_12m":1.2,"trend_direction":1}],"meta":{"frequency":"M","source_key":"PERMIT"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Du88GLsCXoBR9-4CsR-s-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns monthly U.S. residential building permit counts with trend statistics — a leading indicator of housing construction activity 1-3 months ahead of housing starts.","exampleAgentPrompt":"Pull the StationFX new residential building permits series from January 2022 through March 2025 in JSON format, and include the year-over-year change and 5-year z-score so I can see where permit activity stands relative to history.","exampleUseCases":[{"title":"Housing cycle inflection point detection","prompt":"Get the monthly new residential building permit data from January 2020 to today, including the month-over-month percent change and the above-trend flag — I want to see if we're at a turning point in the housing cycle."},{"title":"Construction sector earnings preview","prompt":"Pull the last 12 months of US residential building permit counts with the year-over-year percent change and the 5-year percentile rank — I'm modeling housing-exposed construction companies ahead of their earnings."},{"title":"Fed policy impact on homebuilding","prompt":"Fetch new privately-owned housing unit permit data from June 2022 through December 2023 with the 12-month rolling average and z-score vs trailing 5 years, so I can see how the Fed rate hiking cycle affected homebuilding activity."}],"resultDescription":"Returns a time-series array of monthly permit observations, each with: raw value (units authorized), month-over-month and year-over-year absolute and percentage changes, 12-month and 5-year z-scores, 5-year percentile rank, 3-month and 12-month rolling averages, and an above-trend binary flag. Supports JSON or compact 'toon' format.","failureModes":["Invalid date format returns an error — must be YYYY-MM-DD","date_from after date_to returns empty or error response","Requesting fields not available in the series returns null values or error","Unsupported fmt enum value returns a 400 error","Data may lag by 1-2 months reflecting BLS/Census publication schedule"],"whenToPreferThis":"Choose this endpoint when you need a monthly leading indicator of U.S. housing construction that precedes housing starts by 1-3 months. Preferred over housing starts data when forecasting near-term construction pipeline, modeling homebuilder revenues, or assessing the housing cycle's current phase. Best used alongside Fed funds rate or yield curve data from StationFX's sibling endpoints for rate-cycle context.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T06:47:08.836Z","isFirstParty":false,"canonicalSlug":"stationfx-new-residential-building-permits-total-units-6acb6ede"}