{"uid":"cap_S1jN47DcVOwksyRmOCW8u","slug":"stabletravel-dev-b587b3ba","name":"stabletravel.dev Google Flights Booking Options","description":"Get booking options for a specific flight. Requires a departure_token from a search result.","url":"https://stabletravel.dev/api/google-flights/booking?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["departure_id","arrival_id","outbound_date","type","adults","children","infants_in_seat","infants_on_lap","currency","hl","departure_token"],"properties":{"hl":{"type":"string","default":"en"},"type":{"enum":["1","2","3"],"type":"string","default":"1","description":"1 = Round trip, 2 = One way, 3 = Multi-city"},"adults":{"type":"integer","default":1,"maximum":9,"minimum":1},"children":{"type":"integer","default":0,"maximum":9,"minimum":0},"currency":{"type":"string","default":"USD","maxLength":3,"minLength":3},"arrival_id":{"type":"string"},"return_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"departure_id":{"type":"string"},"travel_class":{"enum":["1","2","3","4"],"type":"string","description":"1 = Economy, 2 = Premium economy, 3 = Business, 4 = First"},"outbound_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"infants_on_lap":{"type":"integer","default":0,"maximum":9,"minimum":0},"departure_token":{"type":"string","description":"Token from a search result to get booking options"},"infants_in_seat":{"type":"integer","default":0,"maximum":9,"minimum":0}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"price_insights":{"type":"object","properties":{"price_level":{"type":"string"},"lowest_price":{"type":"number"},"price_history":{"type":"array","items":{"type":"array","items":{"type":"number"}}},"typical_price_range":{"type":"array","items":{"type":"number"}}},"additionalProperties":false},"booking_options":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"price":{"type":"number"},"book_with":{"type":"string"},"extensions":{"type":"array","items":{"type":"string"}},"airline_logo":{"type":"string"},"local_prices":{"type":"array","items":{"type":"object","properties":{"price":{"type":"number"},"currency":{"type":"string"}},"additionalProperties":false}},"option_title":{"type":"string"},"baggage_prices":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"search_metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"selected_flights":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"price":{"type":"number"},"flights":{"type":"array","items":{"type":"object","properties":{"airline":{"type":"string"},"legroom":{"type":"string"},"airplane":{"type":"string"},"duration":{"type":"number"},"overnight":{"type":"boolean"},"extensions":{"type":"array","items":{"type":"string"}},"airline_logo":{"type":"string"},"travel_class":{"type":"string"},"flight_number":{"type":"string"},"arrival_airport":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"time":{"type":"string"}},"additionalProperties":false},"departure_airport":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"time":{"type":"string"}},"additionalProperties":false},"often_delayed_by_over_30_min":{"type":"boolean"}},"additionalProperties":false}},"layovers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"duration":{"type":"number"},"overnight":{"type":"boolean"}},"additionalProperties":false}},"extensions":{"type":"array","items":{"type":"string"}},"airline_logo":{"type":"string"},"total_duration":{"type":"number"},"departure_token":{"type":"string"},"carbon_emissions":{"type":"object","properties":{"this_flight":{"type":"number"},"difference_percent":{"type":"number"},"typical_for_this_route":{"type":"number"}},"additionalProperties":false}},"additionalProperties":false}},"search_parameters":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"additionalProperties":false}}}}},"responseSchema":{"type":"json","example":{"booking_options":[{"url":"https://www.aa.com/booking","price":350,"book_with":"American Airlines","option_title":"Book with American Airlines"}],"selected_flights":[{"price":350,"flights":[{"airline":"American","duration":360,"flight_number":"AA 100","arrival_airport":{"id":"LAX","name":"LAX","time":"2026-12-01 11:00"},"departure_airport":{"id":"JFK","name":"JFK","time":"2026-12-01 08:00"}}],"total_duration":360}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":1,"rating":{"score":"0.08","successRate":"0.33","reviews":1,"stars":"1.3","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_POPHTntHN1_Eoz-Fz9WIm","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_rvwfT6XC-pZuQEQ4E-Sky","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x20c000000000000000000000b9537d11c60e8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves booking options for a specific flight using a departure token obtained from a prior flight search result","exampleAgentPrompt":"I found a flight from JFK to LAX on May 20th for 2 adults in economy — I have the departure token from the search. Can you fetch all the booking options and price insights for it so I can see where to actually purchase the ticket?","exampleUseCases":null,"resultDescription":"Returns booking options including direct airline links and third-party booking URLs, price insights (price level, lowest price, typical price range, price history), and structured fare information for the selected flight itinerary","failureModes":["Invalid or expired departure_token returns empty booking options or error","Missing required parameters (departure_id, arrival_id, outbound_date) returns 400 validation error","departure_token from a different search context may yield no results","Round-trip type (type=1) without return_date may cause unexpected behavior","Invalid currency code (not 3-char ISO) returns validation error","Payment failure (x402) if USDC balance is insufficient"],"whenToPreferThis":"Use this endpoint after obtaining a departure_token from a flight search result when you need to retrieve specific booking URLs and price insights for a chosen itinerary. This is the second step in a two-step flight booking workflow — search first, then call this endpoint with the token to get actionable booking links.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":3,"lastUsedAt":"2026-05-18T19:27:54.631Z","lastSuccessfullyRanAt":"2026-05-18T19:27:54.631Z","lastHealthCheckAt":"2026-10-10T06:50:29.663Z","isFirstParty":false,"canonicalSlug":"stabletravel-dev-b587b3ba"}