PRprojecthorus

Request telemetry data for an individual radiosonde

Use this to request all available telemetry data for an individual radiosonde, specified by serial number.

get/sonde/{serial}

Request

  • Base URL
    https://api.v2.sondehub.org
  • URL
    https://api.v2.sondehub.org/sonde/{serial}
  • Auth
    none declared

Path parameters

serialstring required

Serial number of the radiosonde to request data for. e.g. S1130567

Response

Returns a time-sorted array of SondeHub Telemetry objects. If no data for the requested serial number is available, the array will be empty.

devstring

If this field is set then the payload will not be uploaded to the database. This is useful for development and testing.

software_namestring required

Name of the decoding software e.g. 'radiosonde_auto_rx', 'dxlAPRS', 'RS41Tracker', 'mySondy'

software_versionstring required

Version of the decoding software e.g. '1.4.0', '20210115'

uploader_callsignstring required

Callsign of the uploader Arbitrary string. Uploader position information and other metadata will be handled separately, but will need to match this callsign to enable calculation of listener statistics.

time_receivedstring date-time required

The time the telemetry packet was received. UTC time in YYYY-MM-DDTHH:MM:SS.SSSSSSZ format.

manufacturer'Vaisala' | 'Graw' | 'Meteomodem' | 'Intermet Systems' | 'Lockheed Martin' | 'Meteo-Radiy' | 'Meteosis' | 'Meisei' required

Radiosonde Manufacturer, as determined from the transmit modulation and high-level packet format.

type'RS41' | 'DFM' | 'M10' | 'M20' | 'iMet-4' | 'iMet-50' | 'iMet-54' | 'LMS6-400' | 'LMS6-1680' | 'MRZ' | 'MTS01' | 'iMS-100' | 'RS-11G' required

The high-level radiosonde model, as can be determined just from the transmit modulation and high-level packet format.

serialstring required

Radiosonde Serial Number. Where possible this should be in the format which matches the sticker/label on the radiosonde itself iMet-1/iMet-4 sondes do not provide a serial number, and so auto_rx generates a serial number based on launch time and transmit frequency. DFM sondes do not regularly transmit their serial number, and so data from these sondes should not be uploaded before the serial number is known.

framenumber required

Frame Number, ideally unique over the entire flight. Should be taken from the telemetry. For some radiosondes (DFM, M10, M20), the datetime (converted to a unix time) is used instead of the provided frame number.

datetimestring date-time required

Date/Time from the sonde's GPS, provided in YYYY-MM-DDTHH:MM:SS.SSSSSSZ format Some sondes (e.g. iMet, LMS6) do not provide the date portion of the timestamp. In this situation, the date portion should be added on by the receiver. An example of how to handle this problem is available here.

latnumber double required

Latitude (decimal degrees)

lonnumber double required

Longitude (decimal degrees)

altnumber double required

Altitude (metres)

subtype'RS41-SG' | 'RS41-SGP' | 'RS41-SGM' | 'DFM06' | 'DFM09' | 'DFM09P' | 'DFM17' | 'M10' | 'M20' | 'MRZ-H1'

Detailed Radiosonde Model Type, as determined through analysis of the telemetry.

frequencynumber float

Transmit frequency of the radiosonde in MHz.

tempnumber float

Measured Temperature (deg C)

humiditynumber float

Measured Relative Humidity (%)

vel_hnumber float

Horizontal Velocity (m/s)

vel_vnumber float

Horizontal Velocity (m/s)

pressurenumber float

Measured Pressure (hPa)

headingnumber float

Heading (degrees True)

battnumber float

Battery Voltage (volts)

satsnumber

Number of SVs used in position solution

xdatastring ascii hex

Auxiliary Data (e.g Ozone data) as a hexadecimal string.

snrnumber float

Signal-to-Noise ratio of the received signal, in dB

rssinumber float

Received-Signal-Strength-Indication of the radiosonde signal, nominally in dBm

uploader_positionnumber[]

Station position, as a list [lat, lon, alt].

uploader_antennastring

Station antenna/receiver information, free-text string.

Changes

No recorded changes to this operation across all 33 revisions of this API.