Air API (v2)

Download OpenAPI description

AirApi.json

AirApi.yaml

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

Loyalty Programs

Operations

Get Loyalty Programs (Air)

Request

Returns all the active loyalty programs for the requested marketing and/or operating airlines.

Query

marketingAirlinestring

IATA code of the marketing airline for which the loyalty programs need to be fetched.

Example: marketingAirline=AA

operatingAirlinestring

IATA code of the operating airline for which the loyalty programs need to be fetched.

Example: operatingAirline=BA

travelerIdstring

User ID of the traveler.

Example: travelerId=4974a66b-7493-4f41-908c-58ba81093947

travelArrangerIdstring

User ID of the travel arranger.

Example: travelArrangerId=4974a66b-7493-4f41-908c-58ba81093947

curl -i -X GET \
  'https://apis.spotnana.com/v2/air/loyalty-programs?marketingAirline=AA&operatingAirline=BA&travelArrangerId=4974a66b-7493-4f41-908c-58ba81093947&travelerId=4974a66b-7493-4f41-908c-58ba81093947' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Bodyapplication/json

loyaltyProgramsArray of objects(AirLoyaltyProgram)required

loyaltyPrograms[].programNamestringrequired

Name of the loyalty program.

Example: "AA Advantage"

loyaltyPrograms[].airlineCodestringrequired

IATA code of the airline that hosts the loyalty program.

Example: "AA"

loyaltyPrograms[].airlineNamestringrequired

Name of the airline that hosts the loyalty program.

Example: "American Airlines"

loyaltyPrograms[].loyaltyTypestringrequired

Type of the loyalty program. This indicates how the loyalty program is associated with the airline mentioned in the API request.

Enum"OWN""PARTNER""ALLIANCE"

Example: "OWN"

applicableLoyaltiesArray of objects(LoyaltyInfo)

Response

application/json

{
  "loyaltyPrograms": [
    { … }
  ],
  "applicableLoyalties": [
    { … }
  ]
}