> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anysite.io/llms.txt
> Use this file to discover all available pages before exploring further.

# /skyscanner/flights/prices/bands

> Get the historical price distribution (price bands) for a flight route between two places by entity id for a given date, cabin class and trip type. Returns the typical price spread — low (20th percentile), median and high (80th percentile) price points plus the lower and upper outlier bounds, all in the market currency, along with the season the aggregation covers. Use it to judge whether a live fare is cheap or expensive versus what this route normally costs. For round trips also pass a return date. Origin and destination are Skyscanner place entity ids (resolve them via the places autosuggest).

**Price:** 1 credit

**⚠️ Common errors:** 412: No price-band history available for the given route, date and cabin combination



## OpenAPI

````yaml /openapi/travel-hospitality.json post /api/skyscanner/flights/prices/bands
openapi: 3.1.0
info:
  title: Any Site API
  description: >+
    Any Site API provides programmatic access to data from LinkedIn, Instagram,
    Twitter, and other platforms.


    ## Authentication


    All API endpoints require an `access-token` header with a valid API token.
    Tokens can be created in the [dashboard](https://app.anysite.io/).


    ## Pricing


    Each endpoint has a credit cost listed in its description. Credits are
    deducted from your token balance per request.

  version: 0.0.1
servers: []
security:
  - AccessToken: []
paths:
  /api/skyscanner/flights/prices/bands:
    post:
      tags:
        - /skyscanner
      summary: /skyscanner/flights/prices/bands
      description: >-
        Get the historical price distribution (price bands) for a flight route
        between two places by entity id for a given date, cabin class and trip
        type. Returns the typical price spread — low (20th percentile), median
        and high (80th percentile) price points plus the lower and upper outlier
        bounds, all in the market currency, along with the season the
        aggregation covers. Use it to judge whether a live fare is cheap or
        expensive versus what this route normally costs. For round trips also
        pass a return date. Origin and destination are Skyscanner place entity
        ids (resolve them via the places autosuggest).


        **Price:** 1 credit


        **⚠️ Common errors:** 412: No price-band history available for the given
        route, date and cabin combination
      operationId: __api_skyscanner_flights_prices_bands_post
      parameters:
        - name: access-token
          in: header
          required: true
          schema:
            anyOf:
              - type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SkyscannerFlightsPricesBandsPayload'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SkyscannerPriceBand'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    SkyscannerFlightsPricesBandsPayload:
      properties:
        timeout:
          type: integer
          maximum: 1500
          minimum: 20
          default: 300
        origin:
          type: string
          pattern: ^\d+$
        destination:
          type: string
          pattern: ^\d+$
        depart_date:
          type: string
          format: date
        return_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
        cabin_class:
          $ref: '#/components/schemas/SkyscannerCabinClass'
          default: ECONOMY
      type: object
      required:
        - origin
        - destination
        - depart_date
    SkyscannerPriceBand:
      properties:
        '@type':
          type: string
          default: SkyscannerPriceBand
        vertical:
          anyOf:
            - type: string
            - type: 'null'
        currency:
          anyOf:
            - type: string
            - type: 'null'
        season:
          anyOf:
            - type: string
            - type: 'null'
        percentile_low:
          anyOf:
            - type: integer
            - type: 'null'
        percentile_high:
          anyOf:
            - type: integer
            - type: 'null'
        outlier_low:
          anyOf:
            - type: number
            - type: 'null'
        low:
          anyOf:
            - type: number
            - type: 'null'
        median:
          anyOf:
            - type: number
            - type: 'null'
        high:
          anyOf:
            - type: number
            - type: 'null'
        outlier_high:
          anyOf:
            - type: number
            - type: 'null'
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
      type: object
    SkyscannerCabinClass:
      type: string
      enum:
        - ECONOMY
        - PREMIUM_ECONOMY
        - BUSINESS
        - FIRST
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
        msg:
          type: string
        type:
          type: string
        input: {}
        ctx:
          type: object
      type: object
      required:
        - loc
        - msg
        - type
  securitySchemes:
    AccessToken:
      type: apiKey
      in: header
      name: access-token
      description: API token from the dashboard

````