Alerts

Published aviation notices — chart notices, VFR manual notices, navigation database change notices, airport moving map alerts and similar documents — with their regions, areas and attached PDFs. The list is filterable by region, category and area; each notice can be opened in detail and its attachment downloaded.

Required roles: AIS Jeppesen Charts API — Roles
Base endpoint: https://jepp-api.ibosoft.net.tr:2087/alerts
Attribution: show ibonav.aero wherever this data is displayed
Last updated: 17 OCT 2026

An alert is a published document, not a per-airport message: it covers a region (for example Eastern Europe) and a list of areas (countries). Use /alerts/filters to populate filter menus, /alerts for the list, /alertdetail for the full text and attachment list, and /alertpdf to fetch an attachment. For per-airport notices see Change Notices.

Endpoints

Endpoint Description
GET /alerts The notice list, filtered (most used)
GET /alerts/filters The available regions, categories and areas — for filter menus
GET /alertdetail/{alert_id} One notice with its full text and attachment list
GET /alertpdf/{alert_id} An attachment of a notice

Parameters

/alerts

All optional, all repeatable.

Name Matching
region The notice's region contains one of the given values (substring)
category The notice's category equals one of the given values (exact)
subRegion The notice's areas contains one of the given values (substring)

Values of the same parameter are OR-ed, different parameters are AND-ed: ?region=Africa&region=Europe&category=VFR%20Manual → (Africa or Europe) and category VFR Manual.

/alertpdf/{alert_id}

Name In Default Description
alert_id path — Notice ID
attachment query (int) 0 Attachment index, from attachments[].index in /alertdetail

Negative values count from the end (-1 is the last attachment).

Response

/alerts

{ "alerts": Alert[], "total": int }

Field Type Description
alertType string Category, e.g. "VFR Manual", "NavData Change Notice"
id string Notice ID — for /alertdetail and /alertpdf
description string Notice title
releasedDate int | null Release date, Unix epoch milliseconds
expiredDate null Not published; always null
attachmentCount int Number of attached files
region string Region(s), comma-separated
areas string Countries / areas, comma-separated
textSummary string First 300 characters of the description
relatedIcaos string[] Four-letter upper-case words found in the description — ICAO candidates, may contain false positives
icao, corpId string Always ""
read bool Always false 
{
  "alerts": [
    {
      "alertType": "VFR Manual",
      "id": "3791",
      "icao": "",
      "corpId": "",
      "description": "VFR Terminal Chart Notice for Europe",
      "releasedDate": 1791504000000,
      "expiredDate": null,
      "read": false,
      "attachmentCount": 1,
      "region": "Eastern Europe",
      "areas": "Armenia, Azerbaijan, Belarus, Bulgaria, ...",
      "textSummary": "...",
      "relatedIcaos": []
    }
  ],
  "total": 1
}

/alerts/filters

Field Type Description
regions string[] All regions, sorted and unique
categories string[] All categories, sorted and unique
subRegionsByRegion object Region → list of areas. Built from single-region notices only, so that global notices do not add every country to every region 
{
  "regions": ["Africa", "Eastern Europe", "..."],
  "categories": ["AMM Alert", "Airport Moving Map (AMM)", "Aviation", "..."],
  "subRegionsByRegion": {
    "Africa": ["Algeria", "Angola", "..."],
    "Canada & Alaska": ["Alaska", "Canada"]
  }
}

/alertdetail/{alert_id}

Same fields as a list item, plus the full text and the attachment list.

Field Type Description
id string Notice ID
title string Title
description string | null Same as title
category string Category
region, areas string Region(s) and areas
releasedDate int | null Epoch ms
textSummary string The full description text (not truncated)
attachments object[] {name, icao: null, index: "0"…, documentType}; documentType is the upper-cased file extension, e.g. "PDF"
jarsAlertId string Always ""
read bool Always false 
{
  "id": "3791",
  "jarsAlertId": "",
  "title": "VFR Terminal Chart Notice for Europe",
  "description": "VFR Terminal Chart Notice for Europe",
  "releasedDate": 1791504000000,
  "read": false,
  "attachments": [
    { "name": "vtn_eur.pdf", "icao": null, "index": "0", "documentType": "PDF" }
  ],
  "region": "Eastern Europe",
  "areas": "Armenia, Azerbaijan, ...",
  "category": "VFR Manual",
  "textSummary": "..."
}

/alertpdf/{alert_id}

The attachment itself, with the upstream content type (usually application/pdf), Content-Disposition: inline; filename=<name>.

Errors

Errors are returned as {"detail": "<message>"}.

Code Meaning
404 Notice <id> not found
404 Notice has no attached PDFs
404 Attachment index <n> out of range (total: <count>)
500 The notice list could not be retrieved

Notes

  • The whole notice list (~190 items) is retrieved at once and kept for 10 minutes; filtering happens on the cached copy. A request made while the cache is empty or expired takes about 25–45 s, every request within the following 10 minutes is immediate. Do not use /alerts as a synchronous call inside a request path without a timeout of at least 60 s.
  • Attachments are cached for 10 minutes as well.
  • relatedIcaos is a heuristic over the description text; do not treat it as an authoritative airport list.

Examples

# Filter menu values
curl 'https://jepp-api.ibosoft.net.tr:2087/alerts/filters'

# Notices for one region
curl 'https://jepp-api.ibosoft.net.tr:2087/alerts?region=Eastern%20Europe'

# Two regions, one category
curl 'https://jepp-api.ibosoft.net.tr:2087/alerts?region=Africa&region=Europe&category=VFR%20Manual'

# One notice and its first attachment
curl 'https://jepp-api.ibosoft.net.tr:2087/alertdetail/3791'
curl -o vtn_eur.pdf 'https://jepp-api.ibosoft.net.tr:2087/alertpdf/3791?attachment=0'