Discover which atmospheric soundings have been collected by WindBorne's global balloon constellation. This endpoint allows you to search for soundings by time, location, altitude, and mission, making it easy to discover which soundings are available before fetching the full sounding data.
Soundings represent vertical profiles of the atmosphere collected as balloons ascend or descend through different pressure levels. Each sounding contains measurements at multiple altitudes including temperature, humidity, pressure, and wind data.
| Name | Type | Description |
|---|---|---|
| mission_id Optional | string (UUID) | ID of a WindBorne balloon mission, as listed by Flying Missions. Returns only that mission's soundings. |
| min_time Optional | string (ISO 8601) | Filter to soundings that started at or after this timestamp. |
| max_time Optional | string (ISO 8601) | Filter to soundings that ended at or before this timestamp. |
| min_altitude Optional | number | Exclude soundings with data only below this altitude. Use to find soundings with data coverage reaching up to at least this altitude. Unit: meters |
| max_altitude Optional | number | Exclude soundings with data only above this altitude. Use to find soundings with data coverage reaching down to at least this altitude. Unit: meters |
| min_length Optional | number | Used to find soundings with a difference in altitude above this length. Unit: meters |
| min_latitude Optional | number | Southern edge of the bounding box. Compares each sounding's center. Range: −90° to 90° |
| max_latitude Optional | number | Northern edge of the bounding box. Compares each sounding's center. Range: −90° to 90° |
| min_longitude Optional | number | Western edge of the bounding box. Compares each sounding's center. Range: −180° to 180° |
| max_longitude Optional | number | Eastern edge of the bounding box. Compares each sounding's center. Range: −180° to 180° |
| page Optional | integer | Zero-indexed page number. Default: 0 |
| page_size Optional | integer | Number of results per page. Max: 200; Default: 64 |
| Name | Type | Description |
|---|---|---|
| -m , --mission-id Optional | string (UUID) | ID of a WindBorne balloon mission, as listed by Flying Missions. Returns only that mission's soundings. |
| -mt , --min-time Optional | string (ISO 8601) | Filter to soundings that started at or after this timestamp. |
| -xt , --max-time Optional | string (ISO 8601) | Filter to soundings that ended at or before this timestamp. |
| -ma , --min-altitude Optional | number | Exclude soundings with data only below this altitude. Use to find soundings with data coverage reaching up to at least this altitude. Unit: meters |
| -xa , --max-altitude Optional | number | Exclude soundings with data only above this altitude. Use to find soundings with data coverage reaching down to at least this altitude. Unit: meters |
| --min-length Optional | number | Used to find soundings with a difference in altitude above this length. Unit: meters |
| -ml , --min-lat Optional | number | Southern edge of the bounding box. Compares each sounding's center. Range: −90° to 90° |
| -xl , --max-lat Optional | number | Northern edge of the bounding box. Compares each sounding's center. Range: −90° to 90° |
| -mg , --min-lon Optional | number | Western edge of the bounding box. Compares each sounding's center. Range: −180° to 180° |
| -xg , --max-lon Optional | number | Eastern edge of the bounding box. Compares each sounding's center. Range: −180° to 180° |
| -p , --page Optional | integer | Zero-indexed page number. Default: 0 |
| -ps , --page-size Optional | integer | Number of results per page. Max: 200; Default: 64 |
| output_file Optional | string | Path to save the response data. File extension determines format: .csv or .json. |
| Name | Type | Description |
|---|---|---|
| mission_id Optional | str (UUID) | ID of a WindBorne balloon mission, as listed by Flying Missions. Returns only that mission's soundings. |
| min_time Optional | str (ISO 8601) | Filter to soundings that started at or after this timestamp. |
| max_time Optional | str (ISO 8601) | Filter to soundings that ended at or before this timestamp. |
| min_altitude Optional | float | Exclude soundings with data only below this altitude. Use to find soundings with data coverage reaching up to at least this altitude. Unit: meters |
| max_altitude Optional | float | Exclude soundings with data only above this altitude. Use to find soundings with data coverage reaching down to at least this altitude. Unit: meters |
| min_length Optional | float | Used to find soundings with a difference in altitude above this length. Unit: meters |
| min_latitude Optional | float | Southern edge of the bounding box. Compares each sounding's center. Range: −90° to 90° |
| max_latitude Optional | float | Northern edge of the bounding box. Compares each sounding's center. Range: −90° to 90° |
| min_longitude Optional | float | Western edge of the bounding box. Compares each sounding's center. Range: −180° to 180° |
| max_longitude Optional | float | Eastern edge of the bounding box. Compares each sounding's center. Range: −180° to 180° |
| page Optional | int | Zero-indexed page number. Default: 0 |
| page_size Optional | int | Number of results per page. Max: 200; Default: 64 |
| output_file Optional | str | Path to save the response data. File extension determines format: .csv or .json. |
| print_response Optional | bool | If true, prints the response data. Default: false |
Returns an array of sounding metadata objects with pagination information.
| Name | Type | Description |
|---|---|---|
| soundings | object[] | Sounding metadata. |
| id | string (UUID) | Uniquely identifies the sounding. |
| mission_id | string (UUID) | The mission that collected this sounding. |
| start_time | string (ISO 8601) | When the sounding started. Omitted when unavailable. |
| end_time | string (ISO 8601) | When the sounding ended. Omitted when unavailable. |
| min_altitude_m | number | null | The minimum altitude reached during the sounding. Unit: meters |
| max_altitude_m | number | null | The maximum altitude reached during the sounding. Unit: meters |
| start_lat , start_lon | number | null | The latitude and longitude where the sounding started. Unit: degrees |
| end_lat , end_lon | number | null | The latitude and longitude where the sounding ended. Unit: degrees |
| page | integer | Current page number. |
| page_size | integer | Number of results per page. |
| has_next_page | boolean | Indicates whether or not there is a subsequent page of data. With area filters, keep paging until it's false; a short page doesn't mean the last page. |