Retrieve a Product Type Definition

Learn how to return Amazon Product Type Definitions and related schemas from the Product Type Definitions API for a given selling partner, Amazon product type, and Amazon marketplace.

Prerequisites

To complete this tutorial, you need:

• Authorization from the Selling Partner for whom you are making calls. Refer to Authorizing Selling Partner API applications for more information.
• Approval for the Product Listing role in your developer profile.
• The Product Listing role selected in the App registration page for your application.

Step 1. Retrieve the Product Type Definition

Call the getDefinitionsProductType operation to retrieve an Amazon Product Type Definition from the Product Type Definitions API.

Step 2. Retrieve the schema documents

In the previous step, the retrieved Amazon Product Type Definition includes details about the Amazon product type and links to retrieve the meta schema and product type schema documents. The links provided are valid for seven days.

Schema documents can be retrieved programmatically with a standard HTTP client or manually with a web browser.

❗️

Meta scheme names cannot be resolved via the web

The Amazon Product Type Definition JSON schema document references the meta schema by name. Some JSON schema libraries attempt to resolve meta schema names online via the web, which the Amazon Product Type Definition Meta-Schema (v1) does not support. These libraries should be configured to use a downloaded copy of the meta schema instead. Refer to the accompanying Amazon Product Type Definition Meta-Schema (v1) documentation for more details.