← Back to Home

API Reference

OFFICIAL DOCUMENTATION FOR THE BEAUFORT WEATHER SERVICE

Base URL

All requests should be directed to the primary dispatch server:

https://meteo.beaufortdispatch.app

Endpoints

GET /v1/forecast

Retrieves weather forecast data for a specific location. Supports hourly, daily, and current weather variables.

Parameters

Parameter Type Required Description
latitude float Yes Geographical WGS84 latitude of the location.
longitude float Yes Geographical WGS84 longitude of the location.
hourly string No Comma-separated list of hourly weather variables (e.g., temperature_2m,precipitation).
daily string No Comma-separated list of daily weather variables (e.g., sunrise,sunset).
current string No Comma-separated list of current weather variables.
timezone string No Timezone to use for time stamps (e.g., Europe/London or auto). Default is UTC.

Response Example

A successful response returns a JSON object containing the requested data arrays and unit definitions.

{
  "latitude": 51.52,
  "longitude": -0.11,
  "generationtime_ms": 0.2510547637939453,
  "utc_offset_seconds": 0,
  "timezone": "GMT",
  "timezone_abbreviation": "GMT",
  "elevation": 23.0,
  "current_units": {
    "time": "iso8601",
    "interval": "seconds",
    "temperature_2m": "°C",
    "wind_speed_10m": "km/h"
  },
  "current": {
    "time": "2026-02-21T12:00",
    "interval": 900,
    "temperature_2m": 8.5,
    "wind_speed_10m": 12.4
  },
  "hourly_units": {
    "time": "iso8601",
    "temperature_2m": "°C",
    "precipitation_probability": "%"
  },
  "hourly": {
    "time": [
      "2026-02-21T00:00",
      "2026-02-21T01:00",
      "2026-02-21T02:00"
    ],
    "temperature_2m": [
      6.2,
      6.1,
      5.9
    ],
    "precipitation_probability": [
      10,
      15,
      20
    ]
  }
}

Available Hourly Variables

The following variables are available for query via the hourly parameter:

  • temperature_2m
  • relative_humidity_2m
  • dew_point_2m
  • apparent_temperature
  • pressure_msl
  • precipitation
  • rain
  • showers
  • snowfall
  • weather_code
  • cloud_cover
  • wind_speed_10m
  • wind_direction_10m
  • wind_gusts_10m
  • shortwave_radiation
  • direct_radiation
  • diffuse_radiation
  • vapor_pressure_deficit
  • cape
  • evapotranspiration
  • et0_fao_evapotranspiration
  • precipitation_probability
  • snow_depth
  • fresh_snowfall
  • uv_index
  • is_day
  • pm10
  • pm2_5
  • carbon_monoxide
  • nitrogen_dioxide
  • sulphur_dioxide
  • ozone
  • alder_pollen
  • birch_pollen
  • grass_pollen
  • mugwort_pollen
  • olive_pollen
  • ragweed_pollen
  • wave_height
  • wave_period
  • wave_direction
  • cloud_cover_2m
  • soil_temperature_0cm
Models Weather Configuration

The Beaufort Weather Service aggregates data from the following high-resolution models:

Model Resolution Provider
UKV 2 km Met Office (UK)
ICON-D2 / ICON-EU 2 km / 7 km DWD (Germany)
AROME 1.3 km / 2.5 km Météo-France
MF Wave Wait & See Météo-France (Marine)
GEM HRDPS 2.5 km CMC (Canada)
CAMS Europe 10 km ECMWF (Air Quality)