---
title: "Get historical weather data for a point"
method: GET
path: "/historical/point"
---

# Get historical weather data for a point

`GET /historical/point`

Returns historical weather and marine data for a specific coordinate.

## Query parameters

- `lat` number, float, required
- `lng` number, float, required
- `start` string, date-time
- `end` string, date-time
- `source` string
- `params` HistoricalParameter[], required

## Response `200`

Historical data response

- object
  - `hours` HistoricalData[]
    - `time` string, date-time, required — Timestamp in UTC (ISO 8601), always rounded to full hours.
    - `airTemperature` object — Air temperature 2m above ground given in Celsius (°C). Key-value pairs where key is the data source (e.g. noaa, ecmwf, sg) and value is the measured parameter.
    - `bathymetry` object — Wave and currents model depth in meters. Key-value pairs where key is the data source (e.g. noaa, ecmwf, sg)
    - `pressure` object — Air pressure given in hectopascals (hPa). Key-value pairs where key is the data source (e.g. noaa, ecmwf, sg) and value is the measured parameter.
    - `cloudCover` object — Cloud cover given in percentage. Key-value pairs where key is the data source (e.g. noaa, ecmwf, sg) and value is the measured parameter.
    - `currentDirection` object — Current Direction in degrees. 0° indicates current coming from north. Key-value pairs where key is the data source (e.g. noaa, ecmwf, sg) and value is the measured parameter. example: cmems: 235.32 sg: 235.32
    - `currentSpeed` object — Speed of current in meters per second (m/s). Key-value pairs where key is the data source (e.g. noaa, ecmwf, sg) and value is the measured parameter. example: cmems: 0.22 sg: 0.22
    - `dewPointTemperature` object — Dew point temperature at 2m above ground in degrees Celsius (°C). Always ≤ air temperature. Key-value pairs where key is the data source (e.g. noaa, ecmwf, sg) and value is the measured parameter.
    - `gust` object — Wind gust in meters per second (m/s). Key-value pairs where key is the data source (e.g. noaa, ecmwf, sg) and value is the measured parameter.
    - `iceCover` object — Ice Cover given in a unitless factor between 0 and 1. Key-value pairs where key is the data source (e.g. noaa, ecmwf, sg) and value is the measured parameter.
    - `precipitation` object — Mean precipitation in kg/m²/h = mm/h. Key-value pairs where key is the data source (e.g. noaa, ecmwf, sg) and value is the measured parameter.
    - `rain` object — Mean rain-type precipitation in kg/m²/h = mm/h. Key-value pairs where key is the data source (e.g. noaa, ecmwf, sg) and value is the measured parameter.
    - `snow` object — Mean snow-type precipitation in kg/m²/h = mm/h. Key-value pairs where key is the data source (e.g. noaa, ecmwf, sg) and value is the measured parameter.
    - `snowAlbedo` object — Reflectivity of snow cover. Unitless factor between 0.0 and 1.0. Key-value pairs where key is the data source (e.g. noaa, ecmwf, sg) and value is the measured parameter.
    - `swellDirection` object — Direction of swell waves in degrees. 0° indicates swell coming from north. Key-value pairs where key is the data source (e.g. noaa, ecmwf, sg) and value is the measured parameter.
    - `swellHeight` object — Height of swell waves in meters (m). Key-value pairs where key is the data source (e.g. noaa, ecmwf, sg) and value is the measured parameter.
    - `swellPeriod` object — Period of swell waves in seconds (s). Key-value pairs where key is the data source (e.g. noaa, ecmwf, sg) and value is the measured parameter.
    - `waveDirection` object — Direction of combined wind and swell waves. 0° indicates waves coming from north. Key-value pairs where key is the data source (e.g. noaa, ecmwf, sg) and value is the measured parameter.
    - `waveHeight` object — Significant Height of combined wind and swell waves in meters (m). Key-value pairs where key is the data source (e.g. noaa, ecmwf, sg) and value is the measured parameter.
    - `wavePeriod` object — Period of combined wind abd swell waves in seconds (s). Key-value pairs where key is the data source (e.g. noaa, ecmwf, sg) and value is the measured parameter.
    - `windWaveDirection` object — Direction of wind waves. 0° indicates waves coming from north. Key-value pairs where key is the data source (e.g. noaa, ecmwf, sg) and value is the measured parameter.
    - `windWaveHeight` object — Height of wind waves in meters (m). Key-value pairs where key is the data source (e.g. noaa, ecmwf, sg) and value is the measured parameter.
    - `windWavePeriod` object — Period of wind waves in seconds (s). Key-value pairs where key is the data source (e.g. noaa, ecmwf, sg) and value is the measured parameter.
    - `windDirection` object — Direction of wind at 10m above ground. 0° indicates wind coming from north. Key-value pairs where key is the data source (e.g. noaa, ecmwf, sg) and value is the measured parameter.
    - `windDirection100m` object — Direction of wind at 80m above ground. 0° indicates wind coming from north. Key-value pairs where key is the data source (e.g. noaa, ecmwf, sg) and value is the measured parameter.
    - `windDirection1000hpa` object — Direction of wind at 1000hPa. 0° indicates wind coming from north. Key-value pairs where key is the data source (e.g. noaa, ecmwf, sg) and value is the measured parameter.
    - `windDirection800hpa` object — Direction of wind at 800hPa. 0° indicates wind coming from north. Key-value pairs where key is the data source (e.g. noaa, ecmwf, sg) and value is the measured parameter.
    - `windDirection500hpa` object — Direction of wind at 500hPa. 0° indicates wind coming from north. Key-value pairs where key is the data source (e.g. noaa, ecmwf, sg) and value is the measured parameter.
    - `windDirection200hpa` object — Direction of wind at 200hPa. 0° indicates wind coming from north. Key-value pairs where key is the data source (e.g. noaa, ecmwf, sg) and value is the measured parameter.
    - `windSpeed` object — Speed of wind at 10m above ground in meters per second (m/s). Key-value pairs where key is the data source (e.g. noaa, ecmwf, sg) and value is the measured parameter.
    - `windSpeed100m` object — Speed of wind at 100m above ground in meters per second (m/s). Key-value pairs where key is the data source (e.g. noaa, ecmwf, sg) and value is the measured parameter.
    - `windSpeed1000hpa` object — Speed of wind at 1000hpa in meters per second (m/s). Key-value pairs where key is the data source (e.g. noaa, ecmwf, sg) and value is the measured parameter.
    - `windSpeed800hpa` object — Speed of wind at 800hpa in meters per second (m/s). Key-value pairs where key is the data source (e.g. noaa, ecmwf, sg) and value is the measured parameter.
    - `windSpeed500hpa` object — Speed of wind at 500hpa in meters per second (m/s). Key-value pairs where key is the data source (e.g. noaa, ecmwf, sg) and value is the measured parameter.
    - `windSpeed200hpa` object — Speed of wind at 200hpa in meters per second (m/s). Key-value pairs where key is the data source (e.g. noaa, ecmwf, sg) and value is the measured parameter.
    - `soilMoisture` object — Volumetric soil moisture content at 0 to 10 cm below surface.
    - `soilMoisture10cm` object — Volumetric soil moisture content at 10 to 40 cm below surface.
    - `soilMoisture40cm` object — Volumetric soil moisture content at 40 to 100 cm below surface.
    - `soilMoisture100cm` object — Volumetric soil moisture content at 100 to 200 cm below surface.
    - `soilTemperature` object — Soil temperature at 0 to 10 cm below surface in Celcius (°C). Key-value pairs where key is the data source (e.g. noaa, ecmwf, sg) and value is the measured parameter.
    - `soilTemperature10cm` object — Soil temperature at 10 to 40 cm below surface in Celcius (°C). Key-value pairs where key is the data source (e.g. noaa, ecmwf, sg) and value is the measured parameter.
    - `soilTemperature40cm` object — Soil temperature at 40 to 100 cm below surface in Celcius (°C). Key-value pairs where key is the data source (e.g. noaa, ecmwf, sg) and value is the measured parameter.
    - `soilTemperature100cm` object — Soil temperature at 100 to 200 cm below surface in Celcius (°C). Key-value pairs where key is the data source (e.g. noaa, ecmwf, sg) and value is the measured parameter.
    - `solarDownwardRadiationFlux` object — Solar downward radiation flux at ground or sea level (W/m²) - (ECMWF source parameter name: "Surface net short-wave solar radiation"). Key-value pairs where key is the data source (e.g. noaa, ecmwf, sg) and value is the measured parameter.
    - `surfaceNetShortwaveRadiationDownwardsFlux` object — Surface net short-wave radiation downwards flux at ground or sea level (W/m²) - (ECMWF source parameter name: "Surface net short-wave solar radiation downwards"). Key-value pairs where key is the data source (e.g. noaa, ecmwf, sg)
  - `meta` Meta
    - `lat` number, float
    - `lng` number, float
    - `start` string, date-time
    - `end` string, date-time
    - `dailyQuota` number — The number of requests you are allowed to make each day
    - `requestCount` number — The number of successful requests you have made since 00:00 UTC

## Other responses

- `402` — Error: Payment required (quota exceeded)
- `403` — Forbidden
- `422` — Error: Unprocessable Entity

---

[API](https://skmtc.net/stormglass/apis/stormglass-io-api.md) · [All operations](https://skmtc.net/stormglass/apis/stormglass-io-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stormglass/stormglass-io-api/versions/c1d9b537b4c7/schema)
