SOS Flights

Checks a cancelled, delayed, overbooked or missed-connection flight against EU261, UK261 and US DOT rules. Returns the law that applies, up to three options (refund, re-routing), the care the airline owes (meals, hotel), a compensation range per passenger with its conditions, warnings and facts that would sharpen the answer. Advice only, not legal advice.

{
  "type": "object",
  "properties": {
    "type": {
      "description": "What happened to the flight.",
      "type": "string",
      "enum": [
        "cancellation",
        "delay",
        "denied_boarding",
        "missed_connection"
      ]
    },
    "origin": {
      "description": "IATA code of the departure airport, for example VIE.",
      "type": "string",
      "pattern": "^[A-Za-z]{3}$"
    },
    "destination": {
      "description": "IATA code of the final destination on the booking, for example LHR.",
      "type": "string",
      "pattern": "^[A-Za-z]{3}$"
    },
    "carrier": {
      "description": "IATA code of the operating airline, for example FR, W6 or OS.",
      "type": "string",
      "minLength": 2,
      "maxLength": 3
    },
    "arrival_delay_minutes": {
      "description": "Expected arrival delay at the final destination, in minutes.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "departure_delay_minutes": {
      "description": "Departure delay in minutes, if different from the arrival delay.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "notice_days": {
      "description": "Cancellations: days between the notice and scheduled departure.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "reroute_departs_earlier_minutes": {
      "description": "Re-routing offered: how many minutes earlier it departs than the original flight.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "reroute_arrives_later_minutes": {
      "description": "Re-routing offered: how many minutes later it arrives than the original flight.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "single_booking": {
      "description": "Missed connections: were all flights on one booking?",
      "type": "boolean"
    },
    "volunteered": {
      "description": "Denied boarding: did the traveller volunteer?",
      "type": "boolean"
    },
    "cause": {
      "description": "Reason given by the airline, if known.",
      "type": "string",
      "enum": [
        "unknown",
        "technical",
        "airline_staff_strike",
        "crew_shortage",
        "weather",
        "atc",
        "atc_strike",
        "airport_strike",
        "security",
        "bird_strike",
        "political",
        "medical"
      ]
    },
    "overnight": {
      "description": "True if the traveller must stay overnight.",
      "type": "boolean"
    }
  },
  "required": [
    "type",
    "origin",
    "destination"
  ]
}

{
  "type": "object",
  "properties": {
    "law": {
      "type": "string",
      "enum": [
        "EU261",
        "UK261",
        "US_DOT",
        "NONE"
      ]
    },
    "law_reason": {
      "type": "string"
    },
    "distance_km": {
      "type": "number"
    },
    "options": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "care": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "follow_ups": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "compensation": {
      "type": "object",
      "properties": {
        "currency": {
          "type": "string",
          "enum": [
            "EUR",
            "GBP",
            "USD"
          ]
        },
        "min": {
          "type": "number"
        },
        "max": {
          "type": "number"
        },
        "conditions": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "currency",
        "min",
        "max",
        "conditions"
      ]
    },
    "sources": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "label": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "label",
          "url"
        ]
      }
    },
    "last_verified": {
      "type": "string"
    },
    "help_url": {
      "type": "string"
    }
  },
  "required": [
    "law",
    "law_reason",
    "options",
    "care",
    "warnings",
    "follow_ups",
    "sources",
    "last_verified",
    "help_url"
  ]
}

Writes 1 to 3 short, polite sentences for a traveller to say to the airline agent, asking for re-routing, care or a refund. The sentences are in the traveller's language and cite the regulation that applies.

{
  "type": "object",
  "properties": {
    "type": {
      "description": "What happened to the flight.",
      "type": "string",
      "enum": [
        "cancellation",
        "delay",
        "denied_boarding",
        "missed_connection"
      ]
    },
    "origin": {
      "description": "IATA code of the departure airport, for example VIE.",
      "type": "string",
      "pattern": "^[A-Za-z]{3}$"
    },
    "destination": {
      "description": "IATA code of the final destination on the booking, for example LHR.",
      "type": "string",
      "pattern": "^[A-Za-z]{3}$"
    },
    "carrier": {
      "description": "IATA code of the operating airline, for example FR, W6 or OS.",
      "type": "string",
      "minLength": 2,
      "maxLength": 3
    },
    "arrival_delay_minutes": {
      "description": "Expected arrival delay at the final destination, in minutes.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "departure_delay_minutes": {
      "description": "Departure delay in minutes, if different from the arrival delay.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "notice_days": {
      "description": "Cancellations: days between the notice and scheduled departure.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "reroute_departs_earlier_minutes": {
      "description": "Re-routing offered: how many minutes earlier it departs than the original flight.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "reroute_arrives_later_minutes": {
      "description": "Re-routing offered: how many minutes later it arrives than the original flight.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "single_booking": {
      "description": "Missed connections: were all flights on one booking?",
      "type": "boolean"
    },
    "volunteered": {
      "description": "Denied boarding: did the traveller volunteer?",
      "type": "boolean"
    },
    "cause": {
      "description": "Reason given by the airline, if known.",
      "type": "string",
      "enum": [
        "unknown",
        "technical",
        "airline_staff_strike",
        "crew_shortage",
        "weather",
        "atc",
        "atc_strike",
        "airport_strike",
        "security",
        "bird_strike",
        "political",
        "medical"
      ]
    },
    "overnight": {
      "description": "True if the traveller must stay overnight.",
      "type": "boolean"
    },
    "lang": {
      "description": "Traveller's language for any text meant to be read out or copied. Defaults to en.",
      "type": "string",
      "enum": [
        "en",
        "sk",
        "cs",
        "de",
        "pl",
        "hu",
        "it",
        "es"
      ]
    }
  },
  "required": [
    "type",
    "origin",
    "destination"
  ]
}

{
  "type": "object",
  "properties": {
    "law": {
      "type": "string",
      "enum": [
        "EU261",
        "UK261",
        "US_DOT",
        "NONE"
      ]
    },
    "lang": {
      "type": "string"
    },
    "say": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "law",
    "lang",
    "say"
  ]
}

Lists hotel, lounge and transfer search links for an airport, nearby alternative airports with directions, and who pays for a hotel under EU and UK rules. Links only, nothing is booked. Covers about 100 airports in Europe, North America and Asia.

{
  "type": "object",
  "properties": {
    "airport": {
      "description": "IATA code of the airport where the traveller is, for example VIE.",
      "type": "string",
      "pattern": "^[A-Za-z]{3}$"
    },
    "need": {
      "description": "What the traveller needs. Defaults to all.",
      "type": "string",
      "enum": [
        "hotel",
        "lounge",
        "transfer",
        "all"
      ]
    }
  },
  "required": [
    "airport"
  ]
}

{
  "type": "object",
  "properties": {
    "airport": {
      "type": "object",
      "properties": {
        "iata": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "city": {
          "type": "string"
        },
        "country": {
          "type": "string"
        }
      },
      "required": [
        "iata",
        "name",
        "city",
        "country"
      ]
    },
    "links": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "label": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "label",
          "url"
        ]
      }
    },
    "nearby_airports": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "iata": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "distance_km": {
            "type": "number"
          },
          "directions_url": {
            "type": "string"
          }
        },
        "required": [
          "iata",
          "name",
          "distance_km",
          "directions_url"
        ]
      }
    },
    "who_pays": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "airport",
    "links",
    "nearby_airports",
    "who_pays"
  ]
}

Searches live one-way flights from the traveller's airport and airports within 300 km to their destination on one date, ordered by earliest arrival, with price in EUR, stops, ground distance to the alternative airport and rail operator links for trips under 1,200 km. Returns 10 options per page; times are local to each airport. Nothing is booked.

{
  "type": "object",
  "properties": {
    "origin": {
      "description": "IATA code of the airport where the traveller is now, for example BTS.",
      "type": "string",
      "pattern": "^[A-Za-z]{3}$"
    },
    "destination": {
      "description": "IATA airport or city code of the destination, for example LON.",
      "type": "string",
      "pattern": "^[A-Za-z]{3}$"
    },
    "date": {
      "description": "Travel date, ISO 8601, for example 2026-10-02. From today up to 365 days ahead.",
      "type": "string"
    },
    "include_nearby_airports": {
      "description": "Also search from the two nearest airports within 300 km. Defaults to true.",
      "type": "boolean"
    },
    "limit": {
      "description": "Options per page, 1 to 25. Defaults to 10.",
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    },
    "cursor": {
      "description": "next_cursor from the previous page.",
      "type": "string"
    }
  },
  "required": [
    "origin",
    "destination",
    "date"
  ]
}

{
  "type": "object",
  "properties": {
    "flights": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "from": {
            "type": "string"
          },
          "to": {
            "type": "string"
          },
          "departure": {
            "type": "string"
          },
          "arrival": {
            "type": "string"
          },
          "price_eur": {
            "type": "number"
          },
          "stops": {
            "type": "number"
          },
          "flight_numbers": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "carriers": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "booking_url": {
            "type": "string"
          },
          "ground_transfer": {
            "type": "object",
            "properties": {
              "distance_km": {
                "type": "number"
              },
              "directions_url": {
                "type": "string"
              }
            },
            "required": [
              "distance_km",
              "directions_url"
            ]
          }
        },
        "required": [
          "from",
          "to",
          "departure",
          "arrival",
          "price_eur",
          "stops",
          "flight_numbers",
          "carriers",
          "booking_url"
        ]
      }
    },
    "rail": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "label": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "label",
          "url"
        ]
      }
    },
    "who_pays": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "next_cursor": {
      "type": "string"
    }
  },
  "required": [
    "flights",
    "rail",
    "who_pays"
  ]
}

Checks the details for a case handled by the SOS Flights team (rebooking help, hotel, evidence and follow-up) and returns what will be submitted, the price (a one-time fee, or covered by a valid access code) and a confirmation_token valid for 15 minutes. Nothing is created or charged. No account is needed.

{
  "type": "object",
  "properties": {
    "situation_summary": {
      "description": "Summary for the team: airport, number of travellers and children's ages, what happened, flight number and booking reference, destination and urgency, constraints, any safety risk.",
      "type": "string",
      "minLength": 20,
      "maxLength": 4000
    },
    "email": {
      "description": "Traveller's email for the payment receipt and case updates.",
      "type": "string",
      "maxLength": 254
    },
    "phone": {
      "description": "Traveller's mobile number with country code, for example +421905123456. The WhatsApp number, or an urgent contact for chat.",
      "type": "string",
      "minLength": 6,
      "maxLength": 20
    },
    "channel": {
      "description": "How the team talks to the traveller, as the traveller chose: whatsapp, or chat in this assistant conversation and on the case page.",
      "type": "string",
      "enum": [
        "whatsapp",
        "chat"
      ]
    },
    "surname": {
      "description": "Traveller's surname.",
      "type": "string",
      "minLength": 2,
      "maxLength": 100
    },
    "access_code": {
      "description": "Prepaid access code, for example from OneYear Protection.",
      "type": "string",
      "minLength": 3,
      "maxLength": 20
    },
    "lang": {
      "description": "Language for the payment and case pages. Defaults to en.",
      "type": "string",
      "enum": [
        "en",
        "sk",
        "cs",
        "de",
        "pl",
        "hu"
      ]
    }
  },
  "required": [
    "situation_summary",
    "email",
    "phone",
    "channel"
  ]
}

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string"
    },
    "situation_summary": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "surname": {
      "type": "string"
    },
    "channel": {
      "type": "string",
      "enum": [
        "whatsapp",
        "chat"
      ]
    },
    "payment": {
      "type": "string",
      "enum": [
        "checkout",
        "access_code"
      ]
    },
    "price_eur": {
      "type": "number"
    },
    "confirmation_token": {
      "type": "string"
    },
    "expires_at": {
      "type": "string"
    }
  },
  "required": [
    "email",
    "situation_summary",
    "phone",
    "channel",
    "payment",
    "price_eur",
    "confirmation_token",
    "expires_at"
  ]
}

Opens the case prepared with a confirmation_token, after the traveller confirmed it. Returns the case code, which is the key to the case afterwards, the case page and either a payment link (the case becomes active after payment) or, with an access code, an active case.

{
  "type": "object",
  "properties": {
    "confirmation_token": {
      "description": "confirmation_token from the prepare step, for example sc_3qJ8vT0kPzL1mW6xR2aYbQ. Valid for 15 minutes.",
      "type": "string",
      "minLength": 10,
      "maxLength": 64
    },
    "idempotency_key": {
      "description": "Key that makes a retry safe: a repeated key returns the first result. Defaults to one key per confirmation_token.",
      "type": "string",
      "minLength": 8,
      "maxLength": 100
    }
  },
  "required": [
    "confirmation_token"
  ]
}

{
  "type": "object",
  "properties": {
    "case_code": {
      "type": "string"
    },
    "status": {
      "type": "string"
    },
    "active": {
      "type": "boolean"
    },
    "channel": {
      "type": "string",
      "enum": [
        "whatsapp",
        "chat"
      ]
    },
    "checkout_url": {
      "type": "string"
    },
    "case_url": {
      "type": "string"
    }
  },
  "required": [
    "case_code",
    "status",
    "active",
    "channel",
    "case_url"
  ]
}

Returns the status of an SOS Flights case by its case code: whether it is active, the team's recommended solution once there is one, the last 10 chat messages for chat cases, and the case page link.

{
  "type": "object",
  "properties": {
    "case_code": {
      "description": "8-character case code from the payment confirmation or case page, for example 53039309.",
      "type": "string",
      "pattern": "^[A-Za-z0-9]{8}$"
    },
    "lang": {
      "description": "Language of the case page link. Defaults to en.",
      "type": "string",
      "enum": [
        "en",
        "sk",
        "cs",
        "de",
        "pl",
        "hu"
      ]
    }
  },
  "required": [
    "case_code"
  ]
}

{
  "type": "object",
  "properties": {
    "case_code": {
      "type": "string"
    },
    "status": {
      "type": "string"
    },
    "active": {
      "type": "boolean"
    },
    "channel": {
      "type": "string",
      "enum": [
        "whatsapp",
        "chat"
      ]
    },
    "recommended_solution": {
      "type": "string"
    },
    "messages": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "from": {
            "type": "string",
            "enum": [
              "traveller",
              "team"
            ]
          },
          "at": {
            "type": "string"
          },
          "text": {
            "type": "string"
          }
        },
        "required": [
          "from",
          "at",
          "text"
        ]
      }
    },
    "case_url": {
      "type": "string"
    }
  },
  "required": [
    "case_code",
    "status",
    "active",
    "channel",
    "messages",
    "case_url"
  ]
}

Checks a message from the traveller to the SOS Flights team on an active chat case and returns it with a confirmation_token valid for 15 minutes. Nothing is sent. WhatsApp cases continue in WhatsApp.

{
  "type": "object",
  "properties": {
    "message": {
      "description": "The traveller's message to the team, in their own words.",
      "type": "string",
      "minLength": 1,
      "maxLength": 2000
    },
    "case_code": {
      "description": "8-character case code from the payment confirmation or case page.",
      "type": "string",
      "pattern": "^[A-Za-z0-9]{8}$"
    }
  },
  "required": [
    "message",
    "case_code"
  ]
}

{
  "type": "object",
  "properties": {
    "case_code": {
      "type": "string"
    },
    "message": {
      "type": "string"
    },
    "confirmation_token": {
      "type": "string"
    },
    "expires_at": {
      "type": "string"
    }
  },
  "required": [
    "case_code",
    "message",
    "confirmation_token",
    "expires_at"
  ]
}

Sends the message prepared with a confirmation_token to the SOS Flights team, after the traveller confirmed it. The team's reply appears in the case status and on the case page.

{
  "type": "object",
  "properties": {
    "confirmation_token": {
      "description": "confirmation_token from the prepare step, for example sc_3qJ8vT0kPzL1mW6xR2aYbQ. Valid for 15 minutes.",
      "type": "string",
      "minLength": 10,
      "maxLength": 64
    },
    "idempotency_key": {
      "description": "Key that makes a retry safe: a repeated key returns the first result. Defaults to one key per confirmation_token.",
      "type": "string",
      "minLength": 8,
      "maxLength": 100
    }
  },
  "required": [
    "confirmation_token"
  ]
}

{
  "type": "object",
  "properties": {
    "case_code": {
      "type": "string"
    },
    "sent": {
      "type": "boolean"
    }
  },
  "required": [
    "case_code",
    "sent"
  ]
}