inventory APIv1.6.0

getProductCompatibility

GET
/inventory_item/{sku}/product_compatibility
This call is used by the seller to retrieve the list of products that are compatible with the inventory item. The SKU value for the inventory item is passed into the call URI, and a successful call with return the compatible vehicle list associated with this inventory item. Product compatibility is currently only applicable to motor vehicle parts and accessory categories, but more categories may be supported in the future.

Input

Resource URI (production)

GET https://api.ebay.com/sell/inventory/v1/inventory_item/{sku}/product_compatibility

URI parameters

ParameterTypeDescription
skustringA SKU (stock keeping unit) is an unique identifier defined by a seller for a product

Occurrence: Required

HTTP request headers

All requests made to eBay REST operations require you to provide the Authorization HTTP header for authentication authorization.

OAuth scope

This request requires an access token created with the authorization code grant flow, using one or more scopes from the following list (please check your Application Keys page for a list of OAuth scopes available to your application):

https://api.ebay.com/oauth/api_scope/sell.inventory.readonly

https://api.ebay.com/oauth/api_scope/sell.inventory

See OAuth access tokens for more information.

Output

HTTP response headers

Output container/fieldTypeDescription
compatibleProductsarray of CompatibleProductThis container consists of an array of motor vehicles (make, model, year, trim, engine) that are compatible with the motor vehicle part or accessory specified by the sku value.

Occurrence: Always

compatibleProducts.productFamilyPropertiesProductFamilyPropertiesThis container consists of an array of motor vehicles that are compatible with the motor vehicle part or accessory specified by the SKU value in the call URI. These motor vehicles are identified by properties such as make, model, year, trim, and engine type.

Either the productIdentifier or the productFamilyProperties container (or both) can be used to specify one or more motor vehicles that are compatible with the inventory item. A separate productFamilyProperties is needed to specify each compatible motor vehicle. Typically, the make, model, and year of the motor vehicle are required (with trim and engine being optional sometimes), but it will be dependent on the part or accessory, and on the vehicle class.

Note: The ProductIdentifier type is for future use, so the productFamilyProperties container is currently the only way to specify a compatible motor vehicle.

Occurrence: Always

compatibleProducts.productFamilyProperties.makestringThis field indicates the make of the vehicle (e.g. Toyota).

Occurrence: Always

compatibleProducts.productFamilyProperties.modelstringThis field indicates the model of the vehicle (e.g. Camry).

Occurrence: Always

compatibleProducts.productFamilyProperties.yearstringThis field indicates the year of the vehicle (e.g. 2016).

Occurrence: Always

compatibleProducts.productFamilyProperties.trimstringThis field indicates the trim of the vehicle (e.g. 2-door Coupe). This field is conditionally required, but should be supplied if known/applicable.

Occurrence: Conditional

compatibleProducts.productFamilyProperties.enginestringThis field indicates the specifications of the engine, including its size, block type, and fuel type. An example is 2.7L V6 gas DOHC naturally aspirated. This field is conditionally required, but should be supplied if known/applicable.

Occurrence: Conditional

compatibleProducts.productIdentifierProductIdentifierThis container is used in a createOrReplaceProductCompatibility call to identify a motor vehicle that is compatible with the inventory item. If the motor vehicle is found in the eBay catalog, the motor vehicle properties (the properties in the productFamilyProperties) will automatically be populated for the vehicle. This container is not applicable to the getProductCompatibility call.

Either the productIdentifier or the productFamilyProperties container (or both) can be used to specify one or more motor vehicles that are compatible with the inventory item. If the productIdentifier container is used, the product identifiers that are passed in that container must match vehicles in the eBay catalog in order for that vehicle to be added to the compatible vehicle list.

Note: The ProductIdentifier type is for future use, so the productFamilyProperties container is currently the only way to specify a compatible motor vehicle. Once this type becomes available for use, it will only be used to identify motor vehicles in the eBay catalog. However, it is possible that the Product Compatibility feature is expanded to other (non-vehicle) products in the future.

Occurrence: NA

compatibleProducts.productIdentifier.epidstringThis field can be used if the seller already knows the eBay catalog product ID (ePID) associated with the motor vehicle that is to be added to the compatible product list. If this eBay catalog product ID is found in the eBay product catalog, the motor vehicle properties (e.g. make, model, year, engine, and trim) will automatically get picked up for that motor vehicle.

Note: This field and the productIdentifier type are for future use only.

Occurrence: NA

compatibleProducts.productIdentifier.gtinstringThis field can be used if the seller knows the Global Trade Item Number for the motor vehicle that is to be added to the compatible product list. If this GTIN value is found in the eBay product catalog, the motor vehicle properties (e.g. make, model, year, engine, and trim will automatically get picked up for that motor vehicle.

Note: This field and the productIdentifier type are for future use only.

Occurrence: NA

compatibleProducts.productIdentifier.ktypestringThis field can be used if the seller knows the K Type Number for the motor vehicle that is to be added to the compatible product list. If this K Type value is found in the eBay product catalog, the motor vehicle properties (e.g. make, model, year, engine, and trim) will automatically get picked up for that motor vehicle.

Only the DE, UK, and AU sites support the use of K Type Numbers.

Note: This field and the productIdentifier type is for future use only.

Occurrence: NA

compatibleProducts.notesstringThis field is optionally used by the seller to input any notes pertaining to the parts compatibility being specified. The seller might use this field to specify the placement of the part on a vehicle or other applicable information. This field will only be returned if specified by the seller.

Max Length: 500

Occurrence: Conditional

skustringThis is the seller-defined SKU value of the inventory item that will be associated with the compatible vehicles. This field is not applicable to the createOrReplaceProductCompatibility call, but it is always returned with the getProductCompatibility call. For the the createOrReplaceProductCompatibility call, the SKU value for the inventory item is actually passed in as part of the call URI, and not in the request payload.

Occurrence: Always

HTTP status codes

This call can return one of the following HTTP status codes. For an overview of the status codes, see HTTP status codes in Using eBay RESTful APIs.

StatusMeaning
200Success
400Bad Request
404Not Found
500Internal Server Error

Error codes

For more on errors, plus the codes of other common errors, see Handling errors.

CodeDomainCategoryMeaning
25001API_INVENTORYAPPLICATIONA system error has occurred. {additionalInfo}
25702API_INVENTORYREQUEST{skuValue} could not be found or is not available in the system.
25709API_INVENTORYREQUESTInvalid value for {fieldName}. {additionalInfo}

Samples

New to making API calls? Please see Making a Call.

Note: Identifiers, such as order IDs or user IDs, and personal data in these samples might be anonymized or may no longer be active on eBay. If necessary, substitute current, relevant eBay data in your requests.

Sample 1: Retrieving a Product Compatibility List

This call will retrieve a product compatibility list that is associated with a particular SKU.

Input

The SKU value of the product whose product compatibility list will be retrieved is input into the end of the call URI. In this case, the SKU value for the product is Al-8730.
GET
https://api.ebay.com/sell/inventory/v1/inventory_item/Al-8730/product_compatibility

Output

Three compatible vehicles are returned for the product, 'Al-8730'. The attributes are given for each of these three vehicles. The SKU value is also returned in the response.