(GET) Latest Data

Retrieve the latest data from a Spotter.

GET https://api.sofarocean.com/api/latest-data?spotterId=:spotterId

Returns the most recently transmitted device, waves and sensor data from a Spotter, specified by spotterId.

Query Parameters

Name	Type	Description
spotterId	string	The identifier of the device you wish to retrieve information from.
includeWindData	boolean	Default: false Set true to return wind data.
includeSurfaceTempData	boolean	Default: false Set true to return surface temperature data from Spotters equipped with SST sensors.
includeDirectionalMoments	boolean	Default: false Set true to return directional moments data from Spotters in Waves: Spectrum (Full) mode.
includePartitionData	boolean	Default: false Set true to return partition data from Spotters in Waves: Partition mode or HDR mode.
includeBarometerData	boolean	Default: false Set true to return barometer data from Spotters equipped with barometers.

Response Description

The response body includes general device information, the device status and data transmission details, and a data stream of the most recently transmitted samples, grouped by data type and ordered by timestamp.

For more information on the data collected by Spotters, refer to the product documentation.

Name	Type	Description
spotterId	string	The Spotter's identifier.
spotterName	string	The Spotter's display name, as configured in the Spotter Dashboard. Returns "" if no display name has been set.
payloadType	string	The type of payload. Can be waves (standard or partitioned), sensorData (Smart Mooring), full (full wave spectrum) or track (Track mode).
batteryVoltage	number	The Spotter's battery voltage level in volts. Full battery: 3.8 - 4.1 Mid-level capacity: 3.6-3.7 Low: 3.5 Critically low: 3.3 Empty battery: 3.0
batteryPower	number	The Spotter's battery power level in watts. A negative value indicates the battery is supplying power to the system. A positive value indicates the solar system is recharging the battery.
solarVoltage	number	The Spotter's measured solar-panel voltage in volts.
humidity	number	The Spotter's internal relative humidity as a percentage (%). Sharp increases in absolute humidity (accounting for temperature) may indicate a leak. If relative humidity is greater than 70%, we recommend replacing the desiccant.
waves	array	Waves data.
wind	array	Wind data if includeWindData is set to true.
surfaceTemp	array	Surface temperature data from Spotters equipped with SST sensors if includeSurfaceTempData is set to true.
frequencyData	array	Frequency data from Spotters in Waves: Spectrum (Full) mode.
partitionData	array	Partition data from Spotters in Waves: Partition mode or HDR mode if includePartitionData is set to true.
barometerData	array	Barometer data from Spotters equipped with barometers if includeBarometerData is set to true.
track	array	The Spotter's position at given timestamps.
commSource	string	The telemetry source used to transmit the data. Can be cellular or satellite.

Data Samples

The returned data types depend on your set query parameters as well as your Spotter's configured data mode at the time of collection.

Regardless, all data sample arrays include the location (latitude, longitude) when the report was encoded and transmitted as well as an ISO 8601-formatted timestamp, indicating the end of the sample collection period. Differences in transmission times are likely due to differences in sampling cadences.

Your Spotter's configured data mode and update rate will also impact the amount of samples included in a single data transmission. A Spotter with default settings (Waves: Standard and hourly update rate), for example, will include two 30-minute samples in an hourly update. To review or change your Spotter's data mode and update rate, open the Spotter Dashboard, find its Spotter card in the Map View, click the Gear icon to open the Settings tab, and scroll down to the Satellite data and Cellular data sections.

waves

Name	Type	Description
significantWaveHeight	number	Bulk significant wave height in meters (m).
peakPeriod	number	Peak wave period in seconds (s).
meanPeriod	number	Mean wave period in seconds (s).
peakDirection	number	Peak wave direction in degrees (°).
peakDirectionalSpread	number	Peak wave directional spreading in degrees (°).
meanDirection	number	Mean wave direction in degrees (°).
meanDirectionalSpread	number	Mean wave directional spreading in degrees (°).

wind

Name	Type	Description
speed	number	Wind speed in meters per second (m/s).
direction	number	Wind direction in degrees (°).
seasurfaceId	integer	Classification of the sea surface, with 1 meaning glassy, 2 meaning choppy, and 3 meaning rough.
algorithm_version	integer	The wind algorithm version, with 1 indicating version 1 and 2 indicating version 2.

surfaceTemp

Name	Type	Description
degrees	number	The surface temperature in degrees (°).

frequencyData

Name	Type	Description
frequency	array	Center frequency in hertz (Hz).
df	array	Spectral width in hertz (Hz).
a1	array	First component of first directional movement. Returned if includeDirectionalMomentsis set to true.
b1	array	Second component of first directional movement. Returned if includeDirectionalMomentsis set to true.
a2	array	First component of second directional movement. Returned if includeDirectionalMomentsis set to true.
b2	array	Second component of second directional movement. Returned if includeDirectionalMomentsis set to true.
varianceDensity	array	Surface variance density in meters squared per hertz (m2/Hz).
direction	array	Wave direction.
directionalSpread	array	Wave directional spread.

partitionData

Name	Type	Description
startFrequency	number	Starting frequency of the partition in hertz (Hz).
endFrequency	number	Ending frequency of the partition in hertz (Hz).
significantWaveHeight	number	Significant wave height of the partition in meters (m).
meanPeriod	number	Mean wave period of the partition in meters (m).
meanDirection	number	Mean wave direction of the partition in degrees (°).
meanDirectionalSpread	number	Mean wave directional spread of the partition in degrees (°).

barometerData

Name	Type	Description
value	number	The measured value.
units	string	The units of measurement. e.g., hPa
unit_type	string	A contextual description of what is being measured. e.g., barometric_pressure
data_type_name	string	The type of information being sent by a sensor, as ingested by the API. e.g., sofar_meanbaropressure_13bits

track

The track array only contains the location (latitude, longitude) when the report was encoded and transmitted as well as an ISO 8601-formatted timestamp, indicating the end of the sample collection period.

Examples

Example Request

curl "https://api.sofarocean.com/api/latest-data?spotterId=SPOT-0018" -H 'token: YOUR_API_TOKEN'

Example Response

200

frequencyData is only transmitted in Waves: Spectrum mode or HDR mode, and partitionData is only transmitted in Waves: Partition mode or HDR mode.

{
    "data": {
        "spotterId": "SPOT-010423",
        "spotterName": "",
        "payloadType": "full",
        "batteryVoltage": 4.01,
        "batteryPower": -0.1,
        "solarVoltage": 0,
        "humidity": 75.2,
        "track": [
            {
                "latitude": -37.4935167,
                "longitude": 32.9982667,
                "timestamp": "2026-03-11T19:06:01.000Z"
            },
            {
                "latitude": -37.5133667,
                "longitude": 33.00605,
                "timestamp": "2026-03-11T19:26:01.000Z"
            },
            {
                "latitude": -37.5337333,
                "longitude": 33.0134333,
                "timestamp": "2026-03-11T19:46:01.000Z"
            }
        ],
        "waves": [
            {
                "significantWaveHeight": 2.347,
                "peakPeriod": 10.24,
                "meanPeriod": 8.996,
                "peakDirection": 208.988,
                "peakDirectionalSpread": 41.774,
                "meanDirection": 187.491,
                "meanDirectionalSpread": 47.082,
                "timestamp": "2026-03-11T19:46:01.000Z",
                "latitude": -37.53373,
                "longitude": 33.01343
            }
        ],
        "wind": [
            {
                "speed": 4.4,
                "direction": 137,
                "location": {
                    "latitude": -37.5337333,
                    "longitude": 33.0134333,
                    "timestamp": "2026-03-11T19:46:01.000Z"
                },
                "seasurfaceId": 1,
                "algorithm_version": 1
            }
        ],
        "surfaceTemp": [
            {
                "degrees": 22.04,
                "location": {
                    "latitude": -37.4935167,
                    "longitude": 32.9982667,
                    "timestamp": "2026-03-11T19:06:01.000Z"
                }
            },
            {
                "degrees": 22.02,
                "location": {
                    "latitude": -37.5133667,
                    "longitude": 33.00605,
                    "timestamp": "2026-03-11T19:26:01.000Z"
                }
            },
            {
                "degrees": 22.02,
                "location": {
                    "latitude": -37.5337333,
                    "longitude": 33.0134333,
                    "timestamp": "2026-03-11T19:46:01.000Z"
                }
            }
        ],
        "partitionData": [
            {
                "partitions": [
                    {
                        "startFrequency": 0.025,
                        "endFrequency": 0.078125,
                        "significantWaveHeight": 0.69,
                        "meanPeriod": 15.38,
                        "meanDirection": 240.014,
                        "meanDirectionalSpread": 29.828
                    },
                    {
                        "startFrequency": 0.078125,
                        "endFrequency": 0.8,
                        "significantWaveHeight": 0.97,
                        "meanPeriod": 8.58,
                        "meanDirection": 251.647,
                        "meanDirectionalSpread": 29.645
                    }
                ],
                "location": {
                    "latitude": -37.5337333,
                    "longitude": 33.0134333,
                    "timestamp": "2026-03-11T19:46:01.000Z"
                }
            }
        ],
        "frequencyData": [
            {
                "frequency": [0.0293,0.03906,0.04883,...],
                "df": [0.00977,0.00977,0.00977,...],
                "a1": [-0.018573,-0.043988,-0.292278,...],
                "b1": [0.100684,0.147605,0.587488,...],
                "a2": [-0.143695,-0.148583,-0.27566,...],
                "b2": [-0.186706,-0.174976,-0.319648,...],
                "varianceDensity": [0.003497984,0.01050112,0.29932134400000004,...],
                "direction": [169.54824416491098,163.4053337896601,153.54944229298735,...],
                "directionalSpread": [76.76853080901289,74.52769022723301,47.512177743358464,...],
                "timestamp": "2026-03-11T19:46:01.000Z",
                "latitude": -37.53373,
                "longitude": 33.01343
            }
        ],
        "barometerData": [
            {
                "units": "hPa",
                "value": 1029.5,
                "unit_type": "barometric_pressure",
                "data_type_name": "sofar_meanbaropressure_13bits",
                "latitude": -37.4935167,
                "longitude": 32.9982667,
                "timestamp": "2026-03-11T19:06:01.000Z"
            },
            {
                "units": "hPa",
                "value": 1029.5,
                "unit_type": "barometric_pressure",
                "data_type_name": "sofar_meanbaropressure_13bits",
                "latitude": -37.5133667,
                "longitude": 33.00605,
                "timestamp": "2026-03-11T19:26:01.000Z"
            },
            {
                "units": "hPa",
                "value": 1029.4,
                "unit_type": "barometric_pressure",
                "data_type_name": "sofar_meanbaropressure_13bits",
                "latitude": -37.5337333,
                "longitude": 33.0134333,
                "timestamp": "2026-03-11T19:46:01.000Z"
            }
        ],
        "commSource": "satellite"
    }
}

400

401