Consultar histórico

Retorna dados históricos de preços de voos para uma rota específica.


GET /intelligence/flights/history

Headers

Header	Obrigatório	Valor
`x-api-key`	✅	Sua API key
`Accept`	Não	`application/vnd.economilha.v1+json`

Parâmetros de query

Parâmetro	Tipo	Obrigatório	Descrição
`origin`	`string`	✅	Código IATA de origem (ex: `GRU`). Aceita código de cidade (ex: `SAO`) — ver Códigos de cidade.
`destination`	`string`	✅	Código IATA de destino (ex: `MIA`). Aceita código de cidade (ex: `LON`).
`cabinType`	`enum`	✅	Tipo de cabine: `ECONOMY` ou `BUSINESS`.
`airlineLoyalty`	`enum`	✅	Programa de fidelidade — ver Programas. Pode ser repetido para consultar vários.
`lookbackDays`	`integer`	✅	Quantidade de dias para consultar o histórico (1–30).
`onlyFutureDepartures`	`boolean`	Não	Padrão `false`. Quando `true`, retorna apenas voos cuja data de partida ainda não ocorreu.
`departureDate`	`date`	Não	Filtra por data(s) de partida (`YYYY-MM-DD`, horário local do aeroporto). Pode ser repetido. Sem ele, todas as datas do período.

Para consultar mais de um programa na mesma chamada, repita o parâmetro:


?origin=SAO&destination=MIA&cabinType=ECONOMY&lookbackDays=30
&airlineLoyalty=SMILES&airlineLoyalty=AZUL&airlineLoyalty=LATAM

Response `200 OK`


{
  "total": 2,
  "lookbackDays": 7,
  "flights": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "airlineLoyalty": "SMILES_GOL",
      "departureDate": "2026-04-15T10:30:00",
      "arrivalDate": "2026-04-15T22:45:00",
      "cabinType": "ECONOMY",
      "concierge": null,
      "origin": "GRU",
      "destination": "MIA",
      "flightCode": "G3-8001",
      "tripType": "ONE_WAY",
      "roundTrip": "OUTBOUND",
      "fareType": "SMILES",
      "basePrice": 45000,
      "milesClubPrice": 38000,
      "availableSeats": 3,
      "createdAt": "2026-03-10T14:22:00Z",
      "fares": [
        {
          "fareType": "SMILES",
          "miles": 45000,
          "money": 0,
          "taxes": 0,
          "fees": 0,
          "totalMoney": 0,
          "productClass": null,
          "classOfService": null
        }
      ],
      "legs": [
        {
          "equipment": "789",
          "cabinType": "ECONOMY",
          "airlineCode": "AA",
          "arrivalDate": "2026-08-17T06:25:00",
          "flightNumber": "8190",
          "departureDate": "2026-08-16T23:00:00",
          "arrivalAirport": "MIA",
          "classOfService": "Y",
          "departureAirport": "GRU"
        }
      ]
    }
  ]
}

Campos da resposta

Campo	Tipo	Descrição
`total`	`integer`	Quantidade total de registros retornados
`lookbackDays`	`integer`	Quantidade de dias consultados
`flights`	`array`	Lista de registros de voos
`flights[].id`	`UUID`	Identificador único do registro
`flights[].airlineLoyalty`	`string`	Nome do programa de fidelidade da companhia
`flights[].departureDate`	`datetime`	Data/hora de partida
`flights[].arrivalDate`	`datetime`	Data/hora de chegada
`flights[].cabinType`	`string`	Tipo de cabine: `ECONOMY` ou `BUSINESS`
`flights[].concierge`	`string`	Informações de concierge (quando aplicável)
`flights[].origin`	`string`	Código IATA do aeroporto de origem
`flights[].destination`	`string`	Código IATA do aeroporto de destino
`flights[].flightCode`	`string`	Código do voo
`flights[].tripType`	`string`	`ONE_WAY` ou `ROUND_TRIP`
`flights[].roundTrip`	`string`	Direção do trecho: `OUTBOUND` ou `RETURN`
`flights[].fareType`	`string`	Família tarifária do preço base
`flights[].basePrice`	`integer`	Preço base em milhas (por passageiro)
`flights[].milesClubPrice`	`integer`	Preço clube em milhas (por passageiro)
`flights[].availableSeats`	`integer`	Assentos restantes na tarifa exibida
`flights[].createdAt`	`datetime`	Data/hora de criação do registro (UTC)
`flights[].fares`	`array`	Todas as tarifas retornadas (quando disponível)
`flights[].legs`	`array`	Detalhes das conexões do voo (quando disponível)

As datas de partida e chegada são gravadas no horário local do aeroporto. Não aplique conversão de fuso sobre esses valores. createdAt é a exceção: registra o momento da coleta em UTC.

Nem todo registro traz todos os campos: fares, legs, availableSeats, tripType e roundTrip dependem do que a companhia retornou no momento da coleta. Trate campos ausentes como opcionais na sua desserialização.

Consultar histórico

Headers

Parâmetros de query

Response 200 OK

Campos da resposta

Response `200 OK`