productsRequest

get

https://api.business.amazon.com/products/2020-08-26/products/{productId}

Retrieves a product with its ASIN identifier.

Usage Plan:

Rate (requests per second)	Burst
.5	10

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. The preceding table indicates the default rate and burst values for this operation. For questions about your usage plan, reach out to your Amazon Business technical contact.

🚧
productRegion can be either US or DE to return results for the US and German marketplaces, respectively. Selecting any other region will return an error.

📘
To test this API, populate each required input field with the pre-defined example values.

Path Params

productId

string

required

The Amazon Standard Item Identifier (ASIN) for the product.

Query Params

productRegion

string

enum

required

The region where the customer wants to purchase the product.

shippingRegion

string

This field determines the region where to ship the product based on the value in the shippingPostalCode.

locale

string

required

The locale of the request, in the form of an IETF language tag. Each ProductRegion supports one or more locales. This value should comply with java.util.Locale.

shippingPostalCode

string

The shipping postal or zip code for the customer's request. This parameter doesn't support geocode.

quantity

integer

Defaults to 1

The number of units the customer intends to purchase. This helps Amazon Business determine quantity-based discounts if an eligible offer is present. Defaults to 1.

facets

array of strings

enum

A list of data facets to include in the response. Separate each facet with a comma.

facets

inclusionsForProducts

array of strings

enum

A list specifying the product fields for inclusion in the response object. Excluding this query parameter returns response with all inclusions except upcValues, eanValues, modelNumber, and manufacturerName.

inclusionsForProducts

inclusionsForOffers

array of strings

enum

A list specifying the offer fields for inclusion in the response object. Excluding this query parameter results in the response including all inclusions.

inclusionsForOffers

groupTag

string

A value that identifies the group within the business account that a customer belongs to. The customer can set this in Amazon Business account information. GroupTag is necessary only if the customer account belongs to more than one group.

Headers

x-amz-user-email

string

required

The email address of the customer requesting this resource.

Responses

🚧

📘

200Product successfully retrieved.

400The service was unable to process your request. Reasons for the error are described in an error response object.

401The request's authorization header isn't formatted correctly or doesn't contain a valid authorization input.

403Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.

404The resource specified doesn't exist.

429The frequency of requests was greater than allowed.

500Encountered an unexpected condition which prevented the server from fulfilling the request.

503Temporary overloading or maintenance of the server.