Understanding the outputs
A guide to your ZIP data.
Read the business outputs, explore coverage and discuss the delivery that fits your team.
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
Coverage and interpretation.
Coverage is reported for each issue. Some postal ZIPs share an area estimate. Missing estimates are marked as unavailable.
DSI describes modeled environmental conditions, not a measurement of a particular building or person. Its usefulness for sales, demand or campaign decisions should be evaluated alongside your own business information.
What should we check during an evaluation?
Check your priority locations, the dates and fields you need, how the file fits your workflow, and whether it offers useful context for your intended application.
Delivery and permitted use.
After accepting the free evaluation, use Download ZIP CSV in your portal. Import the ZIP column as text to keep leading zeros. Check the issue date and freshness before using the file.
National ZIP CSV and organization API for one named brand, either used by the brand’s own organization or by an agency for one named client.
Request a custom license for additional clients or brands, client access to the underlying data, public maps or reports showing DSI, data resale, or embedding ZIP data in another product. We can discuss coverage, delivery, term and support.
ZIP API quickstart
After your paid license is activated, open Set up ZIP API in the portal. Reveal your organization key once and store it securely. Load it into the ZIP_API_KEY environment variable in your terminal before running this production example.
Send the key as a bearer token in the Authorization header and keep ZIPs as five-digit strings. The API accepts up to 100 ZIPs per call and 120 calls per minute per organization.
printf 'Authorization: Bearer %s\n' "$ZIP_API_KEY" |
curl --fail-with-body --header @- 'https://dermalvectors.com/api/enterprise/forecast?zips=00501,10001'The response includes an issue date, freshness, and rows with the same business fields as the CSV. For example, a row includes zip, current_dsi, exposure_outlook, and availability.
A missing or invalid key returns 401. Ended or insufficient license access returns 403. If a request is rate-limited, wait before trying again.