Integrate the FareTag engine

Authentication

Every request requires an X-Api-Key header. A demo key is available for testing:

Demo key: 25 requests/day. For production use, contact us below.

POST /api/v1/verdict

Send structured fare conditions, receive a complete verdict. Zero outbound network, zero third-party dependency.

{
  "refund": { "status": "allowed_with_fee", "fee": { "amount": 50, "currency": "EUR" } },
  "change": { "status": "not_allowed" },
  "baggage": { "checked_included": 1, "status": "known" },
  "fare_total": 400
}

Response:

{
  "grade": "C",
  "score": 53,
  "capApplied": null,
  "unknownCount": 0,
  "axes": [
    { "id": "refund", "label": "refundPenalty", "points": 31, "maxPoints": 40 },
    { "id": "change", "label": "changeNone", "points": 0, "maxPoints": 30 },
    { "id": "baggage", "label": "baggageIncluded", "points": 15, "maxPoints": 15 },
    { "id": "data", "label": "dataComplete", "points": 15, "maxPoints": 15 }
  ],
  "engineVersion": "v2"
}

GET /api/v1/editorial/{iata}/{fareBrand}

Returns the FareTag editorial sheet for an airline and fare family, with calculated verdict and dated provenance.

404 if the airline or family is not covered.

GET /api/v1/editorial

Coverage list: all documented airlines and families, with last verification date.

Embeddable badge

Display the FareTag grade wherever a ticket is sold. Server-generated SVG badge, cached, linked to the airline sheet.

<a href="https://faretag.com/compagnies/AF/light">
  <img src="https://faretag.com/api/badge/AF/light.svg"
       alt="Conditions verified by FareTag" />
</a>

Error codes

Playground

Test the engine with the demo key. Select conditions and run the scoring.

Licence

From 150 EUR/month. Custom quota, technical support, SLA. Contact us to discuss your use case.