Car Booking API

Guidance and examples for accessing the Car Booking API

Important: All partners leveraging XAP Booking APIs from any line of business must be aware of the PSD2 and 3DSv2 initiatives that launched in September, 2019. Please read the article on XAP Support of PSD2 and 3DSv2 Bookings for more information.

The Car Booking API allows you to enable car reservations to be made on behalf of the customer.

Endpoint

MethodEndpointPrerequisites
POSThttps://apim.expedia.com/cars/bookings/[offerToken]To complete a Details API call you must have an offerToken from the Listing API

Required Headers

Key:Expedia API key
Authorization:Expedia API Authorization String
Accept:application/vnd.exp-car.v3+json
Content-Type:application/json
User-Id:username@domain.com

The email address associated to the booking and to which the Booking Confirmation Email will be sent.

Partner-Transaction-Id:Partner TransactionID String

Next Steps

  • Follow web retrieve link to Expedia website to get details.

Example Car Booking Request

Request

https://apim.expedia.com/cars/bookings/AQAQAQKhg2IIFPKIFPMJC0hAE45JyfAUAFmAGuzQWwAQPAARc?price=12.33&currency=USD

Booking Request Body (with credit card information)

{
  	"Title": "Car Booking with Credit Card",
  	"FraudCheckId": "CarBookingFraudCheckId",
  	"Travelers": [{
  		"Primary": true,
  		"Name": {
  			"FirstName": "John",
  			"MiddleName": "Edward",
  			"LastName": "Test"
  		},

  		"Phone": {
  			"CountryCode": "1",
  			"AreaCode": "206",
  			"Number": "9876543"
  		},
  		"Email": "john.doe@gmail.com"
  	}],

  	"BillingDetails": {
  		"CreditCard": {
  			"CardNumber": "4XXXXXXXXXXXXXX8",
  			"CardType": "Visa",
  			"CardSecurityCode": "123",
  			"ExpirationMonth": "12",
  			"ExpirationYear": "2025"
  		},
  		"Name": {
  			"FirstName": "John",
  			"MiddleName": "Edward",
  			"LastName": "Test"
  		},
  		"Address": {
  			"Address1": "3333 108th Ave",
  			"Address2": "Expedia HQ",
  			"City": "Bellevue",
  			"Province": "WA",
  			"Country": "USA",
  			"PostalCode": "98004"
  		},
  		"Phone": {
  			"CountryCode": "1",
  			"AreaCode": "425",
  			"Number": "1234567"
  		}
  	},
  	"AdditionalBookingDetails": {
  		"MarketingCode": "111abc",
  		"PartnerAgentId": "123456",
  		"PartnerConfirmationNumber": "hello123"
  	},
    "PartnerMetaData": {
      "SampleKey1": "SampleValue1",
      "SampleKey2": "SampleValue2"
    }
  }

Booking Request Body (without credit card information)

Credit card information is generally not required for pay later car bookings, though partners may optionally require credit cards be submitted for all bookings. In this case, the credit card will be recorded in conjunction with the booking transaction, but will not be charged.

{
 	"Title": "Car Booking without Credit Card",
 	"FraudCheckId": "CarBookingFraudCheckId",
 	"Travelers": [{
 		"Primary": true,
 		"Name": {
 			"FirstName": "San",
 			"MiddleName": "Edward",
 			"LastName": "Test"
 		},

 		"Phone": {
 			"CountryCode": "1",
 			"AreaCode": "206",
 			"Number": "9876543"
 		},
 		"Email": "San.Zhang@gmail.com"
 	}],
 	"AdditionalBookingDetails": {
 		"MarketingCode": "111abc",
 		"PartnerAgentId": "123456",
 		"PartnerConfirmationNumber": "hello123"
 	},
 	"PartnerMetaData": {
 		"SampleKey1": "SampleValue1",
 		"SampleKey2": "SampleValue2"
 	}
 }

3DS Book Request

EWS supports 2 ways for 3ds:

  1. External authentication and EG authorization. in this way, partner use their own service provider to authenticate payment with bank and pass authentication data to EWS for authorization. If partner uses External authentication, MpiData is required.
  2. EG authentication and EG authorization. in this way, partner integrate EG JS lib to authenticate and authorize payment. If partner uses EG authentication, BrowserData is required.

3DS Book Request - With External authentication

{
  "Title": "Car Booking",
  "FraudCheckId": "CarBookingFraudCheckId",
  "Travelers": [
    {
      "Primary": true,
      "Name": {
        "FirstName": "San",
        "MiddleName": "Edward",
        "LastName": "Test"
      },
      "Phone": {
        "CountryCode": "1",
        "AreaCode": "206",
        "Number": "9876543"
      },
      "Email": "San.Zhang@gmail.com"
    }
  ],
  "BillingDetails": {
    "CreditCard": {
      "CardNumber": "4XXXXXXXXXXXXXX8",
      "CardType": "Visa",
      "CardSecurityCode": "123",
      "ExpirationMonth": "12",
      "ExpirationYear": "2025"
    },
    "Name": {
      "FirstName": "San",
      "MiddleName": "Edward",
      "LastName": "Test"
    },
    "Address": {
      "Address1": "3333 108th Ave",
      "Address2": "Expedia HQ",
      "City": "Bellevue",
      "Province": "WA",
      "Country": "USA",
      "PostalCode": "98004"
    },
    "Phone": {
      "CountryCode": "1",
      "AreaCode": "425",
      "Number": "1234567"
    },
    "TwoStepPaymentDetails": {
      "PaymentType": "3DS",
      "ReturnUrl": "http://www.google.com",
      "PaymentSessionId": "ern:pay:pa:r1::d6d6aa02-833a-09cc-2136-d5abdd2b7344",
      "MpiData": {
        "Cavv": "Y2FyZGluYWxjb21tZXJjZWF1dGg=",
        "Xid": "ODUzNTYzOTcwODU5NzY3Qw==",
        "Eci": "05",
        "CavvAlgorithm": "2",
        "DsTransactionId": "1c59a512-ab4f-4370-af97-4cfe69b7276e",
        "ThreeDSVersion": "2.0.1",
        "MerchantName": "Expedia.com",
        "PAResStatus": "Y",
        "VEResStatus": "Y"
      }
    }
  },
  "AdditionalBookingDetails": {
    "MarketingCode": "111abc",
    "PartnerAgentId": "123456",
    "PartnerConfirmationNumber": "hello123"
  },
  "PartnerMetaData": {
    "SampleKey1": "SampleValue1",
    "SampleKey2": "SampleValue2"
  }
}

3DS Book Request - With EG authentication

{
    "Title": "Car Booking",
  "FraudCheckId": "CarBookingFraudCheckId",
    "BrowserData": {
      "IpAddressV4": "216.251.118.195",
      "BrowserAcceptHeader": "text/html",
      "EncodedBrowserMetadata": "eyJicm93c2VySmF2YUVuYWJsZWQiOmZhbHNlLCJicm93c2VyTGFuZ3VhZ2UiOiJ6aC1DTiIsImJyb3dzZXJDb2xvckRlcHRoIjoyNCwiYnJvd3NlclNjcmVlbkhlaWdodCI6MTA4MCwiYnJvd3NlclNjcmVlbldpZHRoIjoxOTIwLCJicm93c2VyVFoiOi00ODAsImJyb3dzZXJVc2VyQWdlbnQiOiJNb3ppbGxhLzUuMCAoV2luZG93cyBOVCA2LjE7IFdpbjY0OyB4NjQpIEFwcGxlV2ViS2l0LzUzNy4zNiAoS0hUTUwsIGxpa2UgR2Vja28pIENocm9tZS83NS4wLjM3NzAuMTAwIFNhZmFyaS81MzcuMzYifQ==",
      "MerchantUrl": "https://www.expedia.com/hotel"
    },
    "Travelers": [
    {
      "Primary": true,
      "Name": {
        "FirstName": "San",
        "MiddleName": "Edward",
        "LastName": "Test"
      },
      "Phone": {
        "CountryCode": "1",
        "AreaCode": "206",
        "Number": "9876543"
      },
      "Email": "San.Zhang@gmail.com"
    }
  ],
  "BillingDetails": {
    "CreditCard": {
      "CardNumber": "4XXXXXXXXXXXXXX8",
      "CardType": "Visa",
      "CardSecurityCode": "123",
      "ExpirationMonth": "12",
      "ExpirationYear": "2025"
    },
    "Name": {
      "FirstName": "San",
      "MiddleName": "Edward",
      "LastName": "Test"
    },
    "Address": {
      "Address1": "3333 108th Ave",
      "Address2": "Expedia HQ",
      "City": "Bellevue",
      "Province": "WA",
      "Country": "USA",
      "PostalCode": "98004"
    },
    "Phone": {
      "CountryCode": "1",
      "AreaCode": "425",
      "Number": "1234567"
    },
    "TwoStepPaymentDetails": {
      "PaymentType": "3DS",
      "ReturnUrl": "http://www.google.com",
      "PaymentSessionId": "ern:pay:pa:r1::d6d6aa02-833a-09cc-2136-d5abdd2b7344"
    }
  },
  "AdditionalBookingDetails": {
    "MarketingCode": "111abc",
    "PartnerAgentId": "123456",
    "PartnerConfirmationNumber": "hello123"
  },
  "PartnerMetaData": {
    "SampleKey1": "SampleValue1",
    "SampleKey2": "SampleValue2"
  }
}

Price Change - Error Example

{
	"Errors": [{
		"Code": "PRICE_DECREASE",
		"Description": "The price for your trip has changed from 274.18 EUR to 264.18 EUR.",
		"OriginalPrice": {
			"Value": "274.18",
			"Currency": "EUR"
		},
		"NewPrice": {
			"Value": "264.18",
			"Currency": "EUR"
		},
		"ChangedAmount": {
			"Value": "10.00",
			"Currency": "EUR"
		},
		"Links": {
			"ApiBook": {
				"Accept": "application/vnd.exp-car.v3+json",
				"Method": "POST",
				"Href": "https://10.2.68.172:58443/cars/bookings/AQAQAQKRg1IL0kKL0kMLiTngE4nuWeAUAFmAHL2gWwAQM?price=264.18&currency=EUR"
			}
		}
	}],
	"TransactionId": "e2da0a93-921e-4e2b-9f26-59ea82759511"
}

Booking Example Response

{
  "TransactionId": "a751d7b0-b4dd-4c91-9cae-fe05974e2bb9",
  "ItineraryNumber": 72018989961043,
  "BookingDateTime": "2020-12-24T02:46:38+00:00",
  "PartnerConfirmationNumber": "3763-1094",
  "Links": {
    "ApiCancel": {
      "Accept": "application/vnd.exp-car.v3+json",
      "Method": "PUT",
      "Href": "https://apim.expedia.com/cars/bookings/72018989961043"
    },
    "WebItinRetrieve": {
      "Href": "https://www.mytravelchat.com/trips/72018989961043?userToken=Ar73RiUC4CIh1kISFNfzE2g5vnqTm9SPKx9cXyGe0zBYPk4oSI3sxFo8a5px2JF2_MGaxcBv2TLtGCw0mJhQgnJWx-40ZhEv5K4g2aUYtg"
    },
    "ApiItinRetrieve": {
      "Accept": "application/vnd.exp-car.v3+json",
      "Method": "GET",
      "Href": "https://apim.expedia.com/cars/bookings/72018989961043"
    }
  },
  "Warnings": {
    "BOOKED_WITH_PRICE_DECREASE": "The actual price of the booking was $10.69 less than originally quoted."
  },
  "SupplierConfirmationNumber": "1423128911BOOTH",
  "CarDetails": {
    "VehicleDetails": {
      "Make": "Mitsubishi Mirage",
      "CarClass": "Economy 2/4Door Car",
      "MinDoors": 4,
      "MaxDoors": 4,
      "FuelLevel": "Full to Full",
      "CarCategory": {
        "Code": "E",
        "Value": "Economy"
      },
      "CarType": {
        "Code": "C",
        "Value": "2/4Door Car"
      },
      "TransmissionDrive": {
        "Code": "A",
        "Value": "Automatic transmission"
      },
      "FuelAC": {
        "Code": "R",
        "Value": "Air conditioning"
      },
      "Capacity": {
        "AdultCount": 4,
        "ChildCount": 0,
        "SmallLuggageCount": 0,
        "LargeLuggageCount": 2
      }
    },
    "Supplier": {
      "Id": "42",
      "Name": "National",
      "Code": "ZL"
    },
    "PickupDetails": {
      "DateTime": "2020-12-30T20:00:00",
      "ShuttleCategory": "NoShuttle",
      "Location": {
        "Code": "SAV",
        "LocationId": "SAVT001",
        "Address": "***SUPPRESSED***",
        "GeoLocation": {
          "Latitude": "32.138170",
          "Longitude": "-81.217550"
        }
      },
      "OpenSchedule": [
        {
          "DateRange": {
            "StartDate": "2020-12-30",
            "EndDate": "2020-12-30"
          },
          "TimeRanges": [
            {
              "StartTime": "08:00:00",
              "EndTime": "22:00:00"
            }
          ]
        }
      ]
    },
    "DropOffDetails": {
      "DateTime": "2020-12-31T14:00:00",
      "ShuttleCategory": "NoShuttle",
      "Location": {
        "Code": "AGS",
        "LocationId": "AGST001",
        "Address": "***SUPPRESSED***",
        "GeoLocation": {
          "Latitude": "33.373520",
          "Longitude": "-81.973200"
        }
      },
      "OpenSchedule": [
        {
          "DateRange": {
            "StartDate": "2020-12-31",
            "EndDate": "2020-12-31"
          },
          "TimeRanges": [
            {
              "StartTime": "00:00:00",
              "EndTime": "06:29:00"
            }
          ]
        }
      ]
    },
    "RateDetails": {
      "RatePeriod": "Daily",
      "RateCode": "NOD26",
      "PrePay": false,
      "CreditCardRequired": false,
      "Mileages": [
        {
          "FreeDistance": {
            "Value": "-1"
          },
          "FreeDistanceRatePeriod": "Trip"
        }
      ]
    },
    "Price": {
      "RatePeriodUnitPrice": {
        "Value": "80.10",
        "Currency": "USD"
      },
      "BasePrice": {
        "Value": "80.10",
        "Currency": "USD"
      },
      "TaxesAndFees": {
        "Value": "21.07",
        "Currency": "USD"
      },
      "TotalPriceDueAtBooking": {
        "Value": "0.0",
        "Currency": "USD"
      },
      "TotalPrice": {
        "Value": "101.17",
        "Currency": "USD"
      }
    },
    "TaxesAndFeesDetails": [
      {
        "Description": "CFC - CUSTOMER FACILITY CHARGE 3.00/DAY",
        "Amount": {
          "Value": "3.00",
          "Currency": "USD"
        }
      },
      {
        "Description": "CRF - CONCESSION RECOUP FEE 9.25 PCT",
        "Amount": {
          "Value": "7.56",
          "Currency": "USD"
        }
      },
      {
        "Description": "SCG - RENTAL EXCISE TAX 3 PCT",
        "Amount": {
          "Value": "2.68",
          "Currency": "USD"
        }
      },
      {
        "Description": "SCG - VLF REC 1.58/DAY",
        "Amount": {
          "Value": "1.58",
          "Currency": "USD"
        }
      },
      {
        "Description": "TAX - SALES TAX",
        "Amount": {
          "Value": "6.25",
          "Currency": "USD"
        }
      }
    ],
    "CancellationPolicy": {
      "Cancellable": true,
      "FreeCancellation": true,
      "FreeCancellationEndDateTime": "2020-12-30T20:00:00"
    },
    "CarPolicies": [
      {
        "CategoryCode": "One Way Information",
        "PolicyText": ""
      },
      {
        "CategoryCode": "Guarantee Information",
        "PolicyText": "RATE GUARANTEED 6 DAYS FROM BOOKING "
      },
      {
        "CategoryCode": "Miscellaneous",
        "PolicyText": "BASE RATE DOES NOT INCLUDE SURCHARGES "
      },
      {
        "CategoryCode": "Miscellaneous",
        "PolicyText": "BASE RATE DOES NOT INCLUDE TAXES "
      },
      {
        "CategoryCode": "Miscellaneous",
        "PolicyText": "THE ONLY WAY TO RENT ONEWAY.ZL "
      },
      {
        "CategoryCode": "Miscellaneous",
        "PolicyText": "ALLOWED - RETURN TO SPECIFIED LOCATION ONLY "
      },
      {
        "CategoryCode": "Miscellaneous",
        "PolicyText": "ALL AMOUNTS INCLUDE DISCOUNT OF 10 PCT "
      },
      {
        "CategoryCode": "LDW - LOSS DAMAGE WAIVER",
        "PolicyText": ""
      },
      {
        "CategoryCode": "PEC - PERSONAL EFFECTS COVERAGE",
        "PolicyText": ""
      },
      {
        "CategoryCode": "SLI - SUPPLEMENTARY LIABILITY INSURANCE",
        "PolicyText": ""
      },
      {
        "CategoryCode": "RSP - RSP",
        "PolicyText": ""
      },
      {
        "CategoryCode": "ReturnRefueling",
        "PolicyText": "Refueling Service. As a customer, you have a choice as to how you would like to pay for fuel.\n\nOption 1- Prepay Fuel\nThis option allows the renter to pay for the full tank of gas at the time of rental and return the tank empty. No refunds will be issued for unused gas.\n\nOption 2 - We Refill\nThis option allows the renter to pay National at the end of the rental for gas used but not replace. Price per gallon will be higher than local fuel prices.\n\nOption 3- You Refill\nThis option allows the renter to return the vehicle with a full tank of gas to avoid extra fuel charges."
      },
      {
        "CategoryCode": "SpecialEquipment",
        "PolicyText": ""
      },
      {
        "CategoryCode": "CreditCard",
        "PolicyText": ""
      },
      {
        "CategoryCode": "ShuttleService",
        "PolicyText": "Arrival directions. Follow signs to baggage claim area located on the lower level, National Car Rental will be on the left. Please proceed to the counter to obtain your rental agreement. "
      },
      {
        "CategoryCode": "OutOfHoursFee",
        "PolicyText": "After Hours Service. 1:00 AM - 8:00 AM\nPlease place keys in National drop box located on the right side of the rental counter. Once your vehicle has been checked in you will receive a call from an associate informing you of your final charges. If there is any change in condition to the vehicle or any change in the estimated charges that were disclosed at time of pick up the associate will make you aware once they call to confirm vehicle return.\n "
      },
      {
        "CategoryCode": "SpecialRates",
        "PolicyText": "Additional Driver. Renter’s spouse or domestic partner who meet the same age and driver’s license requirements of the renter are authorized drivers at no additional charge.  Any additional authorized drivers must appear at time of rental and meet age and driver’s license requirements.  An additional charge of $10 per day for each additional authorized driver will be added to the cost of the rental, unless other contractual conditions apply. \n\n\nA spouse or domestic partner is the only permitted additional driver on a rental secured with a debit card."
      },
      {
        "CategoryCode": "CancellationCharge",
        "PolicyText": ""
      },
      {
        "CategoryCode": "DropOffCharges",
        "PolicyText": ""
      },
      {
        "CategoryCode": "Other",
        "PolicyText": "Loss Damage Waiver Exclusions/Voids. Damage Waiver does not apply to lost or damaged keys, key fobs, transponders, Optional Accessories, or any liability imposed by law. Damage Waiver does not apply to damage occurring in Mexico.\n\nThe following shall invalidate Damage Waiver: if Vehicle is damaged when used or driven by any person other than Renter or AAD(s) without Owner's prior written consent or by any person if there is reasonable evidence the driver was impaired by the use of alcohol, narcotics, intoxicants, or drugs, used with or without a prescription; by any person committing a felony or otherwise engaged in a criminal act; in a race or speed contest; to tow or push anything; outside the states authorized; under authority of any license that is suspended, revoked, invalid or does not belong to the driver; to transport persons or property for hire; in a wanton or reckless manner or if Vehicle is deliberately damaged; on an unpaved road or off road; to transport explosives, chemicals, corrosives or other hazardous materials or pollutants of any kind; or if Renter misrepresents facts to Owner pertaining to rental, use, or operation of Vehicle; or if Vehicle's interior components are stolen or damaged when Vehicle is unlocked or keys are not secured; or if Renter fails or refuses to provide Owner, police, or other authorities with a full report of any accident or vandalism involving Vehicle or otherwise fails to cooperate with Owner, police, or other authorities in the investigation of any accident or vandalism. \n\nIf Vehicle is stolen and Renter fails to do any of the following: return the original ignition keys and Owner's key tag identifying Vehicle; file a police report within 24 hours after discovering the theft; cooperate fully with Owner, police and other authorities in all matters connected with the investigation of the theft; ensure that the Vehicle's ignition is turned off at the time the Vehicle is stolen. \nPersonal Accident/Effect Coverage Exclusion/Voids. Personal Accident Insurance shall not cover any death or injury caused wholly or partly, directly or indirectly by suicide, attempted suicide, or self inflicted injury; aircraft travel, except as a passenger in a licensed aircraft on a regularly scheduled flight; committing or attempting to commit a criminal offense; an accident which occurs while under the influence of alcohol or narcotics, unless prescribed by a physician; an accident which occurs while participating in a prearranged or organized race or testing of a vehicle; war or any act of war; or engagement in an illegal occupation; nor shall this insurance be in effect if Renter converts Vehicle or during any period Renter is in violation of the Rental Agreement.  Renter shall be deemed to have converted Vehicle whenever Vehicle is not returned to the Owner by the return date or by the extended return date.\nPersonal Effects Coverage shall not cover automobiles, automobile equipment, motorcycles, watercraft, motors, or other conveyances or their appurtenances, furniture, currency, coins, deeds, bullion, stamps, tickets, securities, documents, contact lenses, artificial teeth and limbs, perishables and animals.  Loss or damage to property while actually being worked upon, or while in the care, custody or control of any common carrier are also not covered.  The policy does not cover loss by mysterious disappearance.  All losses by theft must be reported to the appropriate law enforcement authorities or they will not be covered.\n \nRoadside Protection Exclusions/Voids. Roadside Assistance Protection does not waive the customer's responsibility for: Cost of a replacement tire. Roadside Assistance Protection does not apply in Mexico.\n \nRoadside Assistance PLUS. Renter may purchase Roadside Plus (RSP) from Owner for an additional fee. If Renter purchases RSP, Owner agrees, subject to the actions that invalidate Loss Damage Waiver, to contractually waive Renter’s responsibility for the cost to provide 24/7 roadside assistance (where available) which includes replacement of lost keys (including remote entry devices), flat tire service (if no inflated spare is available, the vehicle will be towed. Cost of a replacement tire is not covered by RSP), lockout service (if the keys are locked inside the vehicle), jumpstarts, and fuel delivery service for up to 3 gallons (or equivalent liters) of fuel if Vehicle is out of fuel. Roadside Plus services are only available in the United States and Canada. If Renter does not purchase RSP, or RSP is invalidated as set forth above, roadside assistance will be available, but standard charges will apply. RSP does not apply in Mexico. For roadside assistance call 1-800-367-6767.\nSupplemental Liability Insurance. Effective for rentals with a rental period commencing on or after January 1, 2021, SLI will no longer be offered for sale.  If you reserved SLI with your rental reservation for a rental starting on or after January 1, 2021, you will be provided the option to purchase Supplemental Liability Protection (SLP) with a combined single limit of $300,000 (Uninsured Motorist/Underinsured Motorist Benefits included only where required by law in select states) at the price shown at time of rental.\n\nThe purchase of Supplemental Liability Insurance (SLI) is optional and not required in order to rent a vehicle.\n\nThis is a summary only and is subject to all provisions, limitations, exceptions and exclusions of the SLI policy. Upon request, a copy of the policy is available for review. SLI may provide a duplication of coverage already furnished under a personal insurance policy or some other source. Owner’s employees, agents or endorsees are not qualified to evaluate the adequacy of renter’s existing coverage.\n\nOptional SLI provides you with minimum financial responsibility limits (at no charge to you) as outlined in the applicable motor vehicle financial responsibility laws of the state where the vehicle is operated AND excess insurance provided by the insurance policy. This supplies you and any authorized drivers with third-party liability protection with a combined single limit per accident equal to the difference between the minimum financial responsibility limits referenced above and $1,000,000 Combined Single Limit per accident. SLI will respond to third party accident claims that result from bodily injury, including death, and property damage that arise from the use or operation of the vehicle as permitted in the Rental Agreement. The policy does not provide coverage for any loss arising from the use or operation of Vehicle in Mexico.\nNational Wayfinding Counter. Upon arrival, please proceed to the National Car Rental counter.Follow signs to baggage claim area located on the lower level, National Car Rental will be on the left.Please proceed to the counter to obtain your rental agreement.\nWayfinding Emerald Aisle. Upon arrival, please proceed to the Aisle to choose your vehicle. \nWayfinding Emerald Booth. Upon arrival, please proceed to the National Car Rental booth. \nWayfinding Emerald Counter. Upon arrival, please proceed to the National Car Rental counter Proceed to the Emerald Club counter to obtain your rental agreement and vehicle keys. \nWayfinding Emerald Reserve. Upon arrival, please proceed to the area of the car class reserved to choose your vehicle. Proceed to the Emerald Club counter to obtain your rental agreement and vehicle keys. \nWayfinding Executive Selection. Upon arrival, please proceed to the Executive area to choose your vehicle. \nWayfinding FBO Delivery. Once you have arrived at the National Car Rental location, please proceed to the counter to obtain your rental agreement.  \nWayfinding Reserve Service. Upon arrival please proceed to the National Car Rental lot and look for the VIP designated parking area.  A National Car Rental employee will greet you at your vehicle.  Please proceed to the National Car Rental lot and look for the VIP designated area.  A National Car Rental employee will be there to greet you with your vehicle keys.  \nWayfinding Meet and Greet. Upon arrival, please look for a National Car Rental employee who will escort you to your vehicle. Follow baggage signs to security point. Meet and Greet rep will hold meet and greet sign with customers name on it and be in full uniform.\nWayfinding Virtual Aisle. You are eligible to use the Virtual Aisle.  \nCounter Short Description. Upon arrival, please proceed to the National Car Rental counter.\n \nEmerald Aisle Short Description. Upon arrival, please proceed to the Aisle to choose your vehicle. (WSEA)\n \nEmerald Booth Short Description. Upon arrival, please proceed to the National Car Rental booth. (WSEB)\n \nEmerald Counter Short Description. Upon arrival, please proceed to the National Car Rental counter.\n \nEmerald Reserve Short Description. Upon arrival, please proceed to the area of the reserved car class to choose your vehicle. (WSER)\n \nExecutive Selection Short Description. Upon arrival, please proceed to the Executive area to choose your vehicle.\n \nFBO Delivery Short Description. Upon arrival, your vehicle will be delivered to the FBO terminal.\n \nGreet Short Description. Upon arrival please proceed to the National Car Rental lot and look for the VIP designated parking area. A National Car Rental employee will greet you at your vehicle. \n \nMeet and Greet Short Description. Upon arrival, please look for a National Car Rental employee who will escort you to your vehicle.\n \nVirtual Aisle Short Description. You are eligible to use the Virtual Aisle. (WSVA)\n "
      },
      {
        "CategoryCode": "TollCharge",
        "PolicyText": "Toll Pass Policy. Our TollPass Program is our electronic toll collection program which allows our renters to drive through electronic toll lanes and pay tolls electronically, without having to stop and pay cash. In addition, many toll plazas have converted to all electronic tolling and removed the option for travelers to stop and pay cash at toll plazas.\n\nThe TollPass Program is offered in different ways, depending on where you rent. Visit the websites below for more information.\n\n• Northeast US (including regions in the Midwest):\n\nhttps://www.nationalcar.com/en_US/car-rental-faqs/use-toll-lanes/northeast-us-toll-options.html\n\n• Chicago Metropolitan Area:\n\nhttps://www.nationalcar.com/en_US/car-rental-faqs/use-toll-lanes/chicago-toll-options.html\n\n\n• Golden Gate Bridge and Northern California Bay Area:\n\nhttps://www.nationalcar.com/en_US/car-rental-faqs/use-toll-lanes/northern-california-toll-options.html\n\n• Southern California:\nhttps://www.nationalcar.com/en_US/car-rental-faqs/use-toll-lanes/southern-california-toll-options.html\n\n• CO, FL, TX, NC, GA, WA, PR, and Ontario Canada:\nhttps://www.nationalcar.com/en_US/car-rental-faqs/use-toll-lanes/other-state-toll-options.html\n\n• Louisville KY:\nhttps://www.nationalcar.com/en_US/car-rental-faqs/use-toll-lanes/indiana-kentucky-toll-options.html\n\n• Utah:\nhttps://www.nationalcar.com/en_US/car-rental-faqs/use-toll-lanes/utah-toll-options.html\n\n\nTo view our entire coverage map, go to https://www.nationalcar.com/en_US/car-rental-faqs/use-toll-lanes.html and click on Coverage Map.\n\nTollPass products not available at all locations or at locations operated by a Licensee. Please refer to your rental locations policies and/or offerings for toll products to determine availability of TollPass programs."
      },
      {
        "CategoryCode": "AcceptedFormsOfPayment",
        "PolicyText": "Forms of Payment. The following forms of payment are accepted at the end of the rental.\n\n\nVISA®\nMasterCard®\nAmerican Express®\nDiscover Network®\nDebit Card\nTravelers Check \nPrepaid Gift Card\nMoney Order\n\n \n\n \n\nPlease read the Renter Requirements Policy for details pertaining to deposits and general rental requirements at this location. Additional authorizations from your account will be obtained to cover the cost of the rental charges. National is not responsible for any overdraft fees incurred.\nDebit Card Policy. Please see Renter Requirements policy for debit card information.\n "
      },
      {
        "CategoryCode": "Age",
        "PolicyText": ""
      },
      {
        "CategoryCode": "DriversLicense",
        "PolicyText": "Driver's License Information. Customers who reside in the United States, U.S. Territories, or Canada\n\nCustomers who reside in the U.S., U.S. Territories, or Canada must present a valid, unexpired government-issued Driver’s license which includes a photograph of the customer.  Digital licenses are not accepted.  The driver's license must be valid for the entire rental period.\n\nMembers of the United States Armed Forces who are on active duty may present an expired home state license under the following conditions:\n\n\n\t\n\tThey also present an Active Military ID, and\n\t\n\t\n\tThey are in compliance with their military extension policy of the state which issued the license.  These policies vary by state and customers are encouraged to check with the appropriate department of motor vehicles for more information.\n\t\n\n\nCustomers travelling to the U.S. and Canada from other countries\n\nIt is important that customers check with the appropriate Department of Motor Vehicles in the States or Provinces in which they intend to travel to ensure compliance with their various licensing laws.  The following practices are used to ensure the customer is presenting a facially valid license at the time of rental. \n\nCustomers traveling to the United States and Canada from another country must present the following:\n\n\n\t\n\tTheir home country driver’s license, and\n\t\n\t\n\tIf the home country license is in a language other than English (or French, for rentals in Canada) and the letters are English (i.e. German, Spanish, etc.) an International Driver’s Permit is recommended, but not required, for translation purposes in addition to the home country license.  \n\t\n\t\n\tIf the home country license is in a language other than English and the letters are not English (i.e.alphabet is not an extended Latin-based alphabet like German or Spanish but is Russian, Japanese, Arabic, etc.) an International Driver’s Permit is required. \n\t\n\t\n\tIf an International Driver’s permit cannot be obtained in the home country, another professional, type-written translation may be substituted.  In either case the home country license must also be presented.\n\t\n\t\n\tCustomers may not rent a vehicle solely with the International Driver’s Permit.  The International Driver’s Permit is a translation of the individual’s home country license and is not considered a license nor is it considered valid identification.\n\t\n\tIn some US locations, customers not holding a US driver’s license may be asked to provide additional documentation.  Examples of this may include a valid passport or, in certain states (AZ, CA, NM, TX) a valid Mexican voter registration card and/or inbound and outbound travel documentation.\n\t \n\tIn some Canadian locations, customers not holding a Canadian driver’s license may be asked to provide additional valid government-issued documentation.  Examples of this may include a valid passport.\n\n\nOther requirements\n\n\n\t\n\tPhotocopies of Driver’s Licenses are not accepted\n\t\n\t\n\t“Learner’s Permits” are not accepted.\n\t\n\t\n\tAny license which, on its face, restricts the licensee to the use and operation of a vehicle equipped with a form of a breathalyzer apparatus is not accepted.\n\t\n\t\n\tTemporary Driver’s Licenses may be refused if the renting location is unable to otherwise verify the customer’s identity or verify the authenticity of the temporary license.  Additional Government-issued identification may be required.\n\t\n\nRenter Requirements . We look forward to serving you. To protect you, our employees and our community, face coverings are required inside our facilities. Please ensure you are prepared upon arrival at our location. For information on our readiness, please see the Covid-19 link at the top of our website.\n\nAll renters and additional drivers must be 21 or older. All renters must have a valid driver’s license and a major credit card or debit card in their name. Individuals with learners’ or instructional permits are not eligible to rent. This is only a summary. For additional details, please reference the Driver’s License Information Policy. \n\n \n\nAGE\n\nThe underage surcharge for drivers between the ages of 21 and 24 is $20 per day. Renters between the ages of 21 and 24 may rent the following vehicle classes: Economy through Full Size cars, Cargo and Minivans, Pickup Trucks, and up to a Standard Size SUV. \n\n \n\nDEBIT CARD  \n\nAt airport locations, debit card deposits are only accepted at the time of rental if accompanied by a ticketed return travel itinerary. The name and address shown on the renter’s driver’s license must match their current home address. Active duty military personnel are exempt from address requirements.   \n\nOther than the renter’s spouse or domestic partner, no other additional drivers are allowed. \n\nAt the time of rental, charges will be placed on the debit card which reduce the available funds in the account associated with the card used. Renter is responsible for any overdraft fees incurred. See Rental Authorization and Deposit Amount for more details. \n\n \n\nRENTAL AUTHORIZATION AND DEPOSIT AMOUNT \n\nDisembarking passengers will be asked to provide a credit card or debit card with funds to cover the cost of rental. Renters without a ticketed return travel itinerary will need to provide a credit card with sufficient funds to cover the cost of the rental plus $300. Debit cards are only accepted at the time of rental if accompanied by a ticketed return travel itinerary.\n\nMoney orders and prepaid cards are not acceptable forms of security deposit but may be used to pay any balance due at the end of the rental. Cash is not accepted. "
      },
      {
        "CategoryCode": "Insurance",
        "PolicyText": "Personal Accident Insurance / Personal Effects Coverage. Personal Accident Insurance/Personal Effects Coverage (PAI/PEC) is offered at the time of rental for an additional daily charge. If accepted, the PAI contained in the policy provides renter and renter's passengers with accidental death, accident medical expenses and ambulance expense benefits. The PEC contained in the policy insures the personal effects of the renter, additional drivers or any member of the renter's immediate family who permanently resides in the renter's household and who is traveling with the renter against risks of loss or damage. Benefits are payable in addition to any other insurance coverage the renter or passengers may have. This is a summary only. PAI/PEC is subject to the provisions, limitations and exclusions of the PAI/PEC policy underwritten by Empire Fire and Marine Insurance Company in the United States or ACE INC Insurance in Canada. The purchase of PAI/PEC is optional and not required to rent a car. The coverage provided by PAI/PEC may duplicate the renter's existing coverage. National Car Rental is not qualified to evaluate the adequacy of the renter's existing coverage; therefore, the renter should examine his or her personal insurance policies or other sources of coverage that may duplicate the coverage provided by PAI/PEC.\nSupplemental Liability Protection Exclusions/Voids. Extended Protection shall not cover: Loss arising out of an accident which occurs while Renter or Additional Authorized Drivers is under the influence of alcohol or drugs, or other substances unless prescribed by a physician; Loss arising out of bodily injury or property damage sustained by Renter or Additional Authorized Drivers or any relative or family member of Renter or Additional Authorized Drivers who resides in the same household; Loss arising out of the operation of Vehicle by any driver who is not Renter or Additional Authorized Drivers ; Liability arising out of or benefits payable under any uninsured or underinsured motorist law, in any state; Liability arising out of or benefits payable under any first party benefit law, medical payments, no fault or any similar law to the foregoing, in any state; Bodily injury to an employee or the spouse, child, parent, brother or sister of that employee, arising out of and in the course of employment by Renter or Additional Authorized Drivers ; Property damage to property transported or in the care, custody or control of Renter or Additional Authorized Drivers ; Damage to Vehicle; Liability arising out of the use of Vehicle, which was obtained based on false, misleading or fraudulent information; Loss arising out of the use of Vehicle when such use is otherwise in violation of the terms and conditions of the Agreement.\n \nLoss Damage Waiver. Loss Damage Waiver (LDW) is not insurance. The purchase of LDW is optional and not required in order to rent a vehicle.\n\nYou may purchase optional LDW for an additional fee. If you purchase LDW we agree, subject to the actions that invalidate LDW listed on the rental agreement, to contractually waive your responsibility for all or part of the cost of damage to, loss or theft of, the vehicle. DW does not apply to damage occurring in Mexico.\n\nWhen deciding whether or not to purchase LDW, you may wish to check with your insurance representative or credit card company to determine whether, in the event of damage to, or theft of, vehicle, you have coverage or protection for such damage or theft and the amount of your deductible or out-of-pocket risk.\n\n*For rentals originating in California- LDW ranges between 10.99 USD and 500.00 USD per day depending on the type of vehicle rented."
      },
      {
        "CategoryCode": "CrossBorderRestriction",
        "PolicyText": "Cross Border Policy. Rentals originating in the United States: Most vehicles rented in the US can be driven throughout US and Canada. Some vehicle classes like Exotics, Large Passenger or Cargo Vans, and other specialty vehicles may not be allowed to travel outside of the US. Please reach to the renting location directly for details on cross-border restrictions.\n\nMost locations do not allow travel into Mexico. If you wish to travel into Mexico, you will be required to purchase additional insurance to cover the vehicle while in Mexico. Please contact the branch directly to determine limitations and availability.\n "
      }
    ],
    "Images": [
      {
        "Type": "Thumbnail",
        "Size": "t",
        "Href": "https://mediaim.expedia.com/cars/42/69d3f56e-8ca9-4a86-95b8-4a61a3717d6b.jpg?impolicy=resizecrop&ra=fit&rh=70&rw=70"
      },
      {
        "Type": "Image",
        "Size": "s",
        "Href": "https://mediaim.expedia.com/cars/42/69d3f56e-8ca9-4a86-95b8-4a61a3717d6b.jpg?impolicy=resizecrop&ra=fit&rh=165&rw=165"
      }
    ]
  }
}

Error Codes

Common Error Codes

HTTP Status CodeError CodeError Message
400INVALID_ACCEPT Accept is either missing or invalid. Please provide a correct Accept header as following: Accept:application/vnd.exp-<product>.<version>+<format> (product={car,flight,hotel},version={v3},format={json}).
400Only one Accept header is allowed.
400INVALID_PARTNER_TRANSACTION_ID Partner-Transaction-Id is missing.
400Only one Partner-Transaction-Id header is allowed.
400INVALID_CLIENT_KEY Invalid client key: XXX.
400Only one Key header is allowed.
400INVALID_CONTENT_TYPE Content-Type is either missing or invalid. Content-Type should be application/json.
400Only one Content-Type header is allowed.
400INVALID_USER_ID User-Id in http headers is missing or invalid. It must be a valid email.
400Only one User-Id header is allowed.
400INVALID_USER_CREDENTIALSUser credentials are either missing or invalid.
409INVALID_OFFER_IDOfferId provided is either invalid or expired.
400INVALID_PRICETotal price is either missing or invalid.
400INVALID_CURRENCYCurrency is either missing or invalid.
400CURRENCY_NOT_SUPPORTEDThe currency provided by the client: Zhangs not match the currency supported.
400INVALID_REQUESTRequest is either missing or in invalid.
400UNKNOWN_FIELDUnrecognized field "%s"
400INVALID_TRIP_TITLETrip title is too long.
400INVALID_TRAVELERSTravelers information is either missing or invalid.
400PRIMARY_TRAVELER_MISSINGNo primary traveler found.
400INVALID_TRAVELER_COUNTOnly one primary traveler is allowed.
400INVALID_TRAVELER_NAMETraveler name is either missing or invalid.
400INVALID_TRAVELER_PHONETraveler phone information is either missing or invalid.
400INVALID_EMAILEmail address is either missing or invalid.
400INVALID_BILLING_DETAILSBilling information is either missing or invalid.
400CREDIT_CARD_TYPE_NOT_SUPPORTEDCredit card type is not supported for the channel.
400DIRECT_DEBIT_TYPE_NOT_SUPPORTEDDirect debit is not supported for the channel.
400INVALID_CREDIT_CARDCredit card information is either missing or invalid.
400INVALID_DIRECT_DEBITDirect debit information is either missing or invalid.
400INVALID_BILLING_NAMEBilling name is either missing or invalid.
400INVALID_BILLING_ADDRESSBilling address is either missing or invalid. Please provide the following required fields: Address1, City, Country.

Billing address address1 (address2/province/city/postal code) field should not be longer than %s characters.
400BILLING_ADDRESS_POSTAL_CODE_MISSINGBilling address postal code is required for specified country.
400INVALID_BILLING_PHONEBilling phone information is either missing or invalid.
400INVALID_SPECIAL_EQUIPMENT_COUNTMax allowed special equipment count is %s.
400SPECIAL_EQUIPMENT_NOT_SUPPORTEDSpecial equipment is not supported : %s.
400SPECIAL_EQUIPMENT_NOT_AVAILABLEThe special equipment is no longer available.
400DUPLICATE_SPECIAL_EQUIPMENT_FOUNDDuplicate special equipments are not allowed.
400INVALID_FLIGHT_DETAILSAirline code of flight details is either missing or invalid.
400INVALID_FLIGHT_DETAILSFlight number of flight details is either missing or invalid.
400INVALID_LOYALTY_PROGRAMS Max allowed loyalty programs count is %s.
400Loyalty programs category code is either missing or invalid. Allowed values are Car, Air.
400Loyalty programs code is either missing or invalid.
400Loyalty programs membership code is either missing or invalid.
400Duplicate loyalty programs are not allowed.
400Traveler name does not match the loyalty card number.
400INVALID_FLIGHT_DETAILS Airline code of flight details is either missing or invalid.
400Flight number of flight details is either missing or invalid.
400INVALID_FRAUD_CHECK_IDFraudCheckId is either missing or invalid.
400ORDER_DECLINEDBooking failed. Order creation has been declined.
409CAR_NOT_AVAILABLEThe car is no longer available.
400CAR_RENTAL_OUT_OF_RANGEPickup or drop off date out of range.
400CAR_CANNOT_BE_BOOKEDThis car cannot be booked through Expedia at present.
409PRICE_INCREASEThe price for your trip has changed from %s %s to %s %s.
409PRICE_DECREASEThe price for your trip has changed from %s %s to %s %s.
500BOOKING_APPLICATION_ERRORBooking Failed. Application Error.
500BOOKING_NOT_CONFIRMEDProblem confirming your booking. Please call customer support. The tripNumber is %s.
400INVALID_DATESBooking Failed. Dates in the request are missing or in invalid format. Valid format is " YYYY-MM-DD."
400INVALID_PAYMENT_TOKENPayment token information is invalid.
400INVALID_TRAVELER_INFOTraveler information is either missing or invalid.
400INVALID_BROWSER_DATAInvalid Input. Please enter the full BrowserData. You must integrate 3dsv2 to do this booking, please contact your account manager for details.
400SOFT_DECLINE_ERRORBooking failed. Order creation has been declined.
400PARTNER_TRANSACTION_ID_MISSINGPartner Transaction Id in http headers is missing.
400INVALID_TRIP_START_DATEStart Date is in invalid format. Valid format is YYYY-MM-DD.
400INVALID_TRIP_END_DATEEnd Date is in invalid format. Valid format is YYYY-MM-DD.
400START_DATE_LATER_THAN_END_DATEStart Date should be before End Date.

Warning Codes

Common Warning Codes

CodeMessageDescription
BOOKED_WITH_PRICE_INCREASEBooking succeeded, but with a slightly higher price.Booking was successful, but the booked price was incrementally higher than the quoted price.

The difference in price is within the price increase limit per agreement with partner. If it was not the booking would fail due to the price increase.
BOOKED_WITH_PRICE_DECREASEBooking succeeded, but with a slightly lower price.Booking was successful, but the booked price was incrementally lower than the quoted price.

The difference in price is within the price decrease limit per agreement with partner. If it was not the booking would fail due to the price decrease.

API details

Here, you can explore the endpoint definitions for this API, then go to the API Explorer to try out all the XAP endpoints, download OpenAPI specs, or download our Postman collections. Testing with one or all of these options will give you an understanding of how the examples and schema definitions compare to the actual output.


Did you find this page helpful?
How can we improve this content?
Thank you for helping us improve!