{"openapi":"3.1.0","info":{"title":"Overbook Rights API","version":"0.1.0","description":"A fully local airline overbooking/denied-boarding ('bumping') passenger-rights reference and calculator: US DOT 14 CFR Part 250 tiers, EU261 Article 4/7 denied-boarding compensation, and Canada's APPR bumping tiers, hand-curated and web-verified against each regulator's own text. General information, not legal advice.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://overbookrights.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/overbookrights/docs"},"termsOfService":"https://connectorbay.com/overbookrights/terms"},"servers":[{"url":"https://overbookrights.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/overbookrights/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/us_denied_boarding_compensation":{"post":{"operationId":"us_denied_boarding_compensation","summary":"US 14 CFR 250.5 denied-boarding compensation: 200%/400% of fare capped at $1,075/$2,150, by domestic","description":"US 14 CFR 250.5 denied-boarding compensation: 200%/400% of fare capped at $1,075/$2,150, by domestic\n    (1-2h/2h+) or international (1-4h/4h+) arrival delay. Use for \"I was bumped from a domestic flight and\n    arrived 3 hours late, how much am I owed\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"delay_hours":{"description":"How many hours later than scheduled you actually arrived at your final destination.","minimum":0,"title":"Delay Hours","type":"number"},"is_domestic":{"default":true,"description":"Whether this is a domestic US flight (vs international).","title":"Is Domestic","type":"boolean"},"fare_usd":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Your one-way fare to your next stopover or final destination, if you want the exact fare-based amount rather than just the cap.","title":"Fare Usd"}},"required":["delay_hours"],"title":"us_denied_boarding_compensationArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/us_denied_boarding_exceptions_check":{"post":{"operationId":"us_denied_boarding_exceptions_check","summary":"Checks the standard 14 CFR Part 250 exceptions where no US denied-boarding compensation is owed. Use for","description":"Checks the standard 14 CFR Part 250 exceptions where no US denied-boarding compensation is owed. Use for\n    \"does a 19-seat plane bumping have to pay compensation\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"aircraft_seats":{"description":"Certificated seating capacity of the aircraft.","minimum":0,"title":"Aircraft Seats","type":"integer"},"arrived_within_one_hour":{"default":false,"description":"Whether the alternate transportation arranged arrives within 1 hour of your original scheduled arrival.","title":"Arrived Within One Hour","type":"boolean"},"missed_checkin_deadline":{"default":false,"description":"Whether you missed the airline's check-in/ticketing/reconfirmation deadline.","title":"Missed Checkin Deadline","type":"boolean"},"safety_substitution":{"default":false,"description":"Whether a smaller aircraft was substituted for safety/operational reasons.","title":"Safety Substitution","type":"boolean"}},"required":["aircraft_seats"],"title":"us_denied_boarding_exceptions_checkArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/us_cash_vs_voucher":{"post":{"operationId":"us_cash_vs_voucher","summary":"Your US right to demand cash/check instead of a travel voucher, plus the refund of ancillary fees (seat","description":"Your US right to demand cash/check instead of a travel voucher, plus the refund of ancillary fees (seat\n    selection, checked bags) for a service you didn't receive. Use for \"can the airline force me to take a\n    voucher instead of cash\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"us_cash_vs_voucherArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/eu261_denied_boarding_compensation":{"post":{"operationId":"eu261_denied_boarding_compensation","summary":"EU261 (EU/UK) denied-boarding compensation: EUR250/400/600 by distance via Article 7, with NO","description":"EU261 (EU/UK) denied-boarding compensation: EUR250/400/600 by distance via Article 7, with NO\n    extraordinary-circumstances exemption (unlike delay/cancellation) since overbooking is always the airline's\n    own commercial choice. A volunteer instead negotiates their own benefits. Use for \"I was involuntarily bumped\n    from a 2000km EU flight, what am I owed\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"distance_km":{"description":"Great-circle flight distance in kilometres.","minimum":0,"title":"Distance Km","type":"number"},"volunteered":{"default":false,"description":"Whether you volunteered to give up your seat (vs being bumped involuntarily).","title":"Volunteered","type":"boolean"}},"required":["distance_km"],"title":"eu261_denied_boarding_compensationArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/eu261_volunteer_and_care_rights":{"post":{"operationId":"eu261_volunteer_and_care_rights","summary":"EU261's duty to seek volunteers before bumping anyone involuntarily, the refund-or-reroute choice, and","description":"EU261's duty to seek volunteers before bumping anyone involuntarily, the refund-or-reroute choice, and\n    Article 8/9 care and assistance (meals, calls, hotel) on top of any cash compensation. Use for \"what does the\n    airline owe me for food and a hotel if I'm bumped overnight in the EU\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"eu261_volunteer_and_care_rightsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/canada_bumping_compensation":{"post":{"operationId":"canada_bumping_compensation","summary":"Canada's APPR denied-boarding (bumping) compensation: a flat CAD900/1,800/2,400 by arrival-delay length","description":"Canada's APPR denied-boarding (bumping) compensation: a flat CAD900/1,800/2,400 by arrival-delay length\n    (under 6h / 6-9h / 9h+), regardless of airline size -- unlike APPR's delay-compensation tiers. Use for\n    \"WestJet bumped me and I arrived 7 hours late, how much do they owe\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"delay_hours":{"description":"How many hours later than your original ticketed time you actually arrived at your final destination.","minimum":0,"title":"Delay Hours","type":"number"}},"required":["delay_hours"],"title":"canada_bumping_compensationArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/jurisdiction_overview":{"post":{"operationId":"jurisdiction_overview","summary":"The full written summary of denied-boarding/overbooking passenger rights for one jurisdiction. Use for","description":"The full written summary of denied-boarding/overbooking passenger rights for one jurisdiction. Use for\n    \"explain Canada's bumping compensation rules\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"jurisdiction":{"description":"EU (covers UK), US, or Canada.","examples":["EU","US","Canada"],"title":"Jurisdiction","type":"string"}},"required":["jurisdiction"],"title":"jurisdiction_overviewArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/compare_jurisdictions":{"post":{"operationId":"compare_jurisdictions","summary":"A side-by-side headline comparison of US, EU/UK and Canada denied-boarding compensation. Use for \"how do","description":"A side-by-side headline comparison of US, EU/UK and Canada denied-boarding compensation. Use for \"how do\n    US and EU overbooking compensation rules differ\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"compare_jurisdictionsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/voluntary_vs_involuntary_explainer":{"post":{"operationId":"voluntary_vs_involuntary_explainer","summary":"Explains the difference between volunteering your seat (negotiated benefits, no fixed amount) and being","description":"Explains the difference between volunteering your seat (negotiated benefits, no fixed amount) and being\n    involuntarily denied boarding (fixed statutory compensation), and why all three jurisdictions require\n    airlines to ask for volunteers first. Use for \"should I volunteer to be bumped or wait to be told\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"voluntary_vs_involuntary_explainerArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/overbookrights_glossary":{"post":{"operationId":"overbookrights_glossary","summary":"Definitions of overbooking/denied-boarding terms -- overbooking, volunteer, involuntary denied boarding,","description":"Definitions of overbooking/denied-boarding terms -- overbooking, volunteer, involuntary denied boarding,\n    rerouting. Use for \"what does involuntary denied boarding mean\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific term to look up; omit to list all.","title":"Term"}},"title":"overbookrights_glossaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}