---
title: "Get VanSky weather suitability for one country"
method: GET
path: "/api/vansky/weather/{code}"
tags: ["VanSky"]
---

# Get VanSky weather suitability for one country

`GET /api/vansky/weather/{code}`

Returns detailed VanSky weather suitability data for one ISO 3166-1 alpha-2 country code.

## Path parameters

- `code` string, required

## Response `200`

VanSky country details

- VanSkyCountryResponse
  - `data` VanSkyCountry
    - `code` string — ISO 3166-1 alpha-2 country code.
    - `is_coastal` boolean
    - `region` string
    - `weather` VanSkyWeather — Current-day weather snapshot used for van scoring.
      - `temp_day` number, nullable — Daytime air temperature in °C.
      - `temp_night` number, nullable — Nighttime air temperature in °C.
      - `feels_like_day` number, nullable
      - `feels_like_night` number, nullable
      - `temp_current` number, nullable
      - `feels_like_current` number, nullable
      - `precip_sum` number, nullable — Total precipitation in mm.
      - `precip_prob_max` number, nullable — Max precipitation probability in %.
      - `wind_max` number, nullable — Max sustained wind km/h.
      - `wind_gusts_max` number, nullable — Max wind gust km/h.
      - `wind_dir` number, nullable — Wind direction in degrees.
      - `shortwave_radiation_sum` number, nullable
      - `peak_sun_hours` number, nullable — Effective sunlight hours for solar panels.
      - `uv_max` number, nullable
      - `sunrise` string, date-time, nullable
      - `sunset` string, date-time, nullable
      - `weather_code` integer, nullable — WMO weather code.
      - `humidity` number, nullable
      - `cloud_cover` number, nullable
    - `marine` VanSkyMarine — Marine data for coastal countries; null for landlocked.
      - `sea_temp` number, nullable — Sea temperature in °C.
      - `wave_height` number, nullable — Wave height in meters.
      - `wave_dir` number, nullable — Wave direction in degrees.
      - `wave_period` number, nullable — Wave period in seconds.
    - `forecast` VanSkyForecastDay[] — Up to 7 days ahead.
      - `date` string, date
      - `van_score` integer — Overall vanlife suitability 0-100.
      - `sleep_score` integer — Overnight comfort 0-100.
      - `temp_day` number, nullable
      - `temp_night` number, nullable
      - `solar_kwh` number, nullable — Estimated solar energy kWh/day per 1kW panel.
      - `weather_code` integer, nullable
      - `score_label` 'ideal' | 'comfortable' | 'acceptable' | 'harsh' | 'extreme'
      - `drive_score` integer
    - `van_score` integer — Today's overall van suitability.
    - `sleep_score` integer
    - `solar_kwh` number, nullable — Today's solar yield estimate.
    - `solar_score` integer, nullable
    - `drive_score` integer, nullable
    - `sea_score` integer, nullable
    - `score_label` 'ideal' | 'comfortable' | 'acceptable' | 'harsh' | 'extreme'
    - `condensation_risk` 'low' | 'medium' | 'high' — Overnight condensation risk inside van.
    - `awning_status` 'safe' | 'caution' | 'retract' — Whether it is safe to deploy an awning.
    - `drive_window` object, nullable — Suggested safe driving window today.
      - `start` string, date-time
      - `end` string, date-time
    - `best_move_day` VanSkyForecastDay — Single forecast day snapshot.
      - `date` string, date
      - `van_score` integer — Overall vanlife suitability 0-100.
      - `sleep_score` integer — Overnight comfort 0-100.
      - `temp_day` number, nullable
      - `temp_night` number, nullable
      - `solar_kwh` number, nullable — Estimated solar energy kWh/day per 1kW panel.
      - `weather_code` integer, nullable
      - `score_label` 'ideal' | 'comfortable' | 'acceptable' | 'harsh' | 'extreme'
      - `drive_score` integer
    - `recommendations` VanSkyRecommendation[]
      - `type` 'info' | 'warning' | 'danger' | 'tip'
      - `key` string — Translation key, e.g. vansky.rec.awning_caution.
      - `params` object — Numeric params for the translated message.
    - `fetched_at` string, date-time, nullable
  - `updated_at` string, date-time, nullable
  - `source` string

## Other responses

- `404` — Resource not found

---

[API](https://skmtc.net/openvan/apis/openvan-camp-ai-public-api.md) · [All operations](https://skmtc.net/openvan/apis/openvan-camp-ai-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openvan/openvan-camp-ai-public-api/versions/3f278a32bbb0/schema)
