Decolar

A list of cities IATA code to which the assistant suggest to travel. Must be an empty array or a list of minimum 2 IATAs.

The month number in which the user intends to travel (if known).

IATA code of the origin city. Omit if the user did not specify an origin — the server will infer it from the user's location when available.

The range of budget the user is willing to spend.

The range of days the user intends to stay (if known. Example: 3-5, 7-7, 10-15 ; if not known or the user is open to any airline set as null.).

List of 1 to 7 destinations to compare. Each item has destination (IATA) and destination_name.

Optional month number (1-12) the user intends to travel

Origin city IATA code. Omit if the user did not specify an origin — the server will infer it from the user's location when available.

Number of adult passengers (1-8). Default is 1. Do NOT ask the user for this — if they did not mention passengers, assume 1 adult and call the tool immediately.

IATA code of the destination city (e.g., 'MAD', 'PUJ'). Always resolve it yourself from whatever the user said — city name, country, or landmark.

Two-letter IATA airline code to filter results by a specific carrier. Resolve it yourself from whatever name the user mentioned — never ask the user for the code. Use this mapping for the most common airlines: Aerolíneas Argentinas → AR | LATAM → LA | LATAM Argentina → 4M | LATAM Brasil → JJ | LATAM Chile → LA | LATAM Colombia → 4C | LATAM Peru → LP | LATAM Ecuador → XL | Flybondi → FO | JetSMART → JA | JetSMART Chile → WJ | JetSMART Peru → JZ | Gol → G3 | Azul → AD | Azul Conecta → 2F | VOEPASS → 2Z | Passaredo → 2Z | MAP Linhas Aéreas → 7M | Copa → CM | Avianca → AV | Arajet → DM | Aeromexico → AM | Volaris → Y4 | Viva Aerobus → VB | Interjet → 4O | Sky Airline → H2 | Paranair → ZP | Boliviana de Aviacion → OB | Iberia → IB | Iberia Express → I2 | Vueling → VY | Air Europa → UX | British Airways → BA | Ryanair → FR | EasyJet → U2 | Wizz Air → W6 | Lufthansa → LH | Swiss → LX | Austrian → OS | Brussels Airlines → SN | Air France → AF | KLM → KL | TAP → TP | Alitalia / ITA Airways → AZ | Turkish Airlines → TK | Finnair → AY | Eurowings → EW | American Airlines → AA | United → UA | Delta → DL | Southwest → WN | JetBlue → B6 | Spirit → NK | Frontier → F9 | Alaska Airlines → AS | Emirates → EK | Qatar Airways → QR | Etihad → EY | Turkish → TK | Air Arabia → G9 | Flydubai → FZ | Singapore Airlines → SQ | Cathay Pacific → CX | Japan Airlines → JL | ANA → NH | Korean Air → KE | Air China → CA | China Southern → CZ | China Eastern → MU | Thai Airways → TG | Malaysia Airlines → MH | Qantas → QF | Air Canada → AC | Air New Zealand → NZ | South African Airways → SA | Ethiopian Airlines → ET | For any airline not listed above, use your general aviation knowledge to resolve the IATA code. If you genuinely cannot resolve it, omit the field and do not ask the user. Pass null only to explicitly clear a previously active airline filter.

Outbound arrival time window in 'HH:MM-HH:MM' format (24h). Minimum range of 2 hours. 'que llegue antes del mediodía' → '00:00-12:00'. 'que llegue a la noche' → '18:00-23:59'. Omit if the user did not mention an arrival time preference.

Baggage filter. 'con valija', 'equipaje despachado incluido' → 'checked'. 'solo mochila', 'hand luggage', 'equipaje de mano' → 'carry_on'. Omit if the user did not mention baggage requirements.

Currency code for displayed prices (e.g., 'USD', 'ARS', 'EUR'). 'en dólares', 'quiero ver en USD' → 'USD'. 'en pesos' → 'ARS'. Omit if the user did not mention a preferred currency.

Price range filter with budget type. budget_type meanings: 'STAY' = total price for the whole trip, 'DAY' = price per day, 'CLEAR' = remove any active filter. 'menos de 500 dólares' → { max: 500, budget_type: 'STAY' }. 'entre 200 y 400' → { min: 200, max: 400, budget_type: 'STAY' }. 'hasta 50 dólares por día' → { max: 50, budget_type: 'DAY' }. Omit if the user did not mention a budget or price limit.

Cabin class preference. 'económica', 'turista', 'la más barata' → 'economy'. 'business', 'ejecutiva' → 'business'. 'primera clase' → 'firstclass'. 'premium economy' → 'premium_economy'. Omit if the user did not mention a cabin preference.

Departure date in YYYY-MM-DD format. Set this ONLY when the user gave an exact date or a specific day. If the user gave only a month + stay range (e.g. 'agosto, entre 7 y 10 días'), do NOT set this field — use month + stay_range instead (flexible search mode). If the user gave only a month with no stay info, use the 1st of that month here AND always compute return_date by adding the stay duration (see return_date rules).

Outbound departure time window in 'HH:MM-HH:MM' format (24h). Minimum range of 2 hours. 'que salga a la mañana' → '06:00-12:00'. 'que salga a la tarde' → '12:00-18:00'. 'que salga a la noche' → '18:00-23:59'. 'que salga entre las 10 y las 14' → '10:00-14:00'. Omit if the user did not mention a departure time preference.

Trip type. Default is always 'ROUNDTRIP' — use it unless the user explicitly requests a one-way flight. 'solo ida', 'sin vuelta', 'one way', 'só ida', 'somente ida' → 'ONEWAY'. Any other case, including when no return_date is provided → 'ROUNDTRIP'. Never infer ONEWAY from the absence of a return date.

Maximum number of flight options to return (1-50). Default 20. Use when the user asks for a specific number (e.g. "mostrame 12 vuelos").

Array of individual ages for each minor passenger (0-17). Build this array from whatever the user said: '2 kids' with no ages → do NOT include this field, ask for their ages first. 'a 5 year old and a 10 year old' → [5, 10]. 'a baby' → [0]. '3 children aged 4, 7 and 12' → [4, 7, 12]. Never infer ages — if the user mentioned minors but gave no ages, ask only for the ages before calling the tool.

Month number (1-12) for flexible date searches. 'en agosto' → 8. 'para las vacaciones de julio' → 7. Use in combination with stay_range for flexible search mode. Omit if the user provided exact departure_date and return_date.

Sort order for results. Infer from user intent: 'el más barato', 'ordenar por precio' → 'total_price_ascending'. 'el más rápido', 'menos tiempo de viaje' → 'duration_ascending'. 'el que sale más temprano' → 'departure_ascending'. 'el que llega más temprano' → 'arrival_ascending'. 'menos escalas' → 'stopscount_ascending'. 'por aerolínea' → 'airline_ascending'. Omit if the user did not express a sorting preference.

IATA code of the origin city (e.g., 'BUE', 'MIA'). Resolve it yourself from the city or country name the user mentioned. Omit this field entirely if the user did not specify an origin — the server will infer it from the user's location when available.

Return date in YYYY-MM-DD format. Do NOT set this field in flexible search mode (when month + stay_range are used). Required for ROUNDTRIP in exact search mode — always compute and include it. If the user gave an exact return date, use it. If the user gave a stay duration with an exact departure, compute: return_date = departure_date + stay days. If the user gave only a month with no stay duration and no return date: - Ask ONCE: '¿Cuántos días de estadía tenés en mente?' - If the user doesn't know or doesn't answer, default to 7 days: return_date = departure_date + 7. Never leave return_date empty in exact search mode on a ROUNDTRIP.

Return flight departure time window in 'HH:MM-HH:MM' format (24h). Minimum range of 2 hours. Same format and inference rules as departure_time_range but applied to the return leg. 'que la vuelta salga a la mañana' → '06:00-12:00'. Omit if the user did not mention a return departure time preference.

Range of stay duration in days, formatted as 'min-max'. 'entre 7 y 10 días' → '7-10'. 'exactamente una semana' → '7-7'. 'al menos 10 días' → '10-30'. Use this in flexible search mode together with month (no departure_date, no return_date). Omit if the user specified exact departure and return dates.

Maximum number of stopovers. 0 = direct flights only, 1 = up to 1 stopover. 'solo directos', 'sin escalas', 'vuelo directo' → 0. 'hasta una escala', 'con escala está bien' → 1. Omit if the user did not mention any preference.