Reference · built on requestCommons signalAir, water & environment

EPA UV Index API

Hourly and daily UV Index forecasts and UV alerts for US ZIP codes and cities from EPA's Envirofacts data service.

About

The UV Index predicts the strength of ultraviolet radiation on a scale of 1 to 11+, calculated on a next-day basis for cities across the United States with clouds and local conditions taken into account. The US Environmental Protection Agency publishes it through Envirofacts, its data service on data.epa.gov, and links to the National Weather Service UV Index pages behind it.

Four RESTful endpoints return the hourly forecast by ZIP code or by city and state, and the daily forecast with a UV alert flag by the same keys, in XML by default or JSON, CSV, or EXCEL on request. No key is needed.

An operator reads tomorrow's peak hours for each site and proposes a shift notice, a pool-deck plan, or a line in the morning brief for your approval.

This is a reference listing. It documents what Fibric would read from EPA UV Index API and what it could propose, based on the publisher's published interfaces. Fibric builds it under a managed deployment when you request it; selecting it here installs nothing.

Inputs

  • Hourly UV_VALUE by ZIP through getEnvirofactsUVHOURLY/ZIP/{ZIP Code}/{Output Format}, with DATE_TIME in the ZIP's local time
  • Hourly UV_VALUE by city through getEnvirofactsUVHOURLY/CITY/{City Name}/STATE/{State Abbreviation}/{Output Format}
  • Daily UV Index forecast and UV_ALERT flag by ZIP through getEnvirofactsUVDAILY/ZIP/{ZIP Code}/{Output Format}
  • Daily UV Index forecast and UV_ALERT flag by city through getEnvirofactsUVDAILY/CITY/{City Name}/STATE/{State Abbreviation}/{Output Format}
  • An ORDER column that sequences the hourly rows chronologically

Proposed actions

Read-only. This feed informs operators; it changes nothing.

Proposed actions are target capabilities. Every action runs propose-first and needs a validated deployment and the appropriate permissions.

What you can build

  • Move outdoor work out of the peak UV hours

    Schedule Notice reads tomorrow's hourly UV_VALUE for each site's ZIP and drafts a notice to outdoor crews naming the hours above the level your policy sets. Severe Weather Notice adds the UV_ALERT flag when EPA issues one. A supervisor approves before anything is sent.

    With Schedule Notice, Severe Weather Notice

  • Prepare the pool deck and arrival areas

    Arrival Prep reads the daily UV Index for the property's ZIP and proposes shade, water, and sunscreen placements for arrival areas on high-index days. The front-office lead approves the checklist.

    With Arrival Prep

  • One UV line per site in the morning brief

    Morning Brief lists the daily UV Index and any alert for each location so site leads see high-exposure days at the start of the shift.

    With Morning Brief

Requirements

  • A valid USPS ZIP Code, or a city name with its state abbreviation, for each site
  • An Output Format of XML, JSON, EXCEL, or CSV in the URL; the default is XML
  • A daily fetch, since the index is calculated on a next-day basis
Authentication
No key and no registration; the endpoints on data.epa.gov answer plain HTTPS GET requests.

Limits

  • Forecasts are keyed by ZIP code or city, not by coordinate
  • The index is a next-day forecast; there is no measured or real-time UV series in this service
  • Envirofacts limits any request to 15 minutes; large table pulls must page with first:last ranges
  • The pages do not state a publication time of day for the daily update

Access and pricing

Reference listing. Public feed access is separate from Fibric integration. If you request this feed, your quote covers the build, usage, and support.

Request EPA UV Index API ↗

Questions and answers

Which endpoints does the UV Index API expose?
Four: getEnvirofactsUVHOURLY by ZIP or by CITY and STATE, and getEnvirofactsUVDAILY by ZIP or by CITY and STATE. Each takes an Output Format of XML, JSON, EXCEL, or CSV; XML is the default.
How often is the forecast updated?
The UV Index is calculated on a next-day basis for cities across the United States, so expect one daily forecast per location. EPA's pages do not state a specific publication hour.
Is there a rate limit or key?
No key is required. Envirofacts limits requests to those that complete in under 15 minutes; if more data is needed, you page through it. The UV endpoints return one location per call.
Ask about EPA UV Index API

Ask about the capabilities and requirements in this listing.

For project-specific requirements, contact Fibric.