---
title: "Get Booking Links"
method: POST
path: "/api/fares/booking-links"
---

# Get Booking Links

`POST /api/fares/booking-links`

## Request

- Base URL: `https://ignav.com`
- URL: `https://ignav.com/api/fares/booking-links`
- Auth: API key in header `X-Api-Key`

Get booking links for a specific itinerary.

## Request body

- BookingLinksRequest
  - `ignav_id` string, nullable
  - `origin` string, nullable
  - `destination` string, nullable
  - `departure_date` string, date, nullable
  - `outbound_carrier_code` string, nullable
  - `outbound_flight_number` string, nullable
  - `return_date` string, date, nullable
  - `inbound_carrier_code` string, nullable
  - `inbound_flight_number` string, nullable
  - `adults` integer, nullable
  - `children` integer, nullable
  - `infants_in_seat` integer, nullable
  - `infants_on_lap` integer, nullable
  - `market` string, nullable

## Response `200`

Successful Response

- union
  - BookingOptionsResponseModel
    - `itinerary` BookingItineraryModel, required
      - `price` PriceModel, required
        - `amount` number, required
        - `currency` string, required
        - `status` 'verified' | 'unverified', required
      - `outbound` LegModel, required
        - `carrier` string, nullable
        - `duration_minutes` integer, nullable
        - `segments` SegmentModel[], required
          - `marketing_carrier_code` string, nullable, required
          - `flight_number` string, nullable, required
          - `operating_carrier_name` string, nullable, required
          - `departure_airport` string, required
          - `departure_time_local` string, required
          - `departure_timezone` string, nullable, required
          - `departure_time_utc` string, nullable, required
          - `arrival_airport` string, required
          - `arrival_time_local` string, required
          - `arrival_timezone` string, nullable, required
          - `arrival_time_utc` string, nullable, required
          - `duration_minutes` integer, required
          - `aircraft` string, nullable, required
      - `inbound` LegModel
        - `carrier` string, nullable
        - `duration_minutes` integer, nullable
        - `segments` SegmentModel[], required
          - `marketing_carrier_code` string, nullable, required
          - `flight_number` string, nullable, required
          - `operating_carrier_name` string, nullable, required
          - `departure_airport` string, required
          - `departure_time_local` string, required
          - `departure_timezone` string, nullable, required
          - `departure_time_utc` string, nullable, required
          - `arrival_airport` string, required
          - `arrival_time_local` string, required
          - `arrival_timezone` string, nullable, required
          - `arrival_time_utc` string, nullable, required
          - `duration_minutes` integer, required
          - `aircraft` string, nullable, required
      - `cabin_class` string, nullable
      - `bags` BaggageAllowanceModel
        - `carry_on` integer, nullable
        - `checked` integer, nullable
      - `requires_self_transfer` boolean, nullable
    - `booking_options` BookingOptionModel[], required
      - `legs` string[], required
      - `links` BookingLinkModel[], required
        - `provider_name` string, required
        - `provider_type` 'airline' | 'third_party', nullable
        - `specificity` 'exact_flight' | 'search_results', nullable
        - `fare_name` string, nullable
        - `price` PriceModel
          - `amount` number, required
          - `currency` string, required
          - `status` 'verified' | 'unverified', required
        - `url` string, required
  - SearchBookingOptionsResponseModel
    - `itinerary` SearchBookingItineraryModel, required
      - `price` PriceModel, required
        - `amount` number, required
        - `currency` string, required
        - `status` 'verified' | 'unverified', required
      - `legs` LegModel[], required
        - `carrier` string, nullable
        - `duration_minutes` integer, nullable
        - `segments` SegmentModel[], required
          - `marketing_carrier_code` string, nullable, required
          - `flight_number` string, nullable, required
          - `operating_carrier_name` string, nullable, required
          - `departure_airport` string, required
          - `departure_time_local` string, required
          - `departure_timezone` string, nullable, required
          - `departure_time_utc` string, nullable, required
          - `arrival_airport` string, required
          - `arrival_time_local` string, required
          - `arrival_timezone` string, nullable, required
          - `arrival_time_utc` string, nullable, required
          - `duration_minutes` integer, required
          - `aircraft` string, nullable, required
      - `cabin_class` string, nullable
      - `bags` BaggageAllowanceModel
        - `carry_on` integer, nullable
        - `checked` integer, nullable
      - `requires_self_transfer` boolean, nullable
    - `booking_options` SearchBookingOptionModel[], required
      - `leg_indexes` integer[], required
      - `links` BookingLinkModel[], required
        - `provider_name` string, required
        - `provider_type` 'airline' | 'third_party', nullable
        - `specificity` 'exact_flight' | 'search_results', nullable
        - `fare_name` string, nullable
        - `price` PriceModel
          - `amount` number, required
          - `currency` string, required
          - `status` 'verified' | 'unverified', required
        - `url` string, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `403`: Forbidden
- `404`: Not Found
- `424`: Failed Dependency
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/ignav/apis/ignav-public-api.md) · [All operations](https://skmtc.dev/ignav/apis/ignav-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ignav/apis/ignav-public-api/revisions/491502e0d169?raw)