flightpowers-com Flights API

openapi: 3.2.0
info:
  title: Flightpowers Com Flights API
  version: '1.0'
  description: 'Operations tagged Flights across 2 of this provider''s published API definitions: flightpowers-com-api-openapi.json, flightpowers-com-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.flightpowers.com
  description: Production. The RapidAPI hosts (google-flights-live-api.p.rapidapi.com, booking-live-api.p.rapidapi.com) serve the same engines with RapidAPI-native paths; this host is the canonical REST front.
tags:
- name: Flights
paths:
  /v1/flights/oneway:
    post:
      summary: 'Flights: oneway'
      operationId: v1_flights_oneway_v1_flights_oneway_post
      parameters:
      - name: _path
        in: query
        required: false
        schema:
          type: string
          default: /v1/flights/oneway
          title: ' Path'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                title: Response V1 Flights Oneway V1 Flights Oneway Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                max_stops:
                  type: integer
                  description: 'Convenience alias: sets max_departure_stops and max_return_stops (round trip) or the outbound limit (one way); explicit per-leg fields take precedence; rewrites are reported in the X-Field-Aliased response header.'
      tags:
      - Flights
  /v1/flights/roundtrip:
    post:
      summary: 'Flights: roundtrip'
      operationId: v1_flights_roundtrip_v1_flights_roundtrip_post
      parameters:
      - name: _path
        in: query
        required: false
        schema:
          type: string
          default: /v1/flights/roundtrip
          title: ' Path'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                title: Response V1 Flights Roundtrip V1 Flights Roundtrip Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                max_stops:
                  type: integer
                  description: 'Convenience alias: sets max_departure_stops and max_return_stops (round trip) or the outbound limit (one way); explicit per-leg fields take precedence; rewrites are reported in the X-Field-Aliased response header.'
      tags:
      - Flights
components:
  schemas:
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    RoundtripRequest:
      type: object
      required:
      - from_airport
      - to_airport
      - departure_date
      - return_date
      properties:
        from_airport:
          type: string
          description: Origin IATA code.
          examples:
          - JFK
        to_airport:
          type: string
          description: Destination IATA code.
          examples:
          - LHR
        departure_date:
          type: string
          format: date
          description: Outbound date, YYYY-MM-DD.
        return_date:
          type: string
          format: date
          description: Return date, YYYY-MM-DD.
        max_departure_stops:
          type: integer
          description: Max stops on the outbound leg.
        max_return_stops:
          type: integer
          description: Max stops on the return leg.
        departure_airline_codes:
          type: array
          items:
            type: string
          description: Only these airlines on the outbound leg.
        return_airline_codes:
          type: array
          items:
            type: string
          description: Only these airlines on the return leg.
        departure_exclude_airline_codes:
          type: array
          items:
            type: string
          description: Exclude these airlines on the outbound leg.
        return_exclude_airline_codes:
          type: array
          items:
            type: string
          description: Exclude these airlines on the return leg.
        departure_departure_time_min:
          type: integer
          minimum: 0
          maximum: 23
          description: 'Outbound leg: earliest departure hour.'
        departure_departure_time_max:
          type: integer
          minimum: 0
          maximum: 23
          description: 'Outbound leg: latest departure hour.'
        departure_arrival_time_min:
          type: integer
          minimum: 0
          maximum: 23
          description: 'Outbound leg: earliest arrival hour.'
        departure_arrival_time_max:
          type: integer
          minimum: 0
          maximum: 23
          description: 'Outbound leg: latest arrival hour.'
        return_departure_time_min:
          type: integer
          minimum: 0
          maximum: 23
          description: 'Return leg: earliest departure hour.'
        return_departure_time_max:
          type: integer
          minimum: 0
          maximum: 23
          description: 'Return leg: latest departure hour.'
        return_arrival_time_min:
          type: integer
          minimum: 0
          maximum: 23
          description: 'Return leg: earliest arrival hour.'
        return_arrival_time_max:
          type: integer
          minimum: 0
          maximum: 23
          description: 'Return leg: latest arrival hour.'
        sort_type:
          type: string
          enum:
          - Overall
          - Price
          - Duration
          default: Overall
          description: Result ordering.
        currency:
          type: string
          default: USD
          description: ISO currency code for prices, e.g. `USD`, `EUR`.
        max_price:
          type: integer
          description: Only return itineraries at or below this price.
        seat_type:
          type: integer
          enum:
          - 1
          - 2
          - 3
          - 4
          description: 'Cabin: 1 = Economy, 2 = Premium economy, 3 = Business, 4 = First.'
        passengers:
          type: array
          items:
            type: integer
            enum:
            - 1
            - 2
            - 3
            - 4
          description: 'One integer per passenger: 1 = adult, 2 = child, 3 = infant on lap, 4 = infant in seat. Default: one adult.'
        limit:
          type: integer
          default: 10
          description: Maximum number of results to return.
        returns_per_outbound:
          type: integer
          minimum: 1
          maximum: 5
          default: 2
          description: 'How many return flights to pair with each outbound flight, 1 to 5. Defaults to 2. The paired itineraries are ranked together and `limit` still caps how many come back. `limit` also sets how many outbound flights are searched (one return lookup each), so a higher `limit` is slower. With the default `limit`, 5 means the 10 results are the best of up to 50 pairings instead of 20. Not applied to results that come from the fallback source (`X-Search-Fallback: used` without `X-Search-Notes: upstream_no_render`). Must be a whole number from 1 to 5 (null is rejected).'
        use_fallback:
          type: boolean
          description: 'A secondary flight-data source the API can escalate to when the live Google Flights search does not come back with results. Last resort, not part of the normal path: a search that succeeds never touches it. Send `false` to switch the escalation off for a request. Responses that do use it can take longer.'
        strict:
          type: boolean
          default: false
          description: Opt-in. Return HTTP 503 with a `search_incomplete` error body instead of an empty array when the search did not complete (X-Search-Status `degraded`).
        use_ext_proxy:
          type: boolean
          default: true
          description: When true, requests may be routed through an external residential proxy to reduce blocks from Google. Set false to force a direct request (lower latency, more block risk).
    OnewayRequest:
      type: object
      required:
      - from_airport
      - to_airport
      - departure_date
      properties:
        from_airport:
          type: string
          description: Origin IATA code, e.g. `JFK`.
          examples:
          - JFK
        to_airport:
          type: string
          description: Destination IATA code, e.g. `LHR`.
          examples:
          - LHR
        departure_date:
          type: string
          format: date
          description: YYYY-MM-DD.
          examples:
          - '2027-04-15'
        max_stops:
          type: integer
          description: Maximum stops, e.g. 0 for non-stop only.
        airline_codes:
          type: array
          items:
            type: string
          description: Only include these airlines (IATA codes).
        exclude_airline_codes:
          type: array
          items:
            type: string
          description: Exclude these airlines (IATA codes).
        departure_time_min:
          type: integer
          minimum: 0
          maximum: 23
          description: Earliest departure hour (0-23).
        departure_time_max:
          type: integer
          minimum: 0
          maximum: 23
          description: Latest departure hour (0-23).
        departure_arrival_time_min:
          type: integer
          minimum: 0
          maximum: 23
          description: Earliest arrival hour (0-23).
        departure_arrival_time_max:
          type: integer
          minimum: 0
          maximum: 23
          description: Latest arrival hour (0-23).
        sort_type:
          type: string
          enum:
          - Overall
          - Price
          - Duration
          default: Overall
          description: Result ordering.
        currency:
          type: string
          default: USD
          description: ISO currency code for prices, e.g. `USD`, `EUR`.
        max_price:
          type: integer
          description: Only return itineraries at or below this price.
        seat_type:
          type: integer
          enum:
          - 1
          - 2
          - 3
          - 4
          description: 'Cabin: 1 = Economy, 2 = Premium economy, 3 = Business, 4 = First.'
        passengers:
          type: array
          items:
            type: integer
            enum:
            - 1
            - 2
            - 3
            - 4
          description: 'One integer per passenger: 1 = adult, 2 = child, 3 = infant on lap, 4 = infant in seat. Default: one adult.'
        limit:
          type: integer
          default: 10
          description: Maximum number of results to return.
        use_fallback:
          type: boolean
          description: 'A secondary flight-data source the API can escalate to when the live Google Flights search does not come back with results. Last resort, not part of the normal path: a search that succeeds never touches it. Send `false` to switch the escalation off for a request. Responses that do use it can take longer.'
        strict:
          type: boolean
          default: false
          description: Opt-in. Return HTTP 503 with a `search_incomplete` error body instead of an empty array when the search did not complete (X-Search-Status `degraded`).
        use_ext_proxy:
          type: boolean
          default: true
          description: When true, requests may be routed through an external residential proxy to reduce blocks from Google. Set false to force a direct request (lower latency, more block risk).
    RoundtripItinerary:
      type: object
      description: 'One PAIRED round-trip itinerary: outbound and return legs priced together, the way Google actually sells them - not two stapled one-way searches.'
      properties:
        price_range_in_relation_to_other_periods:
          type:
          - string
          - 'null'
          enum:
          - low
          - typical
          - high
          - null
          description: Google's verdict on this fare vs the route's historical range. The field rival Google Flights APIs generally do not return.
        price_insights_low:
          type:
          - number
          - 'null'
          description: Bottom of Google's historical price range for this route and dates.
        price_insights_high:
          type:
          - number
          - 'null'
          description: Top of Google's historical price range for this route and dates.
        from_airport:
          type: string
        to_airport:
          type: string
        departure_date:
          type: string
          format: date
        return_date:
          type: string
          format: date
        total_price:
          type: string
          description: Display price for the whole trip.
        total_price_as_number:
          type: number
        total_duration_seconds:
          type: integer
        total_stops:
          type: integer
        buy_link:
          type: string
          format: uri
        departure_flight_departure_description:
          type: string
        departure_flight_arrival_description:
          type: string
        departure_flight_airline:
          type: string
        departure_flight_stops:
          type: integer
        departure_flight_duration:
          type: string
        return_flight_departure_description:
          type: string
        return_flight_arrival_description:
          type: string
        return_flight_airline:
          type: string
        return_flight_stops:
          type: integer
        return_flight_duration:
          type: string
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            type:
              type: string
              description: e.g. `missing_api_key`, `invalid_api_key`, `invalid_request`, `search_incomplete`.
            reason:
              type: string
              description: Present on `search_incomplete`, e.g. `blocked_page`.
            message:
              type: string
    OnewayFlight:
      type: object
      description: 'One itinerary from a one-way search. Flat JSON: no nested envelopes to unwrap.'
      properties:
        price_range_in_relation_to_other_periods:
          type:
          - string
          - 'null'
          enum:
          - low
          - typical
          - high
          - null
          description: Google's verdict on this fare vs the route's historical range. The field rival Google Flights APIs generally do not return.
        price_insights_low:
          type:
          - number
          - 'null'
          description: Bottom of Google's historical price range for this route and dates.
        price_insights_high:
          type:
          - number
          - 'null'
          description: Top of Google's historical price range for this route and dates.
        from_airport:
          type: string
        to_airport:
          type: string
        departure_date:
          type: string
          format: date
        price:
          type: string
          description: Display price, e.g. `$433`.
        price_as_number:
          type: number
          description: Numeric price for sorting and comparison.
        duration:
          type: string
          description: Human-readable duration.
        duration_seconds:
          type: integer
        buy_link:
          type: string
          format: uri
          description: Deep link to book this exact itinerary on Google Flights.
        airline:
          type: string
        stops:
          type: integer
        stops_info:
          type: array
          items:
            type: object
            properties:
              stop_airport:
                type: string
              stop_duration_seconds:
                type: integer
        departure_description:
          type: string
          description: e.g. `8:35 PM on Thu, Oct 15`.
        arrival_description:
          type: string
  securitySchemes:
    ApiKeyHeader:
      type: apiKey
      in: header
      name: x-api-key
      description: Your RapidAPI key. The default for Zapier-style custom auth.
    RapidApiKeyHeader:
      type: apiKey
      in: header
      name: x-rapidapi-key
      description: Your RapidAPI key, in the header RapidAPI users already have in hand.
    BearerAuth:
      type: http
      scheme: bearer
      description: '`Authorization: Bearer <RapidAPI key>`. `?api_key=` in the query string also works but is discouraged: keys in URLs end up in logs and history.'
externalDocs:
  description: Human docs with captured example responses
  url: https://flightpowers.com/flights-api
x-refined-from:
- flightpowers-com-api-openapi.json
- flightpowers-com-openapi.json