NOTAM Watcher API

The Watcher service is in early preview. The specifications, filter set, pricing can change dynamically. For any questions, please contact us on [e-mail].

The Notamify Watcher Service allows automatic retrieval of new interpretations in Notamify based on configurable filters. The service supports listener management via webhooks, enabling applications to subscribe to NOTAM updates by airport code, category, subcategory, or specific NOTAM identifiers.

The Watcher service charges credits based on the number of NOTAM deliveries sent to registered listeners:

• 1 credit = 30 shipments

• Each shipment increments a counter for the user.

• When the counter reaches 30, the service deducts 1 credit and resets the counter.

• If the user has no credits remaining, further shipments are blocked until credits are topped up.

User can have maximally up to 15 active listeners.

If you specified webhook_url the service will provide each new notam for the filter as described in Watcher API Webhook message.

List listeners

get

Returns all registered listeners for the authenticated account.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

List of listeners

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

500

Internal Server Error

get

/listeners

HTTPcURLJavaScriptPython

GET /listeners HTTP/1.1
Host: watcher.notamify.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "listeners": [
    {
      "id": "text",
      "name": "text",
      "webhook_url": "https://example.com",
      "email": "[e-mail]",
      "filters": {
        "notam_id": [
          "text"
        ],
        "notam_icao": [
          "text"
        ],
        "category": [
          "all"
        ],
        "subcategory": [
          "RUNWAY_OPERATIONS"
        ],
        "affected_element": [
          {
            "effect": "CLOSED",
            "type": "AERODROME"
          }
        ]
      },
      "active": true,
      "created_at": "2025-12-23T21:53:18.567Z",
      "updated_at": "2025-12-23T21:53:18.567Z"
    }
  ]
}

Create listener

post

Registers a webhook URL and filters. Filters use OR semantics within a field and AND semantics across fields. For example, category=['AERODROME','AIRSPACE'] means either category matches; combining with notam_icao=['EPWA'] requires both field conditions to match. Using category=['all'] matches any category.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

namestring · max: 100Optional

Optional human-readable name for the listener (max 100 characters).

webhook_urlstring · uriOptional

Destination HTTPS/HTTP endpoint for notifications. Must be a public URL, not localhost or 192.168.x.x/0.0.x.x range. Required when email is omitted.

emailstring · emailOptional

Optional email recipient for Postmark delivery. Required when webhook_url is omitted.

activebooleanOptional

Whether the listener is active. Defaults to true if not provided. Set to false to temporarily disable notifications without deleting the listener.

Default: true

Responses

201

Listener created

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

500

Internal Server Error

post

/listeners

HTTPcURLJavaScriptPython

POST /listeners HTTP/1.1
Host: watcher.notamify.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 281

{
  "name": "Warsaw & Heathrow Runway Closures",
  "webhook_url": "https://example.com/notam-webhook",
  "filters": {
    "notam_icao": [
      "EPWA",
      "EGLL"
    ],
    "category": [
      "AERODROME"
    ],
    "subcategory": [
      "RUNWAY_OPERATIONS"
    ],
    "affected_element": [
      {
        "effect": "CLOSED",
        "type": "RUNWAY"
      }
    ]
  },
  "email": "[e-mail]"
}

AERODROME runway ops for EPWA or EGLLAll categories for a given NOTAM IDCreate an inactive listener (paused)

{
  "id": "text",
  "name": "text",
  "webhook_url": "https://example.com",
  "email": "[e-mail]",
  "filters": {
    "notam_id": [
      "text"
    ],
    "notam_icao": [
      "text"
    ],
    "category": [
      "all"
    ],
    "subcategory": [
      "RUNWAY_OPERATIONS"
    ],
    "affected_element": [
      {
        "effect": "CLOSED",
        "type": "AERODROME"
      }
    ]
  },
  "active": true,
  "created_at": "2025-12-23T21:53:18.567Z",
  "updated_at": "2025-12-23T21:53:18.567Z"
}

Update listener

put

Updates webhook URL and/or filters using the same semantics as creation.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

Listener ID

Body

application/json

namestring · max: 100Optional

Optional human-readable name for the listener (max 100 characters).

webhook_urlstring · uriOptional

Destination HTTPS/HTTP endpoint for notifications. Must be a public URL, not localhost or 192.168.x.x/0.0.x.x range. Required when email is omitted.

emailstring · emailOptional

Optional email recipient for Postmark delivery. Required when webhook_url is omitted.

activebooleanOptional

Whether the listener is active. Defaults to true if not provided. Set to false to temporarily disable notifications without deleting the listener.

Default: true

Responses

200

Listener updated

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

500

Internal Server Error

put

/listeners/{id}

HTTPcURLJavaScriptPython

PUT /listeners/{id} HTTP/1.1
Host: watcher.notamify.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 259

{
  "name": "text",
  "webhook_url": "https://example.com",
  "email": "[e-mail]",
  "filters": {
    "notam_id": [
      "text"
    ],
    "notam_icao": [
      "text"
    ],
    "category": [
      "all"
    ],
    "subcategory": [
      "RUNWAY_OPERATIONS"
    ],
    "affected_element": [
      {
        "effect": "CLOSED",
        "type": "AERODROME"
      }
    ]
  },
  "active": true
}

{
  "id": "text",
  "name": "text",
  "webhook_url": "https://example.com",
  "email": "[e-mail]",
  "filters": {
    "notam_id": [
      "text"
    ],
    "notam_icao": [
      "text"
    ],
    "category": [
      "all"
    ],
    "subcategory": [
      "RUNWAY_OPERATIONS"
    ],
    "affected_element": [
      {
        "effect": "CLOSED",
        "type": "AERODROME"
      }
    ]
  },
  "active": true,
  "created_at": "2025-12-23T21:53:18.567Z",
  "updated_at": "2025-12-23T21:53:18.567Z"
}

Delete listener

delete

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

Listener ID

Responses

204

Deleted

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

500

Internal Server Error

delete

/listeners/{id}

HTTPcURLJavaScriptPython

DELETE /listeners/{id} HTTP/1.1
Host: watcher.notamify.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content