productTypeDefinitions_getDefinitionsProductType

Retrieve an Amazon product type's definition — its attribute groups, requirements and a link to its JSON Schema.

readAmazon Seller (SP-API)sp.definitionsProductTypes_2020-09-01

Amazon SP-API · getDefinitionsProductType · GET /definitions/2020-09-01/productTypes/{productType} Use this to understand required and optional attributes before calling listings_putListingsItem. To compose listing rows, listings_prepare_publish_queue_template returns the same schema as sheet columns, required keys and enums.

Call it

In an AI client (MCP)

tools/call
{
  "name": "productTypeDefinitions_getDefinitionsProductType",
  "arguments": {
    "store": "myStore-US",
    "product_type": "<product_type>"
  }
}

From code (Tool API)

curl -X POST https://api.sellersheetai.com/api/v1/tools/productTypeDefinitions_getDefinitionsProductType \
  -H "Authorization: Bearer $SELLERSHEET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"store":"myStore-US","product_type":"<product_type>"}'
Early access — the Tool API is open on request, contact us.

Arguments

NameTypeDescription
storerequiredstringthe store ref `<store>-<CC>` (name-country, e.g. 'myStore-US') — one of get_user_context's store_refs, verbatim.
product_typerequiredstringAmazon product type string (e.g. 'LUGGAGE'). Get from productTypeDefinitions_searchDefinitionsProductTypes.
include_schemabooleantrue downloads the full JSON Schema into data.definition.schema.content (large); leave it false unless you need the schema itself.Default: false
requirementsstringWhich requirements set to retrieve. Default: LISTING (all attributes). Allowed: LISTING | LISTING_PRODUCT_ONLY | LISTING_OFFER_ONLY.LISTINGLISTING_PRODUCT_ONLYLISTING_OFFER_ONLY
requirements_enforcedstringENFORCED (strict validation, the default) or NOT_ENFORCED (partial updates). Identifies if the required attributes for a requirements set are enforced by the product type definition schema. Non-enforced requirements enable structural validation of individual attributes without all the required attributes being present (such as for partial updates).ENFORCEDNOT_ENFORCED
product_type_versionstringVersion to retrieve. Default: LATEST. Use RELEASE_CANDIDATE for preview versions. The version of the Amazon product type to retrieve. Defaults to "LATEST". Prerelease versions of product type definitions may be retrieved with "RELEASE_CANDIDATE". If no prerelease version is currently available, the "LATEST" live version will be provided.
localestringLocale for display labels in the response. Defaults to the default language of the first marketplace in the request. Allowed: DEFAULT | ar | ar_AE | de | de_DE | en | en_AE | en_AU | en_CA | en_GB | en_IN | en_SG | en_US | es | es_ES | es_MX | es_US | fr | fr_CA | fr_FR | it | it_IT | ja | ja_JP | nl | nl_NL | pl | pl_PL | pt | pt_BR | pt_PT | sv | sv_SE | tr | tr_TR | zh | zh_CN | zh_TW.DEFAULTarar_AEdede_DEenen_AEen_AUen_CAen_GBen_INen_SGen_USeses_ESes_MXes_USfrfr_CAfr_FRitit_ITjaja_JPnlnl_NLplpl_PLptpt_BRpt_PTsvsv_SEtrtr_TRzhzh_CNzh_TW
parentage_levelstringParentage level of the listing the schema is for. Amazon then resolves all conditional logic for that level and returns a smaller schema with fewer conditions — pass it when building a variation family. Allowed: NONE | CHILD | PARENT.NONECHILDPARENT

Result

Every tool answers {notification, data, human_action}; data carries:

  • data.productType — the product type name.
  • data.definition.propertyGroups — the attribute groups.
  • data.definition.schema.link.resource — the JSON Schema's download link.
  • data.definition.schema.content — (include_schema=true) the JSON Schema itself.
  • data.definition.requirements / data.definition.productTypeVersion — what was served.

Workflow

  • 1. productTypeDefinitions_searchDefinitionsProductTypes for the productType. 2. Call with requirements LISTING (and parentage_level for a variation family). 3. Read data.definition.propertyGroups; pass include_schema=true only when you need the JSON Schema itself.

On this page

Actions

View as Markdown

Ask an assistant

Ask ChatGPTAsk Claude