UV index + safe-exposure / burn-time guidance API

UV index forecast for a city or coordinates from Open-Meteo, returning the current and peak UV with the WHO category word (low/moderate/high/very high/extreme), a per-Fitzpatrick-skin-type burn-time estimate, and protection guidance. Answers 'what's the UV index here', 'how long until I burn in the sun', 'is the UV high today', 'do I need sunscreen right now'.

Price$0.01per request

MethodPOST

Route/v1/data/uv-index

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache3600s public

datauvuv-indexsunsunburnburn-timeopen-meteoskin

API URLhttps://x402.hexl.dev/v1/data/uv-index

Integration docs

Example request

{
  "city": "Sydney"
}

Example response

{
  "location": "Sydney, Australia",
  "latitude": -33.8688,
  "longitude": 151.2093,
  "currentUvIndex": 8,
  "currentCategory": "very high",
  "peakUvIndex": 9.4,
  "peakCategory": "very high",
  "peakTime": "2026-06-03T12:00",
  "burnTimeMinutesBySkinType": {
    "I": 8,
    "II": 13,
    "III": 25,
    "IV": 38,
    "V": 50,
    "VI": 63
  },
  "guidance": "Avoid sun 10am-4pm; SPF 30+, protective clothing, hat and sunglasses required."
}

Input schema

{
  "type": "object",
  "required": [],
  "properties": {
    "city": {
      "type": "string",
      "examples": [
        "Sydney"
      ]
    },
    "latitude": {
      "type": "number",
      "examples": [
        -33.8688
      ]
    },
    "longitude": {
      "type": "number",
      "examples": [
        151.2093
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}