Air API (v2)

Download OpenAPI description
Languages
Servers
Staging URL
https://apis.spotnana.com/
Spotnana mock server
https://developer.spotnana.com/_mock/openapi/airapi/

Air

APIs to perform search, checkout and book an air pnr

Operations

Get Special Service Requests (SSR) for a Category

Request

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.

Query
categorystringrequired

The category type of a Special Service Request (SSR).

Enum"BASSINET""SPECIAL_ASSISTANCE_WHEELCHAIR""BAGGAGE""UNACCOMPANIED_MINOR""PETS""MEET_AND_ASSIST""OTHERS""MEAL""SPECIAL_ASSISTANCE_DISABILITY"
Example: category=SPECIAL_ASSISTANCE_WHEELCHAIR
curl -i -X GET \
  'https://apis.spotnana.com/v2/air/special-service-requests/categories?category=SPECIAL_ASSISTANCE_WHEELCHAIR' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

OK

Bodyapplication/json
specialServiceRequestsArray of objects(SpecialServiceRequest)
Response
application/json
{ "specialServiceRequests": [ {} ] }

Returns the Air Raw Fare Rules for a Segment or Pnr

Request

Bodyapplication/jsonrequired
searchIdstring

The unique ID (identifying the current workflow) returned by the backend in the air search results response (AirSearchResponse.searchId) of the previous leg. If set, the rateOptionId and userId must also be specified.

rateOptionIdstring

The unique ID identifying the selected flights in the previous leg's response.

pnrIdstring

The unique Spotnana PNR ID against which flights are booked.

Example: "1213124111"
userIdstring(uuid)

Unique ID of the user.

Example: "4974a66b-7493-4f41-908c-58ba81093947"
curl -i -X POST \
  https://apis.spotnana.com/v2/air/fare-rules/fetch \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "searchId": "string",
    "rateOptionId": "string",
    "pnrId": "1213124111",
    "userId": "4974a66b-7493-4f41-908c-58ba81093947"
  }'

Responses

OK

Bodyapplication/json
legRuleInfosArray of objects(LegRuleInfo)
Response
application/json
{ "legRuleInfos": [ {} ] }

Get unused credits for a traveler

Request

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.

Bodyapplication/jsonrequired
travelerInfoAirRequestTravelerInfo (object) or AirRequestTravelerInfo (object)(AirRequestTravelerInfo)required
One of:

Traveler information to get userOrgId.

travelerInfo.​userIdobject(UserId)

User identifier

curl -i -X POST \
  https://apis.spotnana.com/v3/air/fetch-traveler-unused-credits \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "travelerInfo": {
      "userId": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
      }
    }
  }'

Responses

OK

Bodyapplication/json
unusedCreditInfoArray of objects(UnusedCreditInfo)
Response
application/json
{ "unusedCreditInfo": [ {} ] }

Loyalty Programs

Operations