Skip to main content

  • Important: Due to EU & UK Payments regulatory requirements, an additional security verification via Digital Signatures is required for certain API calls that are made by EU/UK sellers. Please refer to Digital Signatures for APIs to learn more on the impacted APIs and the process to create signature to be included in the HTTP payload.

  • OpenAPI Specification - Version 2.0 for all of our RESTful APIs will no longer be available starting April 5, 2023. We will continue leveraging OpenAPI Specification - Version 3.0 for new features in our RESTful APIs.

The Inventory API is used to create and manage inventory, and then to publish and manage this inventory on an eBay marketplace. There are also methods in this API that will convert eligible, active eBay listings into the Inventory API model.

inventory_item

Method NameHTTP MethodPathSummarySamples
bulkCreateOrReplaceInventoryItemPOST/bulk_create_or_replace_inventory_itemThis call is used by the seller to create and/or update up to 25 inventory item records.View bulkCreateOrReplaceInventoryItem - /bulk_create_or_replace_inventory_item
bulkGetInventoryItemPOST/bulk_get_inventory_itemThis call is used by the seller to retrieve up to 25 inventory item records.View bulkGetInventoryItem - /bulk_get_inventory_item
bulkUpdatePriceQuantityPOST/bulk_update_price_quantityThis call is used by the seller to update the total ship-to-home quantity of an inventory item and/or to update the price and/or quantity of that same inventory item in an actual live offer.View bulkUpdatePriceQuantity - /bulk_update_price_quantity
createOrReplaceInventoryItemPUT/inventory_item/{sku}This call creates a new inventory item record or updates an existing inventory item record.View createOrReplaceInventoryItem - /inventory_item/{sku}
deleteInventoryItemDELETE/inventory_item/{sku}This call is used to delete an inventory item record associated with a specified SKU.View deleteInventoryItem - /inventory_item/{sku}
getInventoryItemGET/inventory_item/{sku}This call retrieves the inventory item record for a given SKU.View getInventoryItem - /inventory_item/{sku}
getInventoryItemsGET/inventory_itemThis call retrieves all inventory item records defined for the seller's account.View getInventoryItems - /inventory_item

inventory_item:product_compatibility

Method NameHTTP MethodPathSummarySamples
createOrReplaceProductCompatibilityPUT/inventory_item/{sku}/product_compatibilityThis call is used by the seller to create or replace a list of products that are compatible with the inventory item.View createOrReplaceProductCompatibility - /inventory_item/{sku}/product_compatibility
deleteProductCompatibilityDELETE/inventory_item/{sku}/product_compatibilityThis call is used by the seller to delete the list of products that are compatible with the inventory item.View deleteProductCompatibility - /inventory_item/{sku}/product_compatibility
getProductCompatibilityGET/inventory_item/{sku}/product_compatibilityThis call is used by the seller to retrieve the list of products that are compatible with the inventory item.View getProductCompatibility - /inventory_item/{sku}/product_compatibility

inventory_item_group

Method NameHTTP MethodPathSummarySamples
createOrReplaceInventoryItemGroupPUT/inventory_item_group/{inventoryItemGroupKey}This call creates a new inventory item group or updates an existing inventory item group.View createOrReplaceInventoryItemGroup - /inventory_item_group/{inventoryItemGroupKey}
deleteInventoryItemGroupDELETE/inventory_item_group/{inventoryItemGroupKey}This call deletes the inventory item group for a given inventoryItemGroupKey value.View deleteInventoryItemGroup - /inventory_item_group/{inventoryItemGroupKey}
getInventoryItemGroupGET/inventory_item_group/{inventoryItemGroupKey}This call retrieves the inventory item group for a given inventoryItemGroupKey value.View getInventoryItemGroup - /inventory_item_group/{inventoryItemGroupKey}

listing

Method NameHTTP MethodPathSummarySamples
bulkMigrateListingPOST/bulk_migrate_listingThis call is used to convert existing eBay Listings to the corresponding Inventory API objects.View bulkMigrateListing - /bulk_migrate_listing

offer

Method NameHTTP MethodPathSummarySamples
bulkCreateOfferPOST/bulk_create_offerThis call creates multiple offers (up to 25) for specific inventory items on a specific eBay marketplace.View bulkCreateOffer - /bulk_create_offer
bulkPublishOfferPOST/bulk_publish_offerThis call is used to convert unpublished offers (up to 25) into published offers, or live eBay listings.View bulkPublishOffer - /bulk_publish_offer
createOfferPOST/offerThis call creates an offer for a specific product on a specific eBay marketplaceView createOffer - /offer
deleteOfferDELETE/offer/{offerId}This call deletes a specific published or unpublished offer.View deleteOffer - /offer/{offerId}
getListingFeesPOST/offer/get_listing_feesThis call is used to retrieve the expected listing fees for one to 250 unpublished offers.View getListingFees - /offer/get_listing_fees
getOfferGET/offer/{offerId}This call retrieves a specific offer.View getOffer - /offer/{offerId}
getOffersGET/offerThis call retrieves all existing offers for the specified SKU value.View getOffers - /offer
publishOfferPOST/offer/{offerId}/publish/This call is used to convert an unpublished offer into a published offer, or live eBay listing.View publishOffer - /offer/{offerId}/publish/
publishOfferByInventoryItemGroupPOST/offer/publish_by_inventory_item_group/This call is used to convert all unpublished offers associated with an inventory item group into a published offer.View publishOfferByInventoryItemGroup - /offer/publish_by_inventory_item_group/
updateOfferPUT/offer/{offerId}This call updates an existing published or unpublished offer.View updateOffer - /offer/{offerId}
withdrawOfferPOST/offer/{offerId}/withdrawThis call is used to end the eBay listing that is associated with the specified offer, but will not delete the Offer object.View withdrawOffer - /offer/{offerId}/withdraw
withdrawOfferByInventoryItemGroupPOST/offer/withdraw_by_inventory_item_groupThis call is used to end a multiple-variation eBay listing that is associated with the specified inventory item group.View withdrawOfferByInventoryItemGroup - /offer/withdraw_by_inventory_item_group

location

Method NameHTTP MethodPathSummarySamples
createInventoryLocationPOST/location/{merchantLocationKey}This call is used to create a store or warehouse location for the associated seller.View createInventoryLocation - /location/{merchantLocationKey}
deleteInventoryLocationDELETE/location/{merchantLocationKey}This call is used to delete the specified inventory location from the seller's account.View deleteInventoryLocation - /location/{merchantLocationKey}
disableInventoryLocationPOST/location/{merchantLocationKey}/disableThis call is used to disable the specified inventory location.View disableInventoryLocation - /location/{merchantLocationKey}/disable
enableInventoryLocationPOST/location/{merchantLocationKey}/enableThis call is used to enable a disabled inventory location.View enableInventoryLocation - /location/{merchantLocationKey}/enable
getInventoryLocationGET/location/{merchantLocationKey}This call is used to retrieve the details of the specified inventory location.View getInventoryLocation - /location/{merchantLocationKey}
getInventoryLocationsGET/locationThis call is used to retrieve a list of inventory locations as defined by the seller.View getInventoryLocations - /location
updateInventoryLocationPOST/location/{merchantLocationKey}/update_location_detailsThis call is used to update the details of a specified inventory location.View updateInventoryLocation - /location/{merchantLocationKey}/update_location_details