openapi: 3.0.0
info:
title: eBay Account Advertising_eligibility Item API
description: The <b>Account API</b> gives sellers the ability to configure their eBay seller accounts, including the seller's policies (eBay business policies and seller-defined custom policies), opt in and out of eBay seller programs, configure sales tax tables, and get account information. <br><br>For details on the availability of the methods in this API, see <a href="/api-docs/sell/account/overview.html#requirements">Account API requirements and restrictions</a>.
contact:
name: eBay Inc,
license:
name: eBay API License Agreement
url: https://go.developer.ebay.com/api-license-agreement
version: v1.9.2
servers:
- url: https://api.ebay.com{basePath}
description: Production
variables:
basePath:
default: /sell/account/v1
tags:
- name: Item
paths:
/item/{item_id}:
get:
tags:
- Item
description: This method retrieves the details of a specific item, such as description, price, category, all item aspects, condition, return policies, seller feedback and score, shipping options, shipping costs, estimated delivery, and other information the buyer needs to make a purchasing decision.<br><br>The Buy APIs are designed to let you create an eBay shopping experience in your app or website. This means you will need to know when something, such as the availability, quantity, etc., has changed in any eBay item you are offering. This is easily achieved by setting the <b>fieldgroups</b> URI parameter to one of the following values:<ul><li><code>COMPACT</code><br>Reduces the response to only those fields necessary in order to determine if any item detail has changed. This field group <b>must</b> be used alone.</li><li><code>PRODUCT</code><br>Adds fields to the default response that return information about the product/item. This field group may also be used in conjunction with <code>ADDITIONAL_SELLER_DETAILS</code>.</li><li><code>ADDITIONAL_SELLER_DETAILS</code><br>Adds an additional field to the response that returns the seller's user ID. This field group may also be used in conjunction with <code>PRODUCT</code>.</li></ul>For additional information, refer to <a href="/api-docs/buy/browse/resources/item/methods/getItem#uri.fieldgroups">fieldgroups</a>.<h3>Restrictions</h3>For a list of supported sites and other restrictions, refer to <a href="/api-docs/buy/browse/overview.html#API">API Restrictions</a>.<br><br><span class="tablenote"><b>eBay Partner Network:</b> In order to be commissioned for your sales, you must use the URL returned in the <code>itemAffiliateWebUrl</code> field to forward your buyer to the ebay.com site.</span>
operationId: getItem
parameters:
- name: fieldgroups
in: query
description: This parameter controls what is returned in the response. If this field is not set, the method returns all the details of the item.<br><br><span class="tablenote"><b>Note:</b> Multiple <b>fieldgroups</b> can be set and applied simultaneously. However, <b>COMPACT</b> <b>must</b> be used alone. Otherwise, an error will occur.</span><br><b>Valid Values:</b><ul><li><b>PRODUCT</b><br>This field group adds the <a href="/api-docs/buy/browse/resources/item/methods/getItem#response.product">product</a> container to the response.</li><li><b>COMPACT</b></br>This field group returns only the following fields which let you quickly check if the availability or price of the item has changed, if the item has been revised by the seller, or if an item's top-rated plus status has changed for items you have stored.<ul><li><b>itemId</b></li><li><b>bidCount</b></li><li><b>currentBidPrice</b></li><li><b>eligibleForInlineCheckout</b></li><li><b>estimatedAvailabilities</b></li><li><b>gtin</b></li><li><b>itemAffiliateWebURL</b></li><li><b>itemCreationDate</b></li><li><b>ItemWebURL</b></li><li><b>legacyItemId</b></li><li><b>minimumPriceToBid</b></li><li><b>price</b></li><li><b>priorityListing</b></li><li><b>reservePriceMet</b></li><li><b>sellerItemRevision</b></li><li><b>shippingOptions</b></li><li><b>taxes</b></li><li><b>topRatedBuyingExperience</b></li><li><b>uniqueBidderCount</b></li></ul>For Example:<br>To determine if a stored item's information is current, perform the following:<ol><li>Pass in the item ID and set <code>fieldgroups</code> to <code>COMPACT</code>.<pre>item/v1|4**********8|0?fieldgroups=COMPACT</pre></li><li>Do one of the following:<ul><li>If <b>sellerItemRevision</b> is returned and a revision number for this item <i>has not</i> been stored, record the number and pass in the item ID in the <b>getItem</b> method to retrieve the most recent information.</li><li>If the revision number is different from the value you have stored, update the value and pass in the item ID in the <b>getItem</b> method to retrieve the most recent information.</li><li>If <code>sellerItemRevision</code> is <i>not</i> returned or has not changed, where needed, update the item information with the information returned in the response.</li></ul></li></ol></li><li><b>ADDITIONAL_SELLER_DETAILS</b><br>This adds the <a href="/api-docs/buy/browse/resources/item/methods/getItem#response.seller.userId">userId</a> field to the response.</li></ul>
required: false
schema:
type: string
- name: item_id
in: path
description: 'This path parameter specifies the unique RESTful identifier of the item being retrieved. <br><br><b>RESTful Item ID Format: </b><code>v1</code>|<code><i>#</i></code>|<code><i>#</i></code><br><br>For a single SKU listing, pass in the item ID: <pre>v1|2**********2|0</pre>For a multi-SKU listing, pass in the identifier of the variation:<pre>v1|1**********2|4**********2</pre><br>For more information about item IDs for RESTful APIs, refer to <a href="/api-docs/buy/static/api-browse.html#Legacy" target="_blank">Item ID legacy API compatibility overview</a> in the <a href="/api-docs/buy/static/buying-ig-landing.html" target="_blank">Buying Integration Guide</a>.'
required: true
schema:
type: string
- name: X-EBAY-C-ENDUSERCTX
in: header
description: This header is required to support revenue sharing for eBay Partner Network and to improve the accuracy of shipping and delivery time estimations.<br><br>For additional information, refer to <a href="/api-docs/buy/static/api-browse.html#Headers" target="_blank ">Use request headers</a> in the <a href="/api-docs/buy/static/buying-ig-landing.html" target="_blank">Buying Integration Guide</a>.
required: false
schema:
type: string
- name: X-EBAY-C-MARKETPLACE-ID
in: header
description: This header identifies the seller's eBay marketplace. It is required for all marketplaces outside of the US.<br><br><span class="tablenote"><b>Note:</b> If a marketplace ID value is not provided, the default value of <code>EBAY_US</code> is used.</span><br>See <a href="/api-docs/buy/browse/types/ba:MarketplaceIdEnum" target="_blank">MarketplaceIdEnum</a> for a list of supported marketplaces.
required: false
schema:
type: string
- name: Accept-Language
in: header
description: This header is used to indicate the natural language and locale preferred by the user for the response.<br><br>This header is required when targeting a specific locale of a marketplace that supports multiple locales. For example:<ul><li>When targeting the French locale of the Belgium marketplace, it is required to pass in <code>fr-BE</code> to specify this. If this locale is not specified, the language will default to Dutch.</li><li>When targeting the French locale of the Canadian marketplace, it is required to pass in <code>fr-CA</code> to specify this. If this locale is not specified, the language will default to English.</li></ul>
required: false
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/Item'
x-response-codes:
errors:
'11502':
domain: API_BROWSE
category: APPLICATION
description: There was a problem extracting product information for this Item. Please try again.
'11508':
domain: API_BROWSE
category: APPLICATION
description: This seller is currently away. If you make a purchase, please allow additional time for your order to be processed.
'11509':
domain: API_BROWSE
category: APPLICATION
description: This seller is currently away until {sellerReturnDate}. If you make a purchase, please allow additional time for your order to be processed.
'400':
description: Bad Request
x-response-codes:
errors:
'11001':
domain: API_BROWSE
category: REQUEST
description: The specified item ID was not found.
'11002':
domain: API_BROWSE
category: REQUEST
description: The specified item group was not found.
'11004':
domain: API_BROWSE
category: REQUEST
description: The item is not available for purchase. This can be for many reasons, such as when the listing is being updated by the seller. Wait a few minutes and try the call again.
'11005':
domain: API_BROWSE
category: REQUEST
description: The item group ID is invalid. Use {itemHref} to get the item details.
'11008':
domain: API_BROWSE
category: REQUEST
description: The item group is not available. This can be for many reasons, such as when the listing is being updated by the seller. Wait a few minutes and try the call again.
'11011':
domain: API_BROWSE
category: REQUEST
description: 'The marketplace value {marketplaceId} is not supported. The supported values are: {allowedMarketplaces}'
'11012':
domain: API_BROWSE
category: REQUEST
description: The specified item IDs are invalid, or the format of the specified values are invalid.
'11013':
domain: API_BROWSE
category: REQUEST
description: The specified group IDs are invalid, or the format of the specified values are invalid.
'11014':
domain: API_BROWSE
category: REQUEST
description: An item_ids and an item_group_ids list cannot be used at same time. Please use only one of these lists.
'11015':
domain: API_BROWSE
category: REQUEST
description: The maximum number of item ids has been exceeded. Please reduce the number of item ids to {maxAllowedItemIds} or less.
'11016':
domain: API_BROWSE
category: REQUEST
description: The maximum number of item group IDs has been exceeded. Please reduce the number of item group ids to {maxAllowedItemGroupIds} or less.
'11018':
domain: API_BROWSE
category: REQUEST
description: The specified fieldgroups are invalid. The COMPACT fieldgroup cannot be combined with another fieldgroup.
'11501':
domain: API_BROWSE
category: REQUEST
description: 'The ''fieldgroups'' value(s) are invalid: {fieldgroups}. The supported fieldgroups are: {supportedFieldgroups}'
'404':
description: Not Found
'409':
description: Conflict
'500':
description: Internal Server Error
x-response-codes:
errors:
'11000':
domain: API_BROWSE
category: APPLICATION
description: There was a problem with an eBay internal system or process. Contact eBay developer support for assistance.
security:
- api_auth:
- https://api.ebay.com/oauth/api_scope
/item/get_item_by_legacy_id:
get:
tags:
- Item
description: This method is a bridge between the eBay legacy APIs, such as <b>Shopping</b> and <b>Finding</b>, and the eBay Buy APIs. There are differences between how legacy APIs and RESTful APIs return the identifier of an "item" and what the item ID represents. This method lets you use the legacy item ids retrieve the details of a specific item, such as description, price, and other information the buyer needs to make a purchasing decision. It also returns the RESTful <b>item_id</b>, which you can use with all the Buy API methods.<br><br>For additional information about how to use legacy ids with the Buy APIs, refer to <a href="/api-docs/buy/static/api-browse.html#Legacy" target="_blank">Item ID legacy API compatibility overview</a> in the Buying Integration guide.</br><br>This method returns the item details and requires you to pass in either the <b>item_id</b> of a non-variation item or the <b>item_id</b> values for both the parent and child of an item group.<br><br><span class="tablenote"><b>Note:</b> An item group is an item that has various aspect differences, such as color, size, storage capacity, etc.</span></br>When an item group is created, one of the item variations, such as the red shirt size L, is chosen as the "parent". All other items in the group are the children, such as the blue shirt size L, red shirt size M, etc.<br><br>The <b>fieldgroups</b> URI parameter lets you control what is returned in the response:<ul><li>Setting <b>fieldgroups</b> to <code>PRODUCT</code> adds additional fields to the default response that return information about the product of the item.</li><li>Setting the <b>fieldgroups</b> to <code>ADDITIONAL_SELLER_DETAILS</code> adds an additional field to the response that returns the seller's user ID.</li></ul>These <b>fieldgroups</b> can be used independently or at the same time. For additional information, refer to <a href="/api-docs/buy/browse/resources/item/methods/getItemByLegacyId#uri.fieldgroups">fieldgroups</a>.<h3>Restrictions</h3>For a list of supported sites and other restrictions, refer to <a href="/api-docs/buy/browse/overview.html#API">API Restrictions</a>.<br><br><span class="tablenote"><b>eBay Partner Network:</b> In order to be commissioned for your sales, you must use the URL returned in the <code>itemAffiliateWebUrl</code> field to forward your buyer to the ebay.com site.</span>
operationId: getItemByLegacyId
parameters:
- name: fieldgroups
in: query
description: This field controls what is returned in the response. If this field is not set, the method returns all details about the item. Multiple <code>fieldgroups</code> can be set.<br><br><b>Valid Values:</b><ul><li> <b>PRODUCT</b><br>This field group adds the <a href="/api-docs/buy/browse/resources/item/methods/getItemByLegacyId#response.product">product</a> container to the response. </li><li><b>ADDITIONAL_SELLER_DETAILS</b><br>This field group adds the <a href="/api-docs/buy/browse/resources/item/methods/getItemByLegacyId#response.seller.userId">userId</a> field to the response.</li></ul>
required: false
schema:
type: string
- name: legacy_item_id
in: query
description: This query parameter is the unique identifier that specifies the item being retrieved.<br><br><span class="tablenote"><b> Note:</b> When passing in the ID for a multi-variation listing, you must also use the <code>legacy_variation_id</code> field and pass in the ID of the specific item variation. If not, all variation within the multi-SKU listing will be retrieved.</span></li></ul><br>The following is an example of using the value of the <b>ItemID</b> field for a specific item to get the RESTful <code>itemId</code> value.<pre><code>browse/v1/item/get_item_by_legacy_id?legacy_item_id=1**********9</code></pre>
required: true
schema:
type: string
- name: legacy_variation_id
in: query
description: 'This query parameter specifies the legacy item ID of a specific item in a multi-variation listing, such as that for the <i>red shirt size L</i> item.<br><br><div class="msgbox_important"><p class="msgbox_importantInDiv" data-mc-autonum="<b><span style="color: #dd1e31;" class="mcFormatColor">Important! </span></b>"><span class="autonumber"><span><b><span style="color: #dd1e31;" class="mcFormatColor">Important!</span></b></span></span> A <code>legacy_item_id</code> value must always be passed in when specifying a <code>legacy_variation_id</code> value.</p></div>'
required: false
schema:
type: string
- name: legacy_variation_sku
in: query
description: 'This query parameter specifies the legacy SKU of an item. SKUs are the unique identifiers of an item created by the seller.<br><br>The following is an example of using the value of the <code>ItemID</code> and <code>SKU</code> fields to get the RESTful <code>itemId</code> value.<pre><code>browse/v1/item/get_item_by_legacy_id?legacy_item_id=1**********9&legacy_variation_sku=V**********M</code></pre><div class="msgbox_important"><p class="msgbox_importantInDiv" data-mc-autonum="<b><span style="color: #dd1e31;" class="mcFormatColor">Important! </span></b>"><span class="autonumber"><span><b><span style="color: #dd1e31;" class="mcFormatColor">Important!</span></b></span></span> A <code>legacy_item_id</code> value must always be passed in when specifying a <code>legacy_variation_sku</code> value.</p></div>'
required: false
schema:
type: string
- name: X-EBAY-C-ENDUSERCTX
in: header
description: This header is required to support revenue sharing for eBay Partner Network and to improve the accuracy of shipping and delivery time estimations.<br><br>For additional information, refer to <a href="/api-docs/buy/static/api-browse.html#Headers" target="_blank ">Use request headers</a> in the <a href="/api-docs/buy/static/buying-ig-landing.html" target="_blank">Buying Integration Guide</a>.
required: false
schema:
type: string
- name: X-EBAY-C-MARKETPLACE-ID
in: header
description: This header identifies the seller's eBay marketplace. It is required for all marketplaces outside of the US.<br><br><span class="tablenote"><b>Note:</b> If a marketplace ID value is not provided, the default value of <code>EBAY_US</code> is used.</span><br>See <a href="/api-docs/buy/browse/types/ba:MarketplaceIdEnum" target="_blank">MarketplaceIdEnum</a> for a list of supported marketplaces.
required: false
schema:
type: string
- name: Accept-Language
in: header
description: This header is used to indicate the natural language and locale preferred by the user for the response.<br><br>This header is required when targeting a specific locale of a marketplace that supports multiple locales. For example:<ul><li>When targeting the French locale of the Belgium marketplace, it is required to pass in <code>fr-BE</code> to specify this. If this locale is not specified, the language will default to Dutch.</li><li>When targeting the French locale of the Canadian marketplace, it is required to pass in <code>fr-CA</code> to specify this. If this locale is not specified, the language will default to English.</li></ul>
required: false
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/Item'
x-response-codes:
errors:
'11502':
domain: API_BROWSE
category: APPLICATION
description: There was a problem extracting product information for this Item. Please try again.
'11508':
domain: API_BROWSE
category: APPLICATION
description: This seller is currently away. If you make a purchase, please allow additional time for your order to be processed.
'11509':
domain: API_BROWSE
category: APPLICATION
description: This seller is currently away until {sellerReturnDate}. If you make a purchase, please allow additional time for your order to be processed.
'400':
description: Bad Request
x-response-codes:
errors:
'11003':
domain: API_BROWSE
category: REQUEST
description: The specified legacy item ID was not found.
'11004':
domain: API_BROWSE
category: REQUEST
description: The item is not available for purchase. This can be for many reasons, such as when the listing is being updated by the seller. Wait a few minutes and try the call again.
'11006':
domain: API_BROWSE
category: REQUEST
description: The legacy ID is invalid. Use {itemGroupHref} to get the item group details.
'11009':
domain: API_BROWSE
category: REQUEST
description: The legacy variation sku is invalid.
'11010':
domain: API_BROWSE
category: REQUEST
description: You cannot submit legacy_variation_sku and legacy_variation_id in the same request. For help, see the documentation.
'11011':
domain: API_BROWSE
category: REQUEST
description: 'The marketplace value {marketplaceId} is not supported. The supported values are: {allowedMarketplaces}'
'11501':
domain: API_BROWSE
category: REQUEST
description: 'The ''fieldgroups'' value(s) are invalid: {fieldgroups}. The supported fieldgroups are: {supportedFieldgroups}'
'404':
description: Not Found
'409':
description: Conflict
'500':
description: Internal Server Error
x-response-codes:
errors:
'11000':
domain: API_BROWSE
category: APPLICATION
description: There was a problem with an eBay internal system or process. Contact eBay developer support for assistance.
security:
- api_auth:
- https://api.ebay.com/oauth/api_scope
/item/:
get:
tags:
- Item
description: 'This method retrieves the details about specific items that buyers need to make a purchasing decision.<br><br><span class="tablenote"><b>Note:</b> This is a <a href="/api-docs/static/versioning.html#limited " target="_blank"><img src="/cms/img/docs/partners-api.svg" class="legend-icon partners-icon" title="Limited Release" alt="Limited Release" />(Limited Release)</a> available only to select Partners.<br><br>For this method, only the following fields are returned: <code>bidCount</code>, <code>currentBidPrice</code>, <code>eligibleForInlineCheckout</code>, <code>enabledForGuestCheckout</code>, <code>estimatedAvailabilities</code>, <code>gtin</code>, <code>itemAffiliateWebUrl</code>, <code>itemCreationDate</code>, <code>itemId</code>, <code>itemWebUrl</code>, <code>legacyItemId</code>, <code>minimumPriceToBid</code>, <code>price</code>, <code>priorityListing</code>, <code>reservePriceMet</code>, <code>sellerItemRevision</code>, <code>taxes</code>, <code>topRatedBuyingExperience</code>, and <code>uniqueBidderCount</code>.<br><br>The array <code>shippingOptions</code>, which comprises multiple fields, is also returned.</span><h3>Restrictions</h3>For a list of supported sites and other restrictions, refer to <a href="/api-docs/buy/browse/overview.html#API">API Restrictions</a>.<br><br><span class="tablenote"><b>eBay Partner Network:</b> In order to be commissioned for your sales, you must use the URL returned in the itemAffiliateWebUrl field to forward your buyer to the ebay.com site.'
operationId: getItems
parameters:
- name: item_ids
in: query
description: 'A comma separated list of the unique identifiers of the items to retrieve (maximum 20).<br><br><span class="tablenote"><b>Note:</b> In any given request, either <code>item_ids</code> <b>or</b> <code>item_group_ids</code> can be retrieved. Attempting to retrieve both will result in an error.</span><br><b>RESTful Item ID Format: </b><code>v1</code>|<code><i>#</i></code>|<code><i>#</i></code><br><br>For a single SKU listing, pass in the item ID: <pre>v1|2**********2|0</pre>For a multi-SKU listing, pass in the identifier of the variation:<pre>v1|1**********2|4**********2</pre><br>For more information about item IDs for RESTful APIs, refer to <a href="/api-docs/buy/static/api-browse.html#Legacy" target="_blank">Item ID legacy API compatibility overview</a> in the <a href="/api-docs/buy/static/buying-ig-landing.html" target="_blank">Buying Integration Guide</a>.'
required: false
schema:
type: string
- name: item_group_ids
in: query
description: A comma separated list of the unique identifiers of the item groups being retrieved (maximum 10).<br><br><span class="tablenote"><b>Note:</b> In any given request, either <code>item_ids</code> <b>or</b> <code>item_group_ids</code> can be retrieved. Attempting to retrieve both will result in an error.</span><br><b>RESTful Group Item ID Format:</b> <code>############</code><br><br>For example:<pre>3**********9</pre>
required: false
schema:
type: string
- name: X-EBAY-C-ENDUSERCTX
in: header
description: This header is required to support revenue sharing for eBay Partner Network and to improve the accuracy of shipping and delivery time estimations.<br><br>For additional information, refer to <a href="/api-docs/buy/static/api-browse.html#Headers" target="_blank ">Use request headers</a> in the <a href="/api-docs/buy/static/buying-ig-landing.html" target="_blank">Buying Integration Guide</a>.
required: false
schema:
type: string
- name: X-EBAY-C-MARKETPLACE-ID
in: header
description: This header identifies the seller's eBay marketplace. It is required for all marketplaces outside of the US.<br><br><span class="tablenote"><b>Note:</b> If a marketplace ID value is not provided, the default value of <code>EBAY_US</code> is used.</span><br>See <a href="/api-docs/buy/browse/types/ba:MarketplaceIdEnum" target="_blank">MarketplaceIdEnum</a> for a list of supported marketplaces.
required: false
schema:
type: string
- name: Accept-Language
in: header
description: This header is used to indicate the natural language and locale preferred by the user for the response.<br><br>This header is required when targeting a specific locale of a marketplace that supports multiple locales. For example:<ul><li>When targeting the French locale of the Belgium marketplace, it is required to pass in <code>fr-BE</code> to specify this. If this locale is not specified, the language will default to Dutch.</li><li>When targeting the French locale of the Canadian marketplace, it is required to pass in <code>fr-CA</code> to specify this. If this locale is not specified, the language will default to English.</li></ul>
required: false
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/Items'
x-response-codes:
errors:
'11502':
domain: API_BROWSE
category: APPLICATION
description: There was a problem extracting product information for this item. Please try again.
'11508':
domain: API_BROWSE
category: APPLICATION
description: This seller is currently away. If you make a purchase, please allow additional time for your order to be processed.
'11509':
domain: API_BROWSE
category: APPLICATION
description: This seller is currently away until {sellerReturnDate}. If you make a purchase, please allow additional time for your order to be processed.
'400':
description: Bad Request
x-response-codes:
errors:
'11001':
domain: API_BROWSE
category: REQUEST
description: The specified item ID was not found.
'11002':
domain: API_BROWSE
category: REQUEST
description: The specified item group was not found.
'11004':
domain: API_BROWSE
category: REQUEST
description: The item group is not available. This can be for many reasons, such as when the listing is being updated by the seller. Wait a few minutes and try the call again.
'11005':
domain: API_BROWSE
category: REQUEST
description: The item group ID is invalid. Use {itemHref} to get the item details.
'11008':
domain: API_BROWSE
category: REQUEST
description: The item group is not available. This can be for many reasons, such as when the listing is being updated by the seller. Wait a few minutes and try the call again.
'11011':
domain: API_BROWSE
category: REQUEST
description: 'The marketplace value {marketplaceId} is not supported. The supported values are: {allowedMarketplaces}'
'11012':
domain: API_BROWSE
category: REQUEST
description: The specified item IDs are invalid, or the format of the specified values are invalid.
'11013':
domain: API_BROWSE
category: REQUEST
description: The specified group IDs are invalid, or the format of the specified values are invalid.
'11014':
domain: API_BROWSE
category: REQUEST
description: An item_ids and an item_group_ids list cannot be used at same time. Please use only one of these lists.
'11015':
domain: API_BROWSE
category: REQUEST
description: The maximum number of item IDs has been exceeded. Please reduce the number of item IDs to {maxAllowedItemIds} or less.
'11016':
domain: API_BROWSE
category: REQUEST
description: The maximum number of item group IDs has been exceeded. Please reduce the number of item group ids to {maxAllowedItemGroupIds} or less.
'11017':
domain: API_BROWSE
category: REQUEST
description: An item_ids or an item_group_ids list is required. Please use one of these lists.
'404':
description: Not Found
'409':
description: Conflict
'500':
description: Internal Server Error
x-response-codes:
errors:
'11000':
domain: API_BROWSE
category: APPLICATION
description: There was a problem with an eBay internal system or process. Contact eBay developer support for assistance.
security:
- api_auth:
- https://api.ebay.com/oauth/api_scope/buy.item.bulk
/item/get_items_by_item_group:
get:
tags:
- Item
description: 'This method retrieves details about individual items in an item group. An item group is an item that has various aspect differences, such as color, size, storage capacity, etc.<br><br>You pass in the <b>item_group_id</b> as a URI parameter.<br><br>This method returns two main containers:<ul><li><b>items</b><br>This container has an array of containers with the details about each item in the group.</li><li
# --- truncated at 32 KB (164 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/ebay/refs/heads/main/openapi/ebay-item-api-openapi.yml