Get Pilot Reports (PIREPs)
aviation_get_pirepsGet recent Pilot Reports (PIREPs) near an airport or within a bounding box. Returns decoded turbulence, icing, and cloud reports with altitude, aircraft type, intensity, outside air temperature, wind aloft, flight weather, braking action, and the raw PIREP string. Requires either station_id (ICAO center point for radial search, e.g., KSEA) or bbox (area search) — not both. distance_nm belongs to the station_id search only, and altitude_min_ft must not exceed altitude_max_ft. min_intensity restricts the result to reports carrying a turbulence or icing layer at that intensity or above. limit bounds how many reports come back without changing what is searched, keeping the most recent. Coverage is US-centric; PIREPs are sparse and absence of reports does not imply smooth conditions.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "aviation_get_pireps"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bbox | No | Geographic bounding box for area PIREP search. | |
| as_of | No | Historical UTC reference as YYYY-MM-DDTHH:mm:ssZ or YYYY-MM-DDTHH:mm:ss.sssZ. AWC retains up to the previous 30 days. Omit to use the current time. | |
| hours | No | Lookback window of 1–48 hours ending at as_of, or the current time when omitted. Default 3. | |
| limit | No | Maximum reports to return from offset after selection. The served maximum is 400 when limit is supplied. Omit to return all remaining matches. | |
| offset | No | Zero-based start among matching reports ordered by observation time descending, then raw bulletin and coordinates. | |
| station_id | No | ICAO station ID as center point for radial search — 4 ASCII letters or digits, case-insensitive and normalized to uppercase (e.g., KSEA, K0S9). Use with distance_nm. | |
| distance_nm | No | Search radius in nautical miles around station_id, defaulting to 100 when omitted. Belongs to the station_id search only — supplying it alongside bbox is rejected. When station coordinates are unavailable, the legacy AWC search remains available with an explicit unverified-radius notice. | |
| min_intensity | No | Return only reports carrying at least one turbulence or icing layer at this intensity or above. The filter selects reports, not layers — a matching report still carries its lighter layers, so a result may include NEG, TRC, or LGT entries alongside the layer that matched. Optional. | |
| altitude_max_ft | No | Filter by maximum altitude in feet MSL (e.g., 35000 for FL350), from 0 to 60000 ft — AWC searches no band below sea level, and none centred above FL600, which is already above the altitude any pilot report carries. Reports with an unknown altitude (altitude_ft null) cannot be shown to satisfy a bound and are dropped whenever either bound is set. Optional. | |
| altitude_min_ft | No | Filter by minimum altitude in feet MSL (e.g., 18000 for FL180), from 0 to 60000 ft — AWC searches no band below sea level, and none centred above FL600, which is already above the altitude any pilot report carries. Reports with an unknown altitude (altitude_ft null) cannot be shown to satisfy a bound and are dropped whenever either bound is set. Optional. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | The upstream row maximum that was applied to the page. Present only on a truncated result. | |
| error | No | Present when the call failed. Absent on success. | |
| shown | No | Reports in this result, counted after geographic selection, altitude filtering, and any limit. | |
| notice | No | Guidance for whichever disclosures fired: the levers that narrow the query before the cap applies, what a requested limit withheld, and — on a result of more than 50 reports from a call that set no limit — that limit bounds the response without changing what is searched, keeping the most recent. The cap and either limit statement can fire on one result, and the text keeps them apart. | |
| pireps | No | Pilot reports matching the search criteria, ordered by observation time descending. | |
| limited | No | True when the requested limit withheld reports that matched — the caller asked to see fewer of them. False affirms the limit did not bite, so every matching report is here. Present only when the call supplied a limit. It never states anything about the upstream cap: a limited result examined every report it counted, while a truncated one never drew the rest. | |
| matched | No | Reports that matched this query before paging. Present when offset was supplied or limit withheld matches. Upstream truncation can exclude reports from this count. | |
| truncated | No | True when the upstream page hit the AWC row cap, so reports inside the search area and time window are missing from this result. False affirms the whole window was searched, which a count alone cannot establish. | |
| nextOffset | No | Offset for the next page of the currently available draw. Present only while matches remain. | |
| upstreamRows | No | Candidate rows AWC returned before radius and altitude filtering or antimeridian deduplication. Present when those steps narrowed capped draws; each draw has its own 400-row cap. |