// docs

Smiles: Search flights

Extracts ticket offers from Smiles by route, dates and passengers, with miles, values in reais, fees, flight numbers, companies per connection and baggage entered in the search.

smiles.com.br:plp · 5 credits per request

Standard credit cost. Your account pricing is shown in the sandbox.

Try this operation in the sandbox

Source-specific limitations

Some requests can take up to 1 minute to respond. This is expected for this operation; wait for the request to complete.

HTTP request

cURL

curl -X POST https://api.geckoapi.com.br/v1/extract \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "target": "smiles.com.br",
  "type": "plp",
  "from": "GRU",
  "to": "GIG",
  "departureDate": "2026-11-09",
  "returnDate": "2026-11-16",
  "numAdults": 1,
  "numChildren": 0,
  "numInfants": 0
}'

Keep your API key on your server. See the quickstart for authentication and response handling.

MCP request

The hosted MCP tool fixes target and type for this operation. Its remaining arguments use the same input rules as Extract.

POST /v1/mcp · Bearer or X-API-Key authentication

smiles_com_br_plp · tools/call

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "smiles_com_br_plp",
    "arguments": {
      "from": "GRU",
      "to": "GIG",
      "departureDate": "2026-11-09",
      "returnDate": "2026-11-16",
      "numAdults": 1,
      "numChildren": 0,
      "numInfants": 0,
      "executionId": "exec_example_123"
    }
  }
}

Supported inputs

Conditional fields depend on the alternatives and constraints in the rule column. Fields marked unsupported are omitted.

Field	Type	Requirement	Rule	Default	Example
from Code IATA of the airport of origin for searching PLP of Decolar, GOL, Azul, LATAM, Trip.com, KAYAK, MaxMilhas and 123Milhas.	string (IATA 3 letters)	Required	Code IATA of the airport of origin with letters 3 (ex: GRU).	-	GRU
to Destination airport code IATA for search PLP of Decolar, GOL, Azul, LATAM, Trip.com, KAYAK, MaxMilhas and 123Milhas.	string (IATA 3 letters)	Required	Destination airport code IATA with letters 3 (ex: GIG).	-	GIG
departureDate Departure date for searching PLP from ClickBus, Decolar, GOL, Azul, LATAM, Trip.com, KAYAK, MaxMilhas and 123Milhas.	string (YYYY-MM-DD)	Required	Departure date in YYYY-MM-DD format.	-	2026-11-09
returnDate Optional return date for PLP search of ClickBus, Decolar, GOL, Azul, LATAM, Trip.com, KAYAK, MaxMilhas, and 123Milhas.	string (YYYY-MM-DD)	Optional	Return date in YYYY-MM-DD format. Must be greater than or equal to departureDate. When omitted, the search is one-way.	-	2026-11-16
target Target source for extraction.	enum	Required	Always required and must be smiles.com.br.	-	smiles.com.br
type Extraction type: pdp, idp, plp, ilp, quote, review or places.	enum	Required	Always required and must be plp.	-	plp
numAdults Quantity of adults for Booking, Airbnb, Hoteis.com, Trivago, Decolar, GOL, Azul, LATAM and Trip.com.	integer (1-30)	Optional	Number of adults. Must be an integer between 1 and 9.	1	1
numChildren Number of children for Booking, Hoteis.com, Trivago, Decolar, GOL, Azul, LATAM and Trip.com.	integer (0-30)	Optional	Number of children. Must be an integer between 0 and 9.	0	0
numInfants Number of babies for GOL, Azul, LATAM and Trip.com PLP. It must be less than or equal to the number of adults.	integer (0-9)	Optional	Number of babies in arms. Must be an integer between 0 and 9 and less than or equal to numAdults.	0	0

Request examples

Search Smiles - round trip

Round-trip search on Smiles with origin, destination, dates and passengers.

Search Smiles - round trip

{
  "target": "smiles.com.br",
  "type": "plp",
  "from": "GRU",
  "to": "GIG",
  "departureDate": "2026-11-09",
  "returnDate": "2026-11-16",
  "numAdults": 1,
  "numChildren": 0,
  "numInfants": 0
}

Search Smiles - one way

One-way search informing only departureDate.

Search Smiles - one way

{
  "target": "smiles.com.br",
  "type": "plp",
  "from": "CGH",
  "to": "SDU",
  "departureDate": "2026-11-20",
  "numAdults": 2,
  "numChildren": 0,
  "numInfants": 0
}

Response schema

Leaf paths and expected types. Field names and enum values are part of the API contract.

responseSchema

{
  "requestId": "string (uuid)",
  "executionId": "string (uuid)",
  "data.source": "string",
  "data.type": "string",
  "data.parser": "\"1.0.0\"",
  "data.url": "string",
  "data.requestUrl": "string",
  "data.extractedAt": "string (iso datetime)",
  "data.searchType": "string (ONE_WAY | ROUND_TRIP)",
  "data.from": "string",
  "data.to": "string",
  "data.departureDate": "string (YYYY-MM-DD)",
  "data.returnDate": "string | null",
  "data.numAdults": "number",
  "data.numChildren": "number",
  "data.numInfants": "number",
  "data.cabin": "string",
  "data.runtimeEnv": "string",
  "data.totalOffers": "number",
  "data.listedOffers": "number",
  "data.cheapestOffer.position": "number",
  "data.cheapestOffer.uid": "string | null",
  "data.cheapestOffer.pricingUid": "string | null",
  "data.cheapestOffer.fareType": "string | null",
  "data.cheapestOffer.airline": "string | null",
  "data.cheapestOffer.cabin": "string | null",
  "data.cheapestOffer.stops": "number | string | null",
  "data.cheapestOffer.sourceGDS": "string | null",
  "data.cheapestOffer.departureAirport": "string | null",
  "data.cheapestOffer.departureTime": "string | null",
  "data.cheapestOffer.arrivalAirport": "string | null",
  "data.cheapestOffer.arrivalTime": "string | null",
  "data.cheapestOffer.priceHint": "number | null",
  "data.cheapestOffer.fareOptions[].fareType": "string | null",
  "data.cheapestOffer.fareOptions[].miles": "number | string | null",
  "data.cheapestOffer.fareOptions[].money": "number | string | null",
  "data.cheapestOffer.fareOptions[].costTax": "number | string | null",
  "data.offers[].position": "number",
  "data.offers[].uid": "string | null",
  "data.offers[].pricingUid": "string | null",
  "data.offers[].fareType": "string | null",
  "data.offers[].airline": "string | null",
  "data.offers[].cabin": "string | null",
  "data.offers[].stops": "number | string | null",
  "data.offers[].sourceGDS": "string | null",
  "data.offers[].departureAirport": "string | null",
  "data.offers[].departureTime": "string | null",
  "data.offers[].arrivalAirport": "string | null",
  "data.offers[].arrivalTime": "string | null",
  "data.offers[].priceHint": "number | null",
  "data.offers[].fareOptions[].fareType": "string | null",
  "data.offers[].fareOptions[].miles": "number | string | null",
  "data.offers[].fareOptions[].money": "number | string | null",
  "data.offers[].fareOptions[].costTax": "number | string | null",
  "data.cheapestOffer.flightNumbers": "string[]",
  "data.cheapestOffer.legs": "array",
  "data.cheapestOffer.legs[].flightNumber": "string | null",
  "data.cheapestOffer.legs[].marketingAirline": "string | null",
  "data.cheapestOffer.legs[].operatingAirline": "string | null",
  "data.cheapestOffer.legs[].cabin": "string | null",
  "data.cheapestOffer.legs[].departureAirport": "string | null",
  "data.cheapestOffer.legs[].departureTime": "string | null",
  "data.cheapestOffer.legs[].arrivalAirport": "string | null",
  "data.cheapestOffer.legs[].arrivalTime": "string | null",
  "data.cheapestOffer.baggage": "object | null",
  "data.cheapestOffer.baggage.free": "boolean | null",
  "data.cheapestOffer.baggage.quantity": "number | null",
  "data.cheapestOffer.fareOptions[].uid": "string | null",
  "data.cheapestOffer.fareOptions[].productClass": "string | null",
  "data.cheapestOffer.fareOptions[].classOfService": "string | null",
  "data.offers[].flightNumbers": "string[]",
  "data.offers[].legs": "array",
  "data.offers[].legs[].flightNumber": "string | null",
  "data.offers[].legs[].marketingAirline": "string | null",
  "data.offers[].legs[].operatingAirline": "string | null",
  "data.offers[].legs[].cabin": "string | null",
  "data.offers[].legs[].departureAirport": "string | null",
  "data.offers[].legs[].departureTime": "string | null",
  "data.offers[].legs[].arrivalAirport": "string | null",
  "data.offers[].legs[].arrivalTime": "string | null",
  "data.offers[].baggage": "object | null",
  "data.offers[].baggage.free": "boolean | null",
  "data.offers[].baggage.quantity": "number | null",
  "data.offers[].fareOptions[].uid": "string | null",
  "data.offers[].fareOptions[].productClass": "string | null",
  "data.offers[].fareOptions[].classOfService": "string | null"
}

Example response

Illustrative response. Product names, reviews and other source content retain their original language. Missing and null values do not imply zero stock, free shipping or zero reviews.

responseExample

{
  "requestId": "99999999-1111-4111-8111-999999999999",
  "executionId": "99999999-2222-4222-8222-999999999999",
  "data": {
    "source": "smiles.com.br",
    "type": "plp",
    "parser": "1.0.0",
    "url": "https://www.smiles.com.br/passagens-aereas?from=GRU&to=GIG&departureDate=2026-11-09&returnDate=2026-11-16&numAdults=1&numChildren=0&numInfants=0&cabin=ALL",
    "requestUrl": "https://www.smiles.com.br/passagens-aereas?from=GRU&to=GIG&departureDate=2026-11-09&returnDate=2026-11-16&numAdults=1&numChildren=0&numInfants=0&cabin=ALL",
    "extractedAt": "2026-10-11T15:00:00.000Z",
    "searchType": "ROUND_TRIP",
    "from": "GRU",
    "to": "GIG",
    "departureDate": "2026-11-09",
    "returnDate": "2026-11-16",
    "numAdults": 1,
    "numChildren": 0,
    "numInfants": 0,
    "cabin": "ALL",
    "runtimeEnv": "green",
    "totalOffers": 2,
    "listedOffers": 2,
    "cheapestOffer": {
      "position": 1,
      "uid": "flight-uid-1",
      "pricingUid": "pricing-uid-1",
      "fareType": "SEGMENT_1",
      "airline": "G3",
      "cabin": "ECONOMIC",
      "stops": 0,
      "sourceGDS": "G3",
      "departureAirport": "GRU",
      "departureTime": "2026-11-09T09:00:00",
      "arrivalAirport": "GIG",
      "arrivalTime": "2026-11-09T10:10:00",
      "priceHint": 12500,
      "fareOptions": [
        {
          "uid": "fare-uid-1",
          "fareType": "SMILES_CLUB",
          "miles": 12500,
          "money": 0,
          "costTax": 39.9,
          "productClass": "PROMO",
          "classOfService": "U"
        }
      ],
      "flightNumbers": [
        "1001"
      ],
      "legs": [
        {
          "flightNumber": "1001",
          "marketingAirline": "G3",
          "operatingAirline": "G3",
          "cabin": "ECONOMIC",
          "departureAirport": "GRU",
          "departureTime": "2026-11-09T09:00:00",
          "arrivalAirport": "GIG",
          "arrivalTime": "2026-11-09T10:10:00"
        }
      ],
      "baggage": {
        "free": false,
        "quantity": 0
      }
    },
    "offers": [
      {
        "position": 1,
        "uid": "flight-uid-1",
        "pricingUid": "pricing-uid-1",
        "fareType": "SEGMENT_1",
        "airline": "G3",
        "cabin": "ECONOMIC",
        "stops": 0,
        "sourceGDS": "G3",
        "departureAirport": "GRU",
        "departureTime": "2026-11-09T09:00:00",
        "arrivalAirport": "GIG",
        "arrivalTime": "2026-11-09T10:10:00",
        "priceHint": 12500,
        "fareOptions": [
          {
            "uid": "fare-uid-1",
            "fareType": "SMILES_CLUB",
            "miles": 12500,
            "money": 0,
            "costTax": 39.9,
            "productClass": "PROMO",
            "classOfService": "U"
          }
        ],
        "flightNumbers": [
          "1001"
        ],
        "legs": [
          {
            "flightNumber": "1001",
            "marketingAirline": "G3",
            "operatingAirline": "G3",
            "cabin": "ECONOMIC",
            "departureAirport": "GRU",
            "departureTime": "2026-11-09T09:00:00",
            "arrivalAirport": "GIG",
            "arrivalTime": "2026-11-09T10:10:00"
          }
        ],
        "baggage": {
          "free": false,
          "quantity": 0
        }
      },
      {
        "position": 2,
        "uid": "flight-uid-2",
        "pricingUid": "pricing-uid-2",
        "fareType": "SEGMENT_1",
        "airline": "G3",
        "cabin": "ECONOMIC",
        "stops": 1,
        "sourceGDS": "G3",
        "departureAirport": "GRU",
        "departureTime": "2026-11-09T13:20:00",
        "arrivalAirport": "GIG",
        "arrivalTime": "2026-11-09T16:05:00",
        "priceHint": 15800,
        "fareOptions": [
          {
            "uid": "fare-uid-2",
            "fareType": "SMILES",
            "miles": 15800,
            "money": 0,
            "costTax": 39.9,
            "productClass": "LIGHT",
            "classOfService": "X"
          }
        ],
        "flightNumbers": [
          "1201",
          "1202"
        ],
        "legs": [
          {
            "flightNumber": "1201",
            "marketingAirline": "G3",
            "operatingAirline": "G3",
            "cabin": "ECONOMIC",
            "departureAirport": "GRU",
            "departureTime": "2026-11-09T13:20:00",
            "arrivalAirport": "CNF",
            "arrivalTime": "2026-11-09T14:30:00"
          },
          {
            "flightNumber": "1202",
            "marketingAirline": "G3",
            "operatingAirline": "G3",
            "cabin": "ECONOMIC",
            "departureAirport": "CNF",
            "departureTime": "2026-11-09T14:55:00",
            "arrivalAirport": "GIG",
            "arrivalTime": "2026-11-09T16:05:00"
          }
        ],
        "baggage": {
          "free": true,
          "quantity": 1
        }
      }
    ]
  }
}

Complete field reference

Path	Type	Description	Example
data.cabin	string	Cab sent to endpoint Smiles.	ALL
data.cheapestOffer.airline	string \| null	Airline or GDS associated with the offer.	G3
data.cheapestOffer.arrivalAirport	string \| null	Arrival airport.	GIG
data.cheapestOffer.arrivalTime	string \| null	Arrival date/time.	2026-11-09T10:10:00
data.cheapestOffer.baggage	object \| null	Checked baggage allowance entered in the search for the offer; null when missing. It is not a validation per fare option or per passenger: the chosen fare and personal benefits may change the deductible. Weight, dimensions, carry-on baggage and complete rules are not returned.	{"free":false,"quantity":0}
data.cheapestOffer.baggage.free	boolean \| null	Free baggage indication provided by Smiles. false explicitly indicates non-free baggage in the offer; null means unknown. Does not include validation of personal Club/category benefits.	false
data.cheapestOffer.baggage.quantity	number \| null	Number of checked baggage volumes entered for the offer. Zero is an explicit quantity; null means missing or unknown. Does not represent weight in kg.	0
data.cheapestOffer.cabin	string \| null	Cabin associated with the offer.	ECONOMIC
data.cheapestOffer.departureAirport	string \| null	Departure airport.	GRU
data.cheapestOffer.departureTime	string \| null	Departure date/time.	2026-11-09T09:00:00
data.cheapestOffer.fareOptions[].classOfService	string \| null	Reservation class when informed. It does not replace the full fare rules.	U
data.cheapestOffer.fareOptions[].costTax	number \| string \| null	Additional fee in reais (BRL), separate from money, when informed. null means unknown rate, not zero. Does not guarantee all issuance charges, especially in partner companies; confirm the total in Smiles.	39.9
data.cheapestOffer.fareOptions[].fareType	string \| null	Tariff type, such as SMILES, SMILES_CLUB, SMILES_MONEY, SMILES_MONEY_CLUB or MONEY. Club/category rates depend on eligibility at issue; API does not authenticate the Smiles account.	SMILES_CLUB
data.cheapestOffer.fareOptions[].miles	number \| string \| null	Number of miles for the option, per passenger and segment of the offer; is not the total of the reservation. Children and babies can have specific conditions.	12500
data.cheapestOffer.fareOptions[].money	number \| string \| null	Fare component in reais (BRL), not in cents. When there are miles, it is the cash portion of Smiles & Money. Does not include costTax; add the two known fields to estimate the money component. It is not the total of the reservation.	0
data.cheapestOffer.fareOptions[].productClass	string \| null	Tariff product code when informed. Does not replace full baggage, change or cancellation rules.	PROMO
data.cheapestOffer.fareOptions[].uid	string \| null	Tariff option identifier returned by Smiles.	fare-uid-1
data.cheapestOffer.fareType	string \| null	Type of offer/snippet returned by Smiles, such as SEGMENT_1 or SEGMENT_2. For payment modality and eligibility, read fareOptions[].fareType.	SEGMENT_1
data.cheapestOffer.flightNumbers	string[]	Flight numbers, without company prefix, in leg order. Empty array when not informed; use legs to associate each number with the company and connection.	["1001"]
data.cheapestOffer.legs	array	Flights that make up the offer itinerary, in the order returned by Smiles. Empty array when not informed.	[{"flightNumber":"1001","marketingAirline":"G3","operatingAirline":"G3","cabin":"ECONOMIC","departureAirport":"GRU","departureTime":"2026-11-09T09:00:00","arrivalAirport":"GIG","arrivalTime":"2026-11-09T10:10:00"}]
data.cheapestOffer.legs[].arrivalAirport	string \| null	Code IATA for the arrival airport of this flight.	GIG
data.cheapestOffer.legs[].arrivalTime	string \| null	Arrival date/time of this flight, as returned by Smiles. Do not assume UTC when there is no offset.	2026-11-09T10:10:00
data.cheapestOffer.legs[].cabin	string \| null	Cabin for this flight, when informed.	ECONOMIC
data.cheapestOffer.legs[].departureAirport	string \| null	Code IATA for the departure airport of this flight.	GRU
data.cheapestOffer.legs[].departureTime	string \| null	Departure date/time of this flight, as returned by Smiles. Do not assume UTC when there is no offset.	2026-11-09T09:00:00
data.cheapestOffer.legs[].flightNumber	string \| null	Flight number without company prefix. Preserves leading zeros when received; null when not informed.	1001
data.cheapestOffer.legs[].marketingAirline	string \| null	Code of the company that sells this flight. It may differ from the codeshare operator.	G3
data.cheapestOffer.legs[].operatingAirline	string \| null	Code of the company operating this flight, when informed by Smiles.	G3
data.cheapestOffer.position	number	Position of the cheapest offer in the standard set.	1
data.cheapestOffer.priceHint	number \| null	Numerical indicator used to order offers in miles. It does not represent total cost in reais and does not add up to money or costTax.	12500
data.cheapestOffer.pricingUid	string \| null	Offer pricing identifier.	pricing-uid-1
data.cheapestOffer.sourceGDS	string \| null	Source GDS returned by upstream.	G3
data.cheapestOffer.stops	number \| string \| null	Number of scales when available.	0
data.cheapestOffer.uid	string \| null	Flight/offer identifier when returned by Smiles.	flight-uid-1
data.departureDate	string (YYYY-MM-DD)	Departure date used in the search.	2026-11-09
data.extractedAt	string (iso datetime)	Date and time the response was normalized.	2026-10-11T15:00:00.000Z
data.from	string	Origin code IATA.	GRU
data.listedOffers	number	Number of offers included in array offers.	2
data.numAdults	number	Number of adults sent to the search. Option prices are not multiplied by the number of passengers by API.	1
data.numChildren	number	Number of children.	0
data.numInfants	number	Number of babies in arms.	0
data.offers[].airline	string \| null	Airline or GDS associated with the offer.	G3
data.offers[].arrivalAirport	string \| null	Arrival airport.	GIG
data.offers[].arrivalTime	string \| null	Arrival date/time.	2026-11-09T10:10:00
data.offers[].baggage	object \| null	Checked baggage allowance entered in the search for the offer; null when missing. It is not a validation per fare option or per passenger: the chosen fare and personal benefits may change the deductible. Weight, dimensions, carry-on baggage and complete rules are not returned.	{"free":false,"quantity":0}
data.offers[].baggage.free	boolean \| null	Free baggage indication provided by Smiles. false explicitly indicates non-free baggage in the offer; null means unknown. Does not include validation of personal Club/category benefits.	false
data.offers[].baggage.quantity	number \| null	Number of checked baggage volumes entered for the offer. Zero is an explicit quantity; null means missing or unknown. Does not represent weight in kg.	0
data.offers[].cabin	string \| null	Cabin associated with the offer.	ECONOMIC
data.offers[].departureAirport	string \| null	Departure airport.	GRU
data.offers[].departureTime	string \| null	Departure date/time.	2026-11-09T09:00:00
data.offers[].fareOptions[].classOfService	string \| null	Reservation class when informed. It does not replace the full fare rules.	U
data.offers[].fareOptions[].costTax	number \| string \| null	Additional fee in reais (BRL), separate from money, when informed. null means unknown rate, not zero. Does not guarantee all issuance charges, especially in partner companies; confirm the total in Smiles.	39.9
data.offers[].fareOptions[].fareType	string \| null	Tariff type, such as SMILES, SMILES_CLUB, SMILES_MONEY, SMILES_MONEY_CLUB or MONEY. Club/category rates depend on eligibility at issue; API does not authenticate the Smiles account.	SMILES_CLUB
data.offers[].fareOptions[].miles	number \| string \| null	Number of miles for the option, per passenger and segment of the offer; is not the total of the reservation. Children and babies can have specific conditions.	12500
data.offers[].fareOptions[].money	number \| string \| null	Fare component in reais (BRL), not in cents. When there are miles, it is the cash portion of Smiles & Money. Does not include costTax; add the two known fields to estimate the money component. It is not the total of the reservation.	0
data.offers[].fareOptions[].productClass	string \| null	Tariff product code when informed. Does not replace full baggage, change or cancellation rules.	PROMO
data.offers[].fareOptions[].uid	string \| null	Tariff option identifier returned by Smiles.	fare-uid-1
data.offers[].fareType	string \| null	Type of offer/snippet returned by Smiles, such as SEGMENT_1 or SEGMENT_2. For payment modality and eligibility, read fareOptions[].fareType.	SEGMENT_1
data.offers[].flightNumbers	string[]	Flight numbers, without company prefix, in leg order. Empty array when not informed; use legs to associate each number with the company and connection.	["1001"]
data.offers[].legs	array	Flights that make up the offer itinerary, in the order returned by Smiles. Empty array when not informed.	[{"flightNumber":"1001","marketingAirline":"G3","operatingAirline":"G3","cabin":"ECONOMIC","departureAirport":"GRU","departureTime":"2026-11-09T09:00:00","arrivalAirport":"GIG","arrivalTime":"2026-11-09T10:10:00"}]
data.offers[].legs[].arrivalAirport	string \| null	Code IATA for the arrival airport of this flight.	GIG
data.offers[].legs[].arrivalTime	string \| null	Arrival date/time of this flight, as returned by Smiles. Do not assume UTC when there is no offset.	2026-11-09T10:10:00
data.offers[].legs[].cabin	string \| null	Cabin for this flight, when informed.	ECONOMIC
data.offers[].legs[].departureAirport	string \| null	Code IATA for the departure airport of this flight.	GRU
data.offers[].legs[].departureTime	string \| null	Departure date/time of this flight, as returned by Smiles. Do not assume UTC when there is no offset.	2026-11-09T09:00:00
data.offers[].legs[].flightNumber	string \| null	Flight number without company prefix. Preserves leading zeros when received; null when not informed.	1001
data.offers[].legs[].marketingAirline	string \| null	Code of the company that sells this flight. It may differ from the codeshare operator.	G3
data.offers[].legs[].operatingAirline	string \| null	Code of the company operating this flight, when informed by Smiles.	G3
data.offers[].position	number	Position of the order in the standard array.	1
data.offers[].priceHint	number \| null	Numerical indicator used to order offers in miles. It does not represent total cost in reais and does not add up to money or costTax.	12500
data.offers[].pricingUid	string \| null	Offer pricing identifier.	pricing-uid-1
data.offers[].sourceGDS	string \| null	Source GDS returned by upstream.	G3
data.offers[].stops	number \| string \| null	Number of scales when available.	0
data.offers[].uid	string \| null	Flight/offer identifier when returned by Smiles.	flight-uid-1
data.parser	"1.0.0"	Stable version of the API response format.	1.0.0
data.requestUrl	string	Same value as `data.url`; never exposes the queried internal endpoint.	https://www.smiles.com.br/passagens-aereas?from=GRU&to=GIG&departureDate=2026-11-09&returnDate=2026-11-16&numAdults=1&numChildren=0&numInfants=0&cabin=ALL
data.returnDate	string \| null	Return date used in the search when entered.	2026-11-16
data.runtimeEnv	string	Environment Smiles resolved for the search.	green
data.searchType	string (ONE_WAY \| ROUND_TRIP)	Indicates one-way or round-trip only. Each offer belongs to a segment/itinerary; does not represent a package with the total round trip.	ROUND_TRIP
data.source	string	Source consulted.	smiles.com.br
data.to	string	Destination code IATA.	GIG
data.totalOffers	number	Quantity of standardized offers.	2
data.type	string	Extraction type.	plp
data.url	string	URL canonical created from the structured parameters.	https://www.smiles.com.br/passagens-aereas?from=GRU&to=GIG&departureDate=2026-11-09&returnDate=2026-11-16&numAdults=1&numChildren=0&numInfants=0&cabin=ALL
executionId	string (uuid)	Asynchronous execution identifier.	99999999-2222-4222-8222-999999999999
requestId	string (uuid)	Identifier of the extraction request.	99999999-1111-4111-8111-999999999999

Errors and missing data

When supported by this operation, an entity not found upstream can return HTTP 200 with data: null and notFound: true. Check the documented response fields before interpreting an empty result. Source-specific behavior and exceptions are described above.

HTTP status	Error code	Meaning
400	`INVALID_PAYLOAD`	Invalid JSON or a request that violates the documented validation rules.
401	`UNAUTHORIZED`	Missing authorization or an invalid API key or token.
402	`INSUFFICIENT_CREDITS`	The account has insufficient credits for this operation.
403	`FORBIDDEN`	The account does not have access, or the API is temporarily disabled.
409	`EXECUTION_CONFLICT`	The execution identifier conflicts with an incompatible execution state.
429	`RATE_LIMIT_EXCEEDED / TOO_MANY_INFLIGHT_REQUESTS`	A rate limit or simultaneous request limit was exceeded.
5xx	`UPSTREAM_TIMEOUT / UPSTREAM_HTTP_ERROR / WORKER_FUNCTION_ERROR`	An upstream, worker or gateway failure. Failed requests follow the platform refund policy.