Notifications

Get alerts for a variety of booking events to simplify your operations and scale effectively

The Notifications service lets you integrate closely with the Rapid Flight API. When booking changes occur that can affect your business or operations, the Notifications service will push details of the change directly to your systems via standard POST messages. These push notifications enable you to remain informed, simplify your operations, and scale your business.

We currently support notifications for post-booking events that occur outside of our API. So, for example, if a call center agent makes a change or cancels a booking, you'll be notified immediately.

As we add features and functionality to the Rapid Flight API, we often also add new notification event types to improve your experience.

By enabling a seamless integration with your business, these notifications serve to complement Rapid API, Affiliate Voyager, and other partner and customer support services.

Event details

All POST notification events adhere to the values outlined below. As new event types are added for different events, the values may vary.

Object	Description
`affiliate_reference_id`	The Affiliate Reference ID of the affected booking.
`email`	The customer email address associated with the affected itinerary.
`event_id`	Unique identifier for each event.
`event_time`	Timestamp of the event notification given in UTC.
`event_type`	An indication of what event caused the notification. This value can be used for message handling and routing. Refer to the list of event types for more information.
`itinerary_id`	The Itinerary ID of the affected booking.

Each notification is an HTTPS POST request with a JSON message body.

Note: You must enable each event type individually to be able to receive those kinds of notifications. If you would like to enable a new Notifications event type, please reach out to support.

Supported event types

The Flight Notifications service can inform your systems with a message for the following events:

`event_type` value	Source	Event	Details
`itinerary.supplier.ticket`	Airline	Flight booking	The airline has confirmed the booking and issued a ticket (for ticketed flights).
`itinerary.unspecified.change`	Multiple	Flight change	An existing booking was updated by the traveler, an agent, or the airline (for involuntary changes, like a schedule change).
`itinerary.unspecified.cancel`	Multiple	Flight cancel	An existing booking was canceled by the traveler, airline or an agent.
`itinerary.supplier.refund`	Airline	Flight refund	The airline is providing traveler requested refunds. If the airline is the merchant of record, it is the duty of that airline to ensure the traveler receives the refund.
`itinerary.unspecified.void`	Multiple	Flight void	An existing booking was voided by the traveler, airline or an agent.

Supplier ticketing code sample

{  
    "affiliate_reference_id": "",  
   "email": "abc123@gmail.com",  
   "event_id": "dcec1653-3b7f-4b03-b056-50176642869d",  
   "event_time": "2025-12-10T17:15:13.115Z",  
   "event_type": "itinerary.supplier.ticket",  
   "itinerary_id": "9025417059279",  
   "message": "The supplier issued a ticket for this flight itinerary."  
}

Unspecified change code sample

{  
  "affiliate_reference_id": "",  
  "email": "abc123@gmail.com",  
 "event_id": "ab1bce97-175d-43d9-91c8-b09cdbf5ea46",  
  "event_time": "2025-12-10T17:15:21.016Z",  
  "event_type": "itinerary.unspecified.change",  
  "itinerary_id": "9025417973523",  
  "message": "This flight itinerary was changed."  
}

Unspecified cancel code sample

{  
  "affiliate_reference_id": "",  
  "email": "abc123@gmail.com",  
  "event_id": "221b5da6-820a-4e7b-85bd-1ba7639abda1",  
  "event_time": "2025-12-10T17:15:16.840Z",  
  "event_type": "itinerary.unspecified.cancel",  
  "itinerary_id": "9025417466019",  
  "message": "This flight itinerary was canceled."  
}

Supplier refund code sample

{  
  "affiliate_reference_id": "",  
  "email": "abc123@gmail.com", 
  "event_id": "aad184e3-d13b-41c6-99f3-ac13451fe3cc",  
  "event_time": "2025-12-10T17:15:22.954Z",  
  "event_type": "itinerary.supplier.refund",  
  "itinerary_id": "9025417466019",  
  "message": "The supplier initiated a refund for this flight itinerary."  
}

Unspecified void code sample

{  
  "affiliate_reference_id": "",  
  "email": "abc123@gmail.com", 
  "event_id": "aad184e3-d13b-41c6-99f3-ac13451fe3cc",  
  "event_time": "2025-12-10T17:15:22.954Z",  
  "event_type": "itinerary.unspecified.void",  
  "itinerary_id": "9025417466019",  
  "message": "This flight itinerary was voided."  
}