---
title: "Route Search"
method: GET
path: "/starlink/route-search"
tags: ["starlink"]
---

# Route Search

`GET /starlink/route-search`

## Query parameters

- `origin` string, required — IATA code(s), comma-separated
- `destination` string, required — IATA code(s), comma-separated
- `date` string, date, required
- `cabin_class` 'economy' | 'premium_economy' | 'business' | 'first'
- `adults` integer
- `children` integer
- `max_stops` integer, nullable
- `max_results` integer

## Response `200`

Successful Response

- RouteSearchResponse
  - `results` RouteSearchResult[], required
    - `flight_card` FlightCardData, required — Flight card data for frontend - wraps Journey with card metadata. This is the serialization format sent to the frontend FlightCard component. It converts from the internal Journey model to the frontend contract.
      - `type` 'one-way' | 'round-trip' | 'multi-city', required
      - `journeys` ApiModelsFlightCardJourneyDisplay[], required
        - `direction` 'outbound' | 'return', nullable
        - `segments` SegmentDisplay[], required
          - `kind` 'flight'
          - `type` 'outbound' | 'return', nullable
          - `departure` ApiModelsFlightCardDepartureArrivalDisplay, required — Frontend format for departure/arrival points. `timezone` (IANA) and the coordinates come from the airport catalog when the journey endpoint itself has none, so a consumer can compute the offset crossed and the direction flown without its own airport table.
            - `time` string, date-time, required
            - `airport` string, required
            - `timezone` string, nullable
            - `latitude` number, nullable
            - `longitude` number, nullable
          - `arrival` ApiModelsFlightCardDepartureArrivalDisplay, required — Frontend format for departure/arrival points. `timezone` (IANA) and the coordinates come from the airport catalog when the journey endpoint itself has none, so a consumer can compute the offset crossed and the direction flown without its own airport table.
            - `time` string, date-time, required
            - `airport` string, required
            - `timezone` string, nullable
            - `latitude` number, nullable
            - `longitude` number, nullable
          - `length_in_minutes` integer, required
          - `flight_number` string, required
          - `airline` string, required
          - `airline_logo` string, nullable
          - `aircraft` string, nullable
          - `travel_class` string, nullable
          - `starlink_verdict` 'yes' | 'probably_yes' | 'probably_no' | 'no', nullable
          - `starlink_reasoning` string, nullable
        - `total_duration_in_minutes` integer, required
        - `departure_date` string, date-time, nullable
        - `arrival_date` string, date-time, nullable
      - `cash_details` ApiModelsFlightCardCashDisplay — Frontend format for cash pricing.
        - `type` 'cash'
        - `price` number, nullable
        - `currency` string
      - `cabin_class` string, nullable
      - `booking_links` BookingLink[], nullable
        - `link` string, required
        - `label` string, required
        - `price` number, nullable
        - `currency` string, nullable
        - `primary` boolean
        - `fare_name` string, nullable
        - `free_carry_on` integer, nullable
        - `free_checked_bags` integer, nullable
      - `adults` integer
      - `children` integer
      - `booking_token` string, nullable
      - `departure_token` string, nullable
      - `return_date` string, nullable
      - `__index` integer, required
      - `__tool_call_id` string, required
      - `message_id` string, nullable
      - `booking_links_status` string, nullable
      - `confirmation_number` string, nullable
      - `is_booked` boolean
      - `is_user_import` boolean
      - `user_edited` boolean
      - `award_details` object, nullable
    - `starlink_score` number, required
  - `origin` string, required
  - `destination` string, required
  - `date` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/stardrift/apis/fastapi.md) · [All operations](https://skmtc.dev/stardrift/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stardrift/fastapi/revisions/00746572572a/schema)