Fare rules
Get fare rules for an offer.
Only Kitionz Test Air supports this today. With your Live suppliers this call is refused, so build it in Test but do not depend on it in Live yet.
What: the cancellation / change penalties + conditions for a specific offer.
When: before /book, to show the traveller what they’re committing to.
Gotcha: availability is per offer: check eligibility.fareRulesAvailable on the fare quote.
Send offerId: the offer’s offerId from /search (supplierOfferRef is the old name, accepted until the next release). Any other parameter → 400 VALIDATION_ERROR.
Authentication
Your Kitionz API key, sent as Authorization: Bearer keyId:secret. Create a Test key at sandbox.kitionz.com → API keys, a Live key at kitionz.com → API → API keys.
Query parameters
Required (or its old name supplierOfferRef; send one, null is refused): the id of the offer you chose in /search — the offer’s offerId (floffer_…, 30 characters).
Leave it out: the offer id already names the supplier. Only an organisation shown suppliers before booking may send it, and it must then match the offer; for everyone else it is refused with SOURCE_CODE_NOT_ACCEPTED.
Response
Time-banded fare rules for an offer (+ resolved sourceCode).