# 123milhas Flight Search

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/123milhas/flight` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/123milhas-flight |

## Description

Search 123milhas discount flights by route and date and get BRL fares, miles costs, loyalty programs, schedules, and baggage details as structured JSON in real time.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/123milhas/flight' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Round-trip GRU to SSA

```json
{
  "search_info": {
    "origin": "GRU",
    "destination": "SSA",
    "return_date": "2026-09-17",
    "total_results": 22,
    "departure_date": "2026-09-10"
  },
  "return_flights": [
    {
      "id": "123m-fl-ssa-gru-20260917-001",
      "stops": 0,
      "segments": [
        {
          "airline": "Gol Linhas Aéreas",
          "airline_code": "G3",
          "arrival_time": "2026-09-17T21:15:00",
          "flight_number": "G3 1384",
          "departure_time": "2026-09-17T19:20:00",
          "arrival_airport": "GRU",
          "duration_minutes": 115,
          "departure_airport": "SSA"
        }
      ],
      "price_brl": 512.3,
      "taxes_brl": 98.4,
      "booking_url": "https://www.123milhas.com/passagens/salvador-sao-paulo/2026-09-17/null/1-0-0/economy?flt=123m-fl-ssa-gru-20260917-001",
      "cabin_class": "economy",
      "price_miles": 12000,
      "loyalty_program": "Smiles",
      "seats_available": 7,
      "baggage_included": false,
      "duration_minutes": 115
    }
  ],
  "outbound_flights": [
    {
      "id": "123m-fl-gru-ssa-20260910-001",
      "stops": 0,
      "segments": [
        {
          "airline": "Gol Linhas Aéreas",
          "airline_code": "G3",
          "arrival_time": "2026-09-10T08:05:00",
          "flight_number": "G3 1381",
          "departure_time": "2026-09-10T06:15:00",
          "arrival_airport": "SSA",
          "duration_minutes": 110,
          "departure_airport": "GRU"
        }
      ],
      "price_brl": 487.9,
      "taxes_brl": 98.4,
      "booking_url": "https://www.123milhas.com/passagens/sao-paulo-salvador/2026-09-10/2026-09-17/1-0-0/economy?flt=123m-fl-gru-ssa-20260910-001",
      "cabin_class": "economy",
      "price_miles": 12000,
      "loyalty_program": "Smiles",
      "seats_available": 4,
      "baggage_included": false,
      "duration_minutes": 110
    },
    {
      "id": "123m-fl-gru-ssa-20260910-002",
      "stops": 1,
      "segments": [
        {
          "airline": "LATAM Airlines",
          "airline_code": "LA",
          "arrival_time": "2026-09-10T09:45:00",
          "flight_number": "LA 3712",
          "departure_time": "2026-09-10T08:30:00",
          "arrival_airport": "SDU",
          "duration_minutes": 75,
          "departure_airport": "GRU"
        },
        {
          "airline": "LATAM Airlines",
          "airline_code": "LA",
          "arrival_time": "2026-09-10T12:35:00",
          "flight_number": "LA 3891",
          "departure_time": "2026-09-10T11:00:00",
          "arrival_airport": "SSA",
          "duration_minutes": 95,
          "departure_airport": "SDU"
        }
      ],
      "price_brl": 399,
      "taxes_brl": 98.4,
      "booking_url": "https://www.123milhas.com/passagens/sao-paulo-salvador/2026-09-10/2026-09-17/1-0-0/economy?flt=123m-fl-gru-ssa-20260910-002",
      "cabin_class": "economy",
      "price_miles": 8500,
      "loyalty_program": "LATAM Pass",
      "seats_available": 9,
      "baggage_included": true,
      "duration_minutes": 245
    }
  ]
}
```

## Documentation

## Overview

123milhas is Brazil's leading platform for discount airfares, specializing in miles-based pricing through Smiles, LATAM Pass, and TudoAzul. The platform applies Cloudflare protection. Piloterr handles the bypass and returns outbound and return flight results as structured JSON.

Each itinerary includes airline, flight number, times, stops, BRL fare, miles cost, loyalty program, taxes, and baggage status.

## Quickstart

```
GET https://api.piloterr.com/v2/123milhas/flight?origin=GRU&destination=SSA&departure_date=2026-09-10
```

## Main use cases

- Collect real-time 123milhas fares for domestic Brazilian routes to build price alert systems
- Track BRL-to-miles exchange rates by comparing cash and miles fares across airlines and dates
- Monitor seat availability to detect fare tier expirations and feed urgency signals to travel apps
- Build a miles valuation calculator aggregating cash and miles fares across loyalty programs
- Benchmark 123milhas airfare against other OTAs for the same route to quantify the discount gap