Hermeseus Docs
Legacy docs

Fare conditions

Before booking, show the traveller what the fare allows: its rules and penalties, and the checked and cabin baggage. Fare conditions return both for a given offer.

Get conditions

GET/v3/HAPI/flights/offers/{id}/conditions

Requires the flights:read scope. The {id} is an ofr_ id from a search.

curl https://api.hermeseus.com/v3/HAPI/flights/offers/ofr_dHJhdmVscGF5b3V0cz.../conditions \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Response

{
  "object": "flight_conditions",
  "offer_id": "ofr_dHJhdmVscGF5b3V0cz...",
  "fare_type": 2,
  "fare_rules": [
    {
      "airline": "PC",
      "route": "IST-DXB",
      "rules": [
        { "category": "Cancellations", "text": "Cancellation permitted with a penalty…" },
        { "category": "Changes", "text": "Changes permitted before departure…" }
      ]
    }
  ],
  "baggage": [
    {
      "origin": "IST",
      "destination": "DXB",
      "flight_number": "695",
      "allowance": "1 Piece(s) x 20 Kilogram(s)"
    }
  ]
}
FieldDescription
fare_rules[]Rule groups per airline and route, each with a list of { category, text } entries.
baggage[]The checked-baggage allowance per flight segment.
Read conditions from a live offer. Conditions are drawn from the cached offer, so fetch them for an offer that came from a recent search. If the offer has expired, run a fresh search first.