SWX Advisory (ICAO)#

Required roles: AIS PIB API — Roles
Base endpoint: https://ais-pib-api.ibosoft.net.tr:2087/opmet-decoder-swx-icao
Reference documents: ICAO Doc 10157 PANS-MET, Ed. 1 (27/11/25) · ICAO Doc 8400 PANS-ABC, Ed. 9, Amend. 33 (8/11/18)
Attribution: show ibonav.aero or "Decoded by Ibosoft" wherever decoded output is displayed
Data sources: none — decodes the message supplied in the request.
Last updated: 17 OCT 2026

About the reference documents: Related Documents and Resources

Decodes a space weather advisory into readable fields, following the PANS-MET template. Optionally returns machine-readable values (parsed).

The format is that of PANS-MET Table A7-4. To get advisories to decode, see SWX Advisory.

Endpoints#

POST /opmet-decoder-swx-icao/decode?parsed=false
Content-Type: application/json

{ "raw": "<SWX advisory text>" }

Parameters#

How the template is processed#

• The advisory is line based: each element starts with its heading and a colon (DTG:, SWXC:, SWX EFFECT:, OBS SWX: …); the value runs to the next heading.
• Field names and wording come from PANS-MET Table A7-4: output keys are the template element names; effects, intensities and the latitude bands / longitude ranges of the affected areas are written out (e.g. MNH → "Middle latitudes northern hemisphere"). Abbreviations are expanded as defined in PANS-MET and PANS-ABC (Doc 8400).
• M (mandatory) elements are always present (null when missing); C (conditional) elements — status TEST/EXER, replaced advisory numbers (NR RPLC) — only when present.
• Values that do not follow the template are listed under Undecodable elements (neighbouring groups form one entry).

For the full list of elements, see PANS-MET Table A7-4.

Response#

Example — PANS-MET Example A7-4:

SWX ADVISORY
DTG: 20201108/0100Z
SWXC: DONLON
SWX EFFECT: HF COM
ADVISORY NR: 2020/1
OBS SWX: 08/0100Z SEV MNH EQN EQS MSH DAYSIDE MOD NIGHTSIDE
FCST SWX +6 HR: 08/0700Z NO SWX EXP
…
NXT ADVISORY: WILL BE ISSUED BY 20201108/0700Z

{
  "Identification of the type of message": "Space weather advisory",
  "Time of origin": "2020-11-08 01:00 UTC",
  "Name of SWXC": "DONLON",
  "Space weather effect": "HF COM (High frequency communication)",
  "Advisory number": "2020/1",
  "Observed or expected space weather event": "Day 08 01:00 UTC Severe Middle latitudes northern hemisphere Equatorial latitudes northern hemisphere Equatorial latitudes southern hemisphere Middle latitudes southern hemisphere Dayside Moderate Nightside",
  "Forecast +6 HR": "Day 08 07:00 UTC No space weather expected",
  "Next advisory": "Will be issued by 2020-11-08 07:00 UTC",
  "…": "…",
  "positions": [{"start": 0, "end": 12}, "…"],
  "corrected_raw": "SWX ADVISORY\nDTG: …",
  "raw": "…",
  "parsed": {"utc_day": 8, "utc_time": "0100", "swxc": "DONLON"}
}

Errors#