ZIP data dictionary
The complete ZIP business dictionary.
Version: dv-zip-business-dictionary-2026-11-05-v1
Output: dv-enterprise-zip-output-v3 · Model v0.2
These are the 16 CSV headers and JSON row fields. CSV numbers retain one decimal; JSON types are listed separately.
| Header / field | Meaning | Types and unavailable values |
|---|---|---|
zipPostal ZIP | Five digits; preserve leading zeros. Postal ZIPs can share one mapped-area estimate. | CSV: string JSON: string Always supplied. |
valid_dateValid date | The file’s current date, not the download date. | CSV: YYYY-MM-DD JSON: string Always supplied. |
current_dsiCurrent Dry Skin Index | Modeled current-day indoor drying stress, 0–10; higher means greater drying stress. | CSV: one-decimal number JSON: decimal string Blank string in CSV and JSON if unavailable. |
current_categoryCurrent category | Low <4; Moderate 4–<5; Elevated 5–<6; High ≥6. | CSV: label JSON: string Blank if unavailable. |
recent_exposurePrior seven-day category | Minimal: 0; Limited: >0–<7; Elevated: 7–<14; High: 14–42 index-days. | CSV: label JSON: string Blank if unavailable. |
exposure_outlookForecast seven-day category | The same exposure bands, applied to the forecast window. This is not seven separate daily rows. | CSV: label JSON: string Blank if unavailable. |
directionExposure change direction | Rising, Unchanged or Falling compares forecast total minus prior total using unrounded values. Falling does not imply low exposure. | CSV: label JSON: string Blank if unavailable. |
availabilityAvailability | Available or Unavailable. An unavailable ZIP has no supplied estimate; it is not a zero. | CSV: label JSON: string Always supplied. |
antecedent_excess_above4_7dPrior seven-day exposure total | Sum of max(DSI − 4, 0) for the seven dates before the valid date, excluding the valid date. Range 0–42 index-days. | CSV: one-decimal number JSON: number or null CSV blank; JSON null if unavailable. |
forecast_excess_above4_7dForecast seven-day exposure total | The same sum for the valid date and following six dates. Range 0–42 index-days. | CSV: one-decimal number JSON: number or null CSV blank; JSON null if unavailable. |
excess_above4_change_7dForecast minus prior exposure | Forecast total minus prior total; range −42 to +42 index-days. Positive means greater cumulative exposure ahead. | CSV: signed one-decimal number JSON: number or null CSV blank; JSON null if unavailable. |
summer_building_effect_low_confidenceWarm-condition evidence flag | True when evidence for building-related effects in warmer conditions is limited. This can apply outside calendar summer. | CSV: true / false JSON: boolean or null CSV blank; JSON null if unavailable. |
hot_humid_climate_low_confidenceHot-humid evidence flag | True when hot-humid conditions warrant additional interpretation caution. | CSV: true / false JSON: boolean or null CSV blank; JSON null if unavailable. |
building_mix_labelArea housing-mix label | house_dominant, large_apartment_heavy or mixed. Describes an area, not a particular building. | CSV: label JSON: string or null CSV blank; JSON null if unavailable. |
confidenceOverall evidence label | standard or low. Standard means no listed limitation applies; it is not a probability or accuracy certificate. | CSV: label JSON: string Unavailable estimates have low confidence and a stated reason. |
confidence_reasonsEvidence limitation reasons | summer_building_effect; hot_humid_climate; housing_stock_unavailable; weather_unavailable. | CSV: semicolon-separated text JSON: array of strings No listed reason: empty CSV cell or empty JSON array. Unavailability has a reason. |
Each record supplies one current DSI, two cumulative windows and their difference. Prior dates use historical weather analyses; current and future dates use forecast weather. These are modeled area estimates, not measured indoor conditions.
An index-day is one day’s index excess accumulated over time. It is not a count of people, households, days with dry skin or searches.
DSI and exposure values are presented to one decimal after validation. JSON numeric values may omit a trailing zero. Calculations, categories and direction use unrounded values; subtracting the displayed rounded totals can differ from the displayed change by 0.1.
Confidence fields describe the current-day modeled estimate. They do not certify accuracy or completeness of both cumulative windows, health outcomes or advertising performance.
Valid date, issue time, freshness and expiry remain tied to the issue. A stale but unexpired file keeps its original date; missing or expired data is refused. Partial windows do not receive a completed exposure estimate.
Current Preview API: 1–100 ZIPs per request, 120 requests per fixed 60-second window per organization, one active organization key. Production allowances and access require the agreed license and separate release.
The eight-field illustrative download remains synthetic and is a selected-field format example. It is not the complete licensed file.
Open this dictionary version · Source credits and review status