Skip to main content

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

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

This method is supported in Sandbox environment. To access the endpoint, just replace the api.ebay.com root URI with api.sandbox.ebay.com

URI parameters

ParameterTypeDescription
skustringThis path parameter specifies the SKU (stock keeping unit) of the inventory item associated with the product compatibility list being retrieved.

Use the getInventoryItems method to retrieve SKU values.

Occurrence: Required

HTTP request headers

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

All other standard RESTful request headers are optional. For more information on standard RESTful request headers, see the HTTP request headers- opens rest request components page table.

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.

Request payload

This call has no payload.

Request fields

This call has no field definitions.

Output

HTTP response headers

This call has no response headers.

Response payload

Response fields

Output container/fieldTypeDescription
compatibleProductsarray of CompatibleProduct

This 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.compatibilityPropertiesarray of NameValueList

This 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. Each motor vehicle is defined through a separate set of name/value pairs. In the name field, the vehicle aspect (such as 'make', 'model', 'year', 'trim', or 'engine') will be identified, and the value field will be used to identify the value of each aspect.

The getCompatibilityProperties method of the Taxonomy API can be used to retrieve applicable vehicle aspect names for a specified category, and the getCompatibilityPropertyValues method of the Taxonomy API can be used to retrieve possible values for these same vehicle aspect names.

Below is an example of identifying one motor vehicle using the compatibilityProperties container:

"compatibilityProperties" : [
  {
   "name" : "make",
   "value" : "Subaru"
  },
  {
   "name" : "model",
   "value" : "GL"
  },
  {
   "name" : "year",
   "value" : "1983"
  },
  {
   "name" : "trim",
   "value" : "Base Wagon 4-Door"
  },
  {
   "name" : "engine",
   "value" : "1.8L Turbocharged"
  }
]


Typically, the make, model, and year of the motor vehicle are always required, with the trim and engine being necessary sometimes, but it will be dependent on the part or accessory, and on the vehicle class.

Note: The productFamilyProperties container is deprecated and should no longer be used. The compatibilityProperties container should be used instead.

Occurrence: Conditional

compatibleProducts.compatibilityProperties.namestring

This string value identifies the motor vehicle aspect, such as 'make', 'model', 'year', 'trim', and 'engine'. Typically, the make, model, and year of the motor vehicle are always required, with the trim and engine being necessary sometimes, but it will be dependent on the part or accessory, and on the vehicle class.

The getCompatibilityProperties method of the Taxonomy API can be used to retrieve applicable vehicle aspect names for a specified category.

Occurrence: Conditional

compatibleProducts.compatibilityProperties.valuestring

This string value identifies the motor vehicle aspect specified in the corresponding name field. For example, if the name field is 'make', this field may be 'Toyota', or if the name field is 'model', this field may be 'Camry'.

The getCompatibilityPropertyValues method of the Taxonomy API can be used to retrieve possible values for vehicle aspect names.

Occurrence: Conditional

compatibleProducts.notesstring

This field is used by the seller to input any notes pertaining to the compatible vehicle list being defined. 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

compatibleProducts.productFamilyPropertiesProductFamilyProperties

Important! The productFamilyProperties container is deprecated and should no longer be used. The compatibilityProperties container should be used instead.

Occurrence: Conditional

compatibleProducts.productFamilyProperties.enginestring

Important! The productFamilyProperties container is no longer supported.

Occurrence: Conditional

compatibleProducts.productFamilyProperties.makestring

Important! The productFamilyProperties container is no longer supported.

Occurrence: Conditional

compatibleProducts.productFamilyProperties.modelstring

Important! The productFamilyProperties container is no longer supported.

Occurrence: Conditional

compatibleProducts.productFamilyProperties.trimstring

Important! The productFamilyProperties container is no longer supported.

Occurrence: Conditional

compatibleProducts.productFamilyProperties.yearstring

Important! The productFamilyProperties container is no longer supported.

Occurrence: Conditional

compatibleProducts.productIdentifierProductIdentifier

This container is used in a createOrReplaceProductCompatibility call to identify a motor vehicle that is compatible with the inventory item. The user specifies either an eBay Product ID (ePID) or K-Type value to identify a vehicle, and if the motor vehicle is found in the eBay product catalog, the motor vehicle properties (make, model, year, trim, engine) will automatically be populated for the vehicle. If the vehicle cannot be found using these identifiers, the vehicle will not be added to the compatible vehicle list.

Note that this container will not be returned in the getProductCompatibility call.

Occurrence: NA

compatibleProducts.productIdentifier.epidstring

This 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.

Occurrence: NA

compatibleProducts.productIdentifier.gtinstring

This 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 is for future use.

Occurrence: NA

compatibleProducts.productIdentifier.ktypestring

This 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 AU, DE, ES, FR, IT, and UK marketplaces support the use of K Type Numbers.

Occurrence: NA

skustring

The seller-defined SKU value of the inventory item that will be associated with the compatible vehicles.

Note: This field is not applicable to the createOrReplaceProductCompatibility method, as the SKU value for the inventory item is passed in as part of the call URI and not in the request payload. It is always returned with the getProductCompatibility method.

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}
25710API_INVENTORYREQUESTWe didn't find the resource/entity you are requesting. Please verify the request

Warnings

This call has no warnings.

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 A*****0.

GEThttps://api.ebay.com/sell/inventory/v1/inventory_item/A*****0/product_compatibility

Output

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

Got thoughts? Click the feedback button – your insights help us improve!