# 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

Notamify process RAW NOTAMs via streaming services, which assure minimal delay. However, 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

Immediate interpretation and subsequent shipment depend on your **ICAO coverage**.

* If the NOTAM’s ICAO code is in any of your listeners, interpretation is scheduled immediately and, if it matches filters, a shipment is sent.
* If the ICAO code is not present in your listeners, immediate interpretation is not scheduled and the NOTAM will be send when it gots interpreted in Notamify systems (by batch loads, other API calls, user queries).

{% 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

* Interpretation is placed in the immediate queue **only when the NOTAM’s ICAO is present in at least one of your listeners**.
* Typical delay from NOTAM issue time to listiner 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 active 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).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://skymerse.gitbook.io/notamify-api/notam-watcher/when-notamify-watcher-sends-a-shipment.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.