> For the complete documentation index, see [llms.txt](https://skymerse.gitbook.io/notamify-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://skymerse.gitbook.io/notamify-api/notam-watcher/when-notamify-watcher-sends-a-shipment.md).

# When Notamify Watcher Sends a Shipment

Notamify Watcher API sends two type of messages: interpretation and lifecycle. This article focuses on **interpretation** message type. For more about lifecycle go to [Watcher NOTAM Lifecycle](/notamify-api/notam-watcher/watcher-notam-lifecycle.md).

### What counts as an interpretation shipment

A shipment for listeners is sent only when a **new interpretation** becomes available in Notamify that matches your listener filters.

### The gate that controls immediacy

Prompt delivery depends on your **ICAO coverage**.

* If the NOTAM’s ICAO code is in any of your listeners, the NOTAM is prioritized for interpretation and, if it matches filters, a shipment is sent.
* If the ICAO code is not present in your listeners, the NOTAM is not prioritized and will be delivered once its interpretation becomes available in Notamify, which may take longer.

{% hint style="info" %}
Register the ICAO codes you care about in your listeners. Accounts can register up to **50 distinct ICAO codes**. If you need more, contact [**hello@notamify.com**](mailto:hello@notamify.com).
{% endhint %}

#### The timing you should expect

* A NOTAM is prioritized for prompt delivery **only when its ICAO is present in at least one of your listeners**.
* Typical delay from NOTAM issue time to listener shipment is up to 2-3 minutes (not guaranteed).

{% hint style="danger" %}
**Service and Timing Disclaimer:** Delivery times and availability are targets and are not guaranteed. Notamify relies on upstream official aeronautical data providers and network transport that can experience delays or outages.
{% endhint %}

### Listener filters and matching logic

A shipment is sent if all of the following are true:

1. The NOTAM has been interpreted in Notamify.
2. At least one active listener includes the NOTAM’s ICAO code.
3. The interpretation matches the listener’s filters:
   * OR within a field
   * AND across fields
   * `category=['all']` matches any category
   * `affected_element` can match by `effect`, `type`, or both
4. Your account has credits available.

If credits reach zero, shipments are blocked until credits are topped up.

### Listener and ICAO limits

* Up to **15 listeners** per account
* Up to **50 ICAO codes** per account across all listeners
* Need more ICAO codes or listeners, please contact [**hello@notamify.com**](mailto:hello@notamify.com)

### Takeaways

* Watcher ships on **interpretation availability**, not raw issuance.
* **ICAO coverage** in your listeners is the key to immediate interpretation and shipment.
* Keep filters aligned with your operational needs.
* Maintain credits to avoid blocked deliveries.

Questions or requests for higher limits: [**hello@notamify.com**](mailto:hello@notamify.com).