# Air APIs to perform search, checkout and book an air pnr ## Get air itineraries - [POST /v2/air/search-flights](https://developer.spotnana.com/openapi/airapi/air/airsearch.md): Get Air Itineraries available for the given search parameters ## Get flight attributes - [POST /v2/air/flight-attributes](https://developer.spotnana.com/openapi/airapi/air/airattributes.md): Get Flight attributes, amenities and fare rules for the given search response id. Returns the full air search response along with attribute details. ## Get selected itinerary - [POST /v2/air/selected-itinerary](https://developer.spotnana.com/openapi/airapi/air/airselecteditinerary.md): Get the selected itinerary for the traveler in the search and checkout flow. ## Get Airlines Information (Air) - [GET /v2/air/airlines-info](https://developer.spotnana.com/openapi/airapi/air/getairlinesinformation.md): Returns airlines information for active marked airlines. ## Get flight checkout details - [POST /v2/air/flight-checkout](https://developer.spotnana.com/openapi/airapi/air/airflightcheckout.md): Get the flight checkout details associated with the selected itinerary. ## Get flight seat map - [POST /v2/air/seat-map](https://developer.spotnana.com/openapi/airapi/air/airseatmap.md): Get seat map for the flights in the given itinerary. ## Initiate booking - [POST /v2/air/initiate-booking](https://developer.spotnana.com/openapi/airapi/air/airinitiatebooking.md): Initiates a new air booking for the trip. The identityDocs field supports the following traveler identity documents: Passport, National ID, Known Traveler Number (KTN), redress number, and immigration documents. The traveler can choose one among the list of identity documents available and provide its information during checkout. ## Validate air itinerary - [POST /v2/air/revalidate-itinerary](https://developer.spotnana.com/openapi/airapi/air/airrevalidateitinerary.md): Validates the air itinerary for availability and pricing ## Validate air itinerary (interim) - [POST /v2/air/intermediate-revalidate-itinerary](https://developer.spotnana.com/openapi/airapi/air/airintermediaterevalidateitinerary.md): Validates an itinerary at any interim stage of air booking workflow and allows you to keep track of fare details before proceeding to checkout. Using this endpoint is optional. It requires a searchId and the itineraryId to obtain the latest fare details of the selected itinerary. The travelerType field in this endpoint response currently only accepts ADULT, CHILD and INFANT. ## Create air pnr - [POST /v2/air/create-pnr](https://developer.spotnana.com/openapi/airapi/air/aircreatepnr.md): Creates a new air booking with the given itinerary ## Cancel Air Pnr - [POST /v2/air/cancel-pnr](https://developer.spotnana.com/openapi/airapi/air/aircancelpnr.md): Cancel the air pnr and issues applicable refunds ## Get PNR exchange details - [GET /v2/air/pnrs/{pnrId}/exchange-details](https://developer.spotnana.com/openapi/airapi/air/getairpnrexchangedetails.md): This endpoint gets exchange details of all the tickets present in the given PNR ID of the given trip ID. ## Modify Search - [POST /v2/air/modify-search](https://developer.spotnana.com/openapi/airapi/air/airmodifysearchv2.md): Get Air Itineraries available for exchange/modification/deletion against current pnr. ## Modify Book - [POST /v2/air/modify-book](https://developer.spotnana.com/openapi/airapi/air/airmodifybookv2.md): Book[cancel] new[existing] legs into an existing pnr using the selected rate option from airModifySearch operation. ## Edit PNR - [POST /v2/air/pnrs/{pnrId}/update](https://developer.spotnana.com/openapi/airapi/air/airpnredit.md): Edit specific traveler information in an existing PNR. This API allows you to edit and modify Special Service Requests (SSR), seat selection, loyalty number, ancillaries, redress number, Known Traveler Number (KTN), check-in preferences, and Other Service Information (OSI). ## Get Special Service Requests (SSR) - [GET /v2/air/special-service-requests](https://developer.spotnana.com/openapi/airapi/air/getspecialservicerequests.md): Returns the list of all Special Service Requests (SSR) supported by Spotnana. This API doesn't require a request payload or a query parameter. You can use this endpoint anytime during the air booking or exchange workflow to view the list of SSRs currently supported by Spotnana. ## Get Special Service Requests (SSR) for a Category - [GET /v2/air/special-service-requests/categories](https://developer.spotnana.com/openapi/airapi/air/getspecialservicerequestsfilterbycategory.md): Returns the list of Special Service Requests (SSR) for a selected category. Every category type can contain multiple service requests. For example, the category: MEAL includes service requests such as a vegetarian meal, baby/infant meal, gluten free meal, and so on. These service requests are displayed as subCategory fields within the category: MEAL. To learn more about a selected category such as its subCategory values, category code, and other relevant information, run this API using the category type as the query parameter. ## Returns the Air Raw Fare Rules for a Segment or Pnr - [POST /v2/air/fare-rules/fetch](https://developer.spotnana.com/openapi/airapi/air/fetchairfarerules.md) ## Get unused credits for a traveler - [POST /v3/air/fetch-traveler-unused-credits](https://developer.spotnana.com/openapi/airapi/air/fetchtravelerunusedcredits.md): Returns a list of unused credits associated with a traveler along with details such as the PNR ID, trip ID, airline details, credit expiry date, and the source of booking (e.g., NDC). Travelers can redeem unused credit for future bookings with the same airline where the credit was earned. ## Get unused credits for a company - [POST /v3/air/company-unused-credits/list](https://developer.spotnana.com/openapi/airapi/air/fetchcompanyunusedcredits.md): Returns the list of company unused credits which can be used by any employees of the company. ## Get transferable unused credits for a company - [POST /v3/air/company-transferable-unused-credits/list](https://developer.spotnana.com/openapi/airapi/air/fetchcompanytransferableunusedcredits.md): Returns the list of transferable company unused credits which can be used by any employees of the company. The unused credits can be transferred to another traveler. ## Migrate Unused Credits of a traveler to and fro Company Credits - [POST /v3/air/company-credits/migrations](https://developer.spotnana.com/openapi/airapi/air/migrateunusedcreditsincompanycredits.md): This API will be migrate unused credits from individual credits to company credits and vice versa.