Skip to content
Products
ZIP-level data/ Data guide

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 / 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

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.