Skip to main content


This method retrieves details of the catalog product identified by the eBay product identifier (ePID) specified in the request. These details include the product's title and description, aspects and their values, associated images, applicable category IDs, and any recognized identifiers that apply to the product.

For a new listing, you can use the search method to identify candidate products on which to base the listing, then use the getProduct method to present the full details of those candidate products to the seller to make a a final selection.


Resource URI


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

URI parameters

epidstringThe eBay product identifier (ePID) of the product being requested. This value can be discovered by issuing the search method and examining the value of the productSummaries.epid field for the desired returned product summary.

Occurrence: Required

HTTP request headers

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

The table below shows additional HTTP request headers that are either required, conditionally required, or strongly recommended for this method. Other standard HTTP request headers- opens rest request components page (not in this table) can also be used, but they are optional.

X-EBAY-C-MARKETPLACE-IDstringThis method also uses the X-EBAY-C-MARKETPLACE-ID header to identify the seller's eBay marketplace. It is required for all supported marketplaces, except EBAY_US, which is the default.

Occurrence: Conditional

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):

See OAuth access tokens for more information.

Note: Only the sell.inventory scope is required for selling applications, and only the commerce.catalog.readonly scope is required for buying applications.

Request payload

This call has no payload.

Request fields

This call has no field definitions.


HTTP response headers

This call has no response headers.

Response payload

{ /* Product */
"additionalImages" : [
{ /* Image */ }
"brand" : "string",
"ean" : [],
"epid" : "string",
"gtin" : [],
"image" :
{ /* Image */ },
"isbn" : [],
"mpn" : [],
"title" : "string",
"upc" : [],

Response fields

Output container/fieldTypeDescription
additionalImagesarray of Image

Contains information about additional images associated with this product. For the primary image, see the image container.

Occurrence: Conditional


The height of the image in pixels.

Occurrence: Conditional


The eBay Picture Services (EPS) URL of the image.

Occurrence: Always


The width of the image in pixels.

Occurrence: Conditional

aspectsarray of Aspect

Contains an array of the category aspects and their values that are associated with this product.

Occurrence: Conditional


The localized name of this category aspect.

Occurrence: Conditional

aspects.localizedValuesarray of string

A list of the localized values of this category aspect.

Occurrence: Conditional


The manufacturer's brand name for this product.

Occurrence: Conditional


The rich description of this product, which might contain HTML.

Occurrence: Always

eanarray of string

A list of all European Article Numbers (EANs) that identify this product.

Occurrence: Conditional


The eBay product ID of this product.

Occurrence: Always

gtinarray of string

A list of all GTINs that identify this product. Currently this can include EAN, ISBN, and UPC identifier types.

Occurrence: Conditional


Contains information about the primary image of this product. For more images of this product, see the additionalImages container.

Occurrence: Always


The height of the image in pixels.

Occurrence: Conditional


The eBay Picture Services (EPS) URL of the image.

Occurrence: Always


The width of the image in pixels.

Occurrence: Conditional

isbnarray of string

A list of all International Standard Book Numbers (ISBNs) that identify this product.

Occurrence: Conditional

mpnarray of string

A list of all MPN values that the manufacturer uses to identify this product.

Occurrence: Conditional

otherApplicableCategoryIdsarray of string

A list of category IDs (other than the value of primaryCategoryId) for all the leaf categories to which this product might belong.

Occurrence: Conditional


The identifier of the leaf category that eBay recommends using to list this product, based on previous listings of similar products. Products in the eBay catalog are not automatically associated with any particular category, but using an inappropriate category can make it difficult for prospective buyers to find the product. For other possible categories that might be used, see otherApplicableCategoryIds.

Occurrence: Always


The URL for this product's eBay product page.

Occurrence: Conditional


The title of this product on eBay.

Occurrence: Always

upcarray of string

A list of Universal Product Codes (UPCs) that identify this product.

Occurrence: Conditional


The current version number of this product record in the catalog.

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.

400Bad Request
404Not Found
500Internal Server Error

Error codes

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

75000API_CATALOGAPPLICATIONThere was a problem with an eBay internal system or process. Contact eBay developer support for assistance.
75007API_CATALOGREQUESTCurrently, the {marketplaceId} marketplace is not supported. The supported Marketplaces are: {allowedMarketplaces}.
75010API_CATALOGREQUESTThe specified EPID value {epid} was not found.
75011API_CATALOGREQUESTThe specified EPID value {epid} no longer exists. Its new value is {newepid}.
75015API_CATALOGREQUESTInsufficient permissions to fulfill the request.
75016API_CATALOGREQUESTThe specified EPID value {epid} is no longer available.


This call has no warnings.


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: Get Product Details

This sample returns the details of the specified product by passing in the ePID of the product. The ePID was returned by the search call in the productSummaries.epid field. You can also use the URI that was returned in the search call's productSummaries.productHref field.


The input is the epid URI parameter, which specifies the ePID of the product. There is no payload with this request.



The details are returned for the corresponding product titled "Apple iPhone 7 - 32GB - Black (Unlocked) A1660 (CDMA + GSM)." It also has aspects that are returned in the aspects container.