Watcher API Webhook messages

Notamify NOTAM Watcher API sends JSON POST message to provided webhook_url . The NOTAM objct follows the same Notam DTO structure as in NOTAMs Active endpointand other notam endpoints, plus additional watcher metadata.

Messages are signed with webhook secret, read more: Webhook Security.

---

Message Types

Watcher can send two production webhook message types:

1. kind = "interpretation" Standard interpreted NOTAM delivery.

2. kind = "lifecycle" Additional lifecycle delivery when a NOTAM previously delivered to this listener is later cancelled (NOTAMC) or replaced (NOTAMR).

Top-Level Fields

• listener_id Listener ID that received the message.

• kind Message type. Values:

  • interpretation

  • lifecycle

• event_id Unique event identifier that can be used for deduplication.

• notam The NOTAM payload. This follows the same Notam DTO structure used by other Notamify NOTAM endpoints.

• change Present only for kind = "lifecycle". Describes which previously delivered NOTAM changed. Fields:

  • changed_notam_id: ID of the old NOTAM that was cancelled or replaced

  • notam_type: C or R

• context Optional additive metadata for the resolved location.

• sent_at UTC timestamp when Watcher sent the webhook.

notam Object

The notam object uses the normal Notamify Notam DTO shape. Common fields include:

• id

• notam_number

• notam_type

• location

• icao_code

• qcode

• classification

• starts_at

• ends_at

• issued_at

• is_estimated

• is_permanent

• message

• icao_message

• interpretation

Notes:

• For NOTAMR, notam is the replacement NOTAM.

• For NOTAMC, notam is the cancellation NOTAM.

• Lifecycle C/R does not contain interpretation.

context.location

context.location is optional metadata resolved from Notamify Data using the NOTAM icao_code when available, otherwise location.

Fields:

• ident

• icao

• iata_code

• name

• iso_country

• iso_country_name

• elevation_ft

• coordinates

• fir_icaos

Coordinates Meaning

context.location.coordinates are reference coordinates for the resolved location record.

• For an airport location, they represent the airport reference point or airport center.

• For an FIR location, they represent the geographic center of the FIR.

These coordinates are contextual only. They are not the NOTAM geometry.

If you need the actual NOTAM geometry, use:

• notam.interpretation.map_elements

That is where obstacle points, polygons, lines, and altitude limits are represented.

Interpretation Message Example

Example production interpretation message:

{
  "listener_id": "4b72327c-8a25-4f4c-9eea-aa801b3a4253",
  "kind": "interpretation",
  "event_id": "46345c14-14e8-4eee-b6fe-1108b7e51bf8",
  "notam": {
    "id": "46ac3cad-d0c8-4954-9db5-2ee68bbda40a",
    "notam_number": "A1727/26",
    "notam_type": "N",
    "location": "CVG",
    "icao_code": "KCVG",
    "qcode": "QOBCE",
    "classification": "INTL",
    "starts_at": "2026-03-09T11:00:00Z",
    "ends_at": "2026-03-13T23:00:00Z",
    "issued_at": "2026-03-06T20:16:00Z",
    "is_estimated": false,
    "is_permanent": false,
    "message": "CVG OBST CRANE (ASN UNKNOWN) 390259N0843920W (.2NM N APCH END RWY\n27) 1104FT (226FT AGL) FLAGGED AND LGTD",
    "icao_message": "A1727/26 NOTAMN\nQ) KZID/QOBCE/IV/M/AE/000/999/3903N08440W005\nA) KCVG\nB) 2603091100\nC) 2603132300\nD) DLY 1100-2300\nE) CVG OBST CRANE (ASN UNKNOWN) 390259N0843920W (.2NM N APCH END RWY\n27) 1104FT (226FT AGL) FLAGGED AND LGTD",
    "interpretation": {
      "description": "At CVG, a construction crane is erected 0.2 NM north of the approach end of RWY 27 at 390259N0843920W, elevation 1104 ft MSL (226 ft AGL), flagged and lighted, active daily 1100-2300.",
      "excerpt": "Crane erected near CVG RWY 27 approach.",
      "category": "OBSTACLES",
      "subcategory": "CRANE_OPERATIONS",
      "map_elements": [
        {
          "element_type": "point",
          "coordinates": [
            {
              "lat": 39.049722,
              "lon": -84.655556,
              "raw_string": "390259N0843920W"
            }
          ],
          "description": "CVG obstacle - crane (ASN UNKNOWN); flagged and lighted.",
          "geojson": {
            "geometry": {
              "coordinates": [-84.655556, 39.049722],
              "type": "Point"
            },
            "properties": {
              "element_type": "point"
            },
            "type": "Feature"
          },
          "top": {
            "height": {
              "raw_string": "226FT AGL",
              "reference": "AGL",
              "unit": "FT",
              "value": 226,
              "value_ft": 226
            },
            "limit": {
              "raw_string": "1104FT (226FT AGL)",
              "reference": "AMSL",
              "unit": "FT",
              "value": 1104,
              "value_ft": 1104
            }
          }
        }
      ],
      "affected_elements": [],
      "schedules": [
        {
          "source": "DLY 1100-2300",
          "description": "Daily 11:00-23:00 UTC",
          "rrule": "DTSTART:20260309T110000Z\nRRULE:FREQ=DAILY;UNTIL=20260313T110000Z",
          "duration_hrs": 12,
          "is_sunrise_sunset": false
        }
      ],
      "schedule_description": "Daily 11:00-23:00 UTC"
    }
  },
  "context": {
    "location": {
      "ident": "KCVG",
      "icao": "KCVG",
      "iata_code": "CVG",
      "name": "Cincinnati Northern Kentucky International Airport",
      "iso_country": "US",
      "iso_country_name": "United States of America",
      "elevation_ft": 896,
      "coordinates": {
        "lat": 39.048801,
        "lon": -84.667801
      },
      "fir_icaos": [
        "KZID"
      ]
    }
  },
  "sent_at": "2026-03-06T20:18:08.626671414Z"
}

Lifecycle Message Example

Example lifecycle message for a replacement (NOTAMR):

{
  "listener_id": "4b72327c-8a25-4f4c-9eea-aa801b3a4253",
  "kind": "lifecycle",
  "event_id": "0815e626-f243-44ff-9ed9-88919c2218b7",
  "notam": {
    "id": "d380290b-9cca-45d8-8742-d51ba6a6518b",
    "notam_number": "A0052/26",
    "notam_type": "R",
    "location": "HTDA",
    "icao_code": "HTDA",
    "qcode": "QSPXX",
    "classification": "INTL",
    "starts_at": "2026-03-06T12:05:00Z",
    "ends_at": "2026-03-20T15:30:00Z",
    "issued_at": "2026-03-06T12:07:00Z",
    "is_estimated": true,
    "is_permanent": false,
    "message": "ATC TRG INPR AT APP FREQ 119.600MHZ AND 120.00MHZ . PILOTS TO BE PATIENT AND COOPERATIVE.",
    "icao_message": "A0052/26 NOTAMR A0031/26\nQ) HTDC/QSPXX/IV/BO/AE/000/999/0652S03912E005\nA) HTDA\nB) 2603061205 C) 2603201530 EST\nE) ATC TRG INPR AT APP FREQ 119.600MHZ AND 120.00MHZ . PILOTS TO BE PATIENT AND COOPERATIVE."
  },
  "change": {
    "changed_notam_id": "old-notam-uuid",
    "notam_type": "R"
  },
  "context": {
    "location": {
      "ident": "HTDA",
      "icao": "HTDA",
      "iata_code": "",
      "name": "Julius Nyerere International Airport",
      "iso_country": "TZ",
      "iso_country_name": "Tanzania, United Republic of",
      "elevation_ft": 182,
      "coordinates": {
        "lat": -6.878111,
        "lon": 39.202625
      },
      "fir_icaos": [
        "HTDC"
      ]
    }
  },
  "sent_at": "2026-03-06T20:20:00.000000000Z"
}

Interpretation of this lifecycle message:

• kind = "lifecycle" means this is not a normal interpretation delivery.

• notam is the new replacement NOTAM (A0052/26).

• change.changed_notam_id is the old NOTAM that was replaced.

• change.notam_type = "R" means replacement.

For cancellation messages, the structure is the same, but change.notam_type and notam.notam_type are C.

Important Notes

• kind and event_id are included in production interpretation and lifecycle webhook deliveries.

• Lifecycle messages are sent only when lifecycle_enabled = true.

• Lifecycle routing is based on prior successful production webhook delivery of the original NOTAM.

• Lifecycle webhook deliveries do not increment shipment credits.

• filters.notam_type = ["R"] means the delivered NOTAM itself is a replacement NOTAM. It does not mean the old replaced NOTAM is sent as the main notam object.

Example lifecycle message for a cancellation (NOTAMC):

{
  "listener_id": "4b72327c-8a25-4f4c-9eea-aa801b3a4253",
  "kind": "lifecycle",
  "event_id": "b69fee6c-c3b3-4fa8-a8c3-d5fe9d942d85",
  "notam": {
    "id": "cancel-uuid",
    "notam_number": "A1572/26",
    "notam_type": "C",
    "location": "EWR",
    "icao_code": "KEWR",
    "qcode": "QMRXX",
    "classification": "INTL",
    "starts_at": "2026-03-04T10:18:00Z",
    "ends_at": "2026-03-07T10:18:00Z",
    "issued_at": "2026-03-04T10:18:00Z",
    "is_estimated": false,
    "is_permanent": false,
    "message": "A1572/26 NOTAMC A1553/26 \nQ) KZNY/QMRXX/IV/NBO/A/000/999/4042N07410W005 \nA) KEWR\nB) 2603041018\nE)  EWR RWY 11/29 CLSD\nCANCELED",
    "icao_message": "A1572/26 NOTAMC A1553/26\nQ) KZNY/QMRXX/IV/NBO/A/000/999/4042N07410W005\nA) KEWR\nB) 2603041018\nE) EWR RWY 11/29 CLSD\nCANCELED"
  },
  "change": {
    "changed_notam_id": "old-notam-uuid",
    "notam_type": "C"
  },
  "context": {
    "location": {
      "ident": "KEWR",
      "icao": "KEWR",
      "iata_code": "EWR",
      "name": "Newark Liberty International Airport",
      "iso_country": "US",
      "iso_country_name": "United States of America",
      "elevation_ft": 18,
      "coordinates": {
        "lat": 40.6925,
        "lon": -74.168667
      },
      "fir_icaos": [
        "KZNY"
      ]
    }
  },
  "sent_at": "2026-03-06T20:25:00.000000000Z"
}

Interpretation of this cancellation lifecycle message:

• kind = "lifecycle" means this is not a normal interpretation delivery.

• notam is the cancellation NOTAM itself.

• change.changed_notam_id is the old NOTAM that was cancelled.

• change.notam_type = "C" means cancellation.

Important Notes

• kind and event_id are included in production interpretation and lifecycle webhook deliveries.

• Lifecycle messages are sent only when lifecycle_enabled = true.

• Lifecycle routing is based on prior successful production webhook delivery of the original NOTAM.

• Lifecycle webhook deliveries do not increment shipment credits.

• filters.notam_type = ["R"] means the delivered NOTAM itself is a replacement NOTAM. It does not mean the old replaced NOTAM is sent as the main notam object.