Skip to main content

Reporting a flight cancellation

For any subscriptions including at least a flight, we will always control the flight status.

However, you may have access to this information before Koala. To ensure an optimal customer experience, we need you! 🙌

When should you report a flight cancellation?​

You will need to report a flight cancellation if:

  • You received information from the carrier that your flight has been cancelled
  • You received a written confirmation with proof (e.g. cancellation email) from your customer informing you of a flight cancelled
note

We consider as cancelled flights, any flight that will not be carried out by the carrier. If a flight is rescheduled on the same day with the same flight number, you should not report it.

How can you report a flight cancellation?​

When you become aware of a cancelled flight, you should POST the flights' details through:

curl -X POST "https://staging-partner.api.hikoala.co/flights/{airlineIata}/{number}/{localDepartureDate}/{departureAirportIata}/statuses" -H "Content-Type: application/JSON" -H "accept: application/JSON" -H "Authorization: Bearer <token>"

You will have to replace the following fields inside your call:

  • {airlineIata}: IATA of the carrier (e.g. AF for Air France)
  • {number}: Flight Number (e.g. 1380)
  • {localDepartureDate}: Date of the flight under the format YYYY-MM-DD (e.g. 2022-10-29 for a flight on October 29th, 2022)
  • {departureAirportIata}: IATA of the departure Airport (e.g. CDG for Charles de Gaulle International Airport)

Inside the payload, you will need to add:

  • providedAt: DateTime when you received the information (ISO 8601 format)
  • status: Status of the flight (you should mention Canceled)

Possible outputs​

Our API can send you back the following responses:

  • 201: We have accepted your flight status, thanks a lot for that 🙌
  • 400: Something went wrong with your call. You may have forgotten one mandatory field or made a mistake with one format.
  • 401: The cancellation reporting cannot be made because you are experiencing an issue with your token.
  • 404: We do not have any subscriptions containing this flight. We cannot take this flight cancellation into account.