Skip to content
Products

ZIP data guide · ZIP product

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 / fieldMeaningTypes and unavailable values
zip
Postal ZIP
Five digits; preserve leading zeros. Postal ZIPs can share one mapped-area estimate.CSV: string
JSON: string
Always supplied.
valid_date
Valid date
The file’s current date, not the download date.CSV: YYYY-MM-DD
JSON: string
Always supplied.
current_dsi
Current 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_category
Current category
Low <4; Moderate 4–<5; Elevated 5–<6; High ≥6.CSV: label
JSON: string
Blank if unavailable.
recent_exposure
Prior seven-day category
Minimal: 0; Limited: >0–<7; Elevated: 7–<14; High: 14–42 index-days.CSV: label
JSON: string
Blank if unavailable.
exposure_outlook
Forecast 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.
direction
Exposure 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.
availability
Availability
Available or Unavailable. An unavailable ZIP has no supplied estimate; it is not a zero.CSV: label
JSON: string
Always supplied.
antecedent_excess_above4_7d
Prior 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_7d
Forecast 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_7d
Forecast 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_confidence
Warm-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_confidence
Hot-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_label
Area 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.
confidence
Overall 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_reasons
Evidence 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