Validate air itinerary (interim)

API reference

Air

Validate air itinerary (interim)

Request

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.

Security

Bearer

Bodyapplication/jsonrequired

searchIdstringrequired

The unique searchId corresponding to the selected itinerary.

itineraryIdstringrequired

The selected itineraryId which you would like to validate.

rawCreditsArray of objects(Credit)

curl -i -X POST \
  https://api-ext-sboxmeta.partners.spotnana.com/v2/air/intermediate-revalidate-itinerary \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "searchId": "string",
    "itineraryId": "string",
    "rawCredits": [
      {
        "type": "string",
        "pnrOwningPcc": "string",
        "unusedCreditPcc": "string",
        "departureCountry": "USA",
        "arrivalCountry": "USA",
        "ticketType": "TICKET_TYPE_UNKNOWN",
        "departureDate": {
          "iso8601": "2017-07-21T17:32Z"
        },
        "segmentsAvailable": "UNKNOWN",
        "traveler": {
          "userId": {
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
          }
        },
        "passengerName": {
          "family1": "Gandas",
          "family2": "FamilyTwo",
          "given": "Vichitr",
          "middle": "Kumar",
          "suffix": "SR",
          "preferred": "Don"
        },
        "airlineInfo": {
          "airlineCode": "AA",
          "airlineName": "American Airlines"
        },
        "totalFare": {
          "amount": 510,
          "currencyCode": "GBP",
          "convertedAmount": 715.42,
          "convertedCurrency": "USD",
          "otherCoinage": [
            {
              "coinageCode": "BREX_POINTS",
              "amount": 1000,
              "conversionRate": 0.01,
              "preferredCurrencyConversionRate": 0.01,
              "otherCoinageMetadata": {
                "metadataType": "FlightPassPaymentMetadata",
                "flightPassMetadata": {}
              }
            }
          ]
        },
        "issueDate": {
          "iso8601": "2017-07-21T17:32Z"
        },
        "expiryDate": {
          "iso8601": "2017-07-21T17:32Z"
        },
        "source": "SABRE",
        "sourcePnr": "MC5ONS",
        "flightIds": [
          "string"
        ],
        "ticketNumber": "5267779139217",
        "travelerIndex": 2
      }
    ]
  }'

Responses

Bodyapplication/json

bookingIdstring

The booking ID for the booking.

Example:"bookingid"

fareBreakDownobject(BookingFareBreakdown)

legPricesArray of objects(LegPrice)

perTravelerPricesArray of objects(PerTravelerPrice)

policyDetailsobject(PnrPolicyInfo)

Policy Info applicable for the associated itinerary

mcoIssuanceEligibilitystring(McoIssuanceEligibility)

It indicates whether an MCO can be issued for this ticket. It is dependent on the validating airline of the ticket.

Enum:"ELIGIBLE""NOT_ELIGIBLE""MAYBE_ELIGIBLE"

residueTypestring(ResidueType)

Type of residue expected when ticket is exchanged to a lower fare amount. Indicates whether the residual value will be converted to MCO, refunded, or forfeited. This is determined at revalidation time before the exchange is completed.

Enum:"NO_RESIDUE""MCO""FORFEITED""REFUNDED"

Response

{
  "bookingId": "bookingid",
  "fareBreakDown": {
    "totalFare": { … },
    "merchantFee": { … },
    "airlineFee": { … },
    "changeFee": { … },
    "appliedCreditValue": { … },
    "fareDifference": { … }
  },
  "legPrices": [
    { … }
  ],
  "perTravelerPrices": [
    { … }
  ],
  "policyDetails": {
    "policies": [ … ],
    "ruleResultInfos": [ … ]
  },
  "mcoIssuanceEligibility": "ELIGIBLE",
  "residueType": "NO_RESIDUE"
}