# Global Weather UV Forecast

> Global Weather UV Forecast is a paid API for AI agents from weather-global.x402tookit.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-21).

Returns peak UV index per day for up to 5 days at any coordinates, including WHO exposure category and sun protection guidance.

## Facts

- Endpoint: GET https://weather-global.x402tookit.com/uv-forecast?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/global-weather-uv-forecast-162193bf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YJ2YM8KJDuSAbizbuY26j

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability global-weather-uv-forecast-162193bf
```

Example prompt: What's the peak UV index forecast for the next 5 days at latitude 34.05 and longitude -118.24 — and tell me the WHO exposure category and protection advice for each day?

## When to prefer this

Choose this endpoint when you need structured, WHO-categorized UV index forecasts for arbitrary geographic coordinates, especially when you also want actionable sun protection guidance per day. Prefer it over generic weather APIs when UV exposure risk and health guidance are the primary concern rather than temperature or precipitation.

## Known failure modes

- Missing or out-of-range latitude/longitude returns an error or null values
- Requesting more than 5 days may be clamped or rejected
- Upstream weather data unavailability may trigger degraded mode with partial or null daily entries
- Invalid utcOffset values may fall back to UTC default
- Network or payment authorization failure returns no data

## How this service works

Peak UV index per day for up to 5 days at any coordinates with the WHO exposure category and protection guidance.

## Output

Returns a day-by-day array (up to 5 days) with peak UV index value, WHO exposure category (e.g. Low, Moderate, High, Very High, Extreme), recommended sun protection guidance, and the UTC time of peak UV per day. Also includes coordinates, timestamp, data source attribution, a summary, and optional degraded-mode flags.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "lat",
      "lon"
     ],
     "properties": {
      "lat": {
       "type": "number",
       "description": "Latitude"
      },
      "lon": {
       "type": "number",
       "description": "Longitude"
      },
      "days": {
       "type": "integer",
       "description": "Days 1 to 5 (default 3)"
      },
      "utcOffset": {
       "type": "integer",
       "description": "Local offset from UTC in hours (default 0)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "lat": {
       "type": [
        "null",
        "number"
       ]
      },
      "lon": {
       "type": [
        "null",
        "number"
       ]
      },
      "asOf": {
       "type": [
        "null",
        "string"
       ]
      },
      "days": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "object",
        "properties": {
         "date": {
          "type": [
           "null",
           "string"
          ]
         },
         "peakUv": {
          "type": [
           "null",
           "number"
          ]
         },
         "category": {
          "type": [
           "null",
           "string"
          ]
         },
         "guidance": {
          "type": [
           "null",
           "string"
          ]
         },
         "peakTimeUtc": {
          "type": [
           "null",
           "string"
          ]
         }
        }
       }
      },
      "source": {
       "type": [
        "null",
        "string"
       ]
      },
      "reasons": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "summary": {
       "type": [
        "null",
        "string"
       ]
      },
      "verdict": {
       "type": [
        "null",
        "string"
       ]
      },
      "degraded": {
       "t
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/global-weather-uv-forecast-162193bf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from weather-global.x402tookit.com](https://www.zero.xyz/host/weather-global.x402tookit.com/llms.txt)