# Airline Status Update Notification

{% hint style="info" %}
💬 **Need help?** If you're stuck, ask Eva on ATRIP for instant diagnostics.

<a href="https://www.atriptech.com/" class="button primary" data-icon="comments">Ask Eva</a>
{% endhint %}

Use this webhook when you need to react to airline-level availability changes.

### Trigger

Atlas sends `airline.status` when an airline moves between active, maintenance, or inactive states.

### What you should do

When you receive this event:

* update internal airline availability flags
* adjust search caching or routing behavior
* suppress booking flows for inactive or maintenance airlines if needed

### Endpoint

POST to the webhook URL you registered with Atlas.

### Fields to read first

* `type`
* `data.airline`
* `data.airlineStatus`

### Airline status values

* `Active`
* `Maintenance`
* `Inactive`

### Typical payload

```json
{
  "data": {
    "airline": ["TO", "HV"],
    "airlineStatus": "Active"
  },
  "status": -1,
  "type": "airline.status"
}
```

### Notes

* `status` is internal and should not be used for business logic
* this event is operational, not order-specific
* treat `Maintenance` and `Inactive` as non-bookable until recovery

{% tabs %}
{% tab title="Schema" %}
**data**

* **Type:** Object
* **Required:** Yes
* **Description:** Contains airline information including the airline codes and their status.
* **Default:** None
* **Example:**

  ```json
  {
    "airline": ["TO", "HV"],
    "airlineStatus": "Active"
  }
  ```

**data.airline**

* **Type:** Array of Strings
* **Required:** Yes
* **Description:** List of airline codes associated with the response.
* **Default:** None
* **Example:** `["TO", "HV"]`

**data.airlineStatus**

* **Type:** String
* **Required:** Yes
* **Description:** Indicates the operational status of the airline(s).
* **Valid values:**
  * Active = Online
  * Maintenance = Airline is under maintenance
  * Inactive = Offline
* **Default:** None
* **Example:** `"Active"`

**status**

* **Type:** Integer
* **Required:** Yes
* **Description:** Indicates the response status. Only for internal use by Atlas.
* **Default:** None
* **Example:** `-1`

**type**

* **Type:** String
* **Required:** Yes
* **Description:** Specifies the type of response message.
* **Valid value:**
  * airline.status
* **Default:** None
* **Example:** `"airline.status"`
  {% endtab %}

{% tab title="Samples" %}

```json
{
  "data":{
     "airline":["TO","HV"],
     "airlineStatus":"Active"},
  "status":-1,
  "type":"airline.status"
}
```

{% endtab %}
{% endtabs %}

### Related pages

* [Webhook Overview](https://resources.atriptech.com/api-document/readme/webhook-overview)
* [Search Errors](https://resources.atriptech.com/api-document/troubleshooting-and-support/errors-handing/search-errors)