Amazon Selling Partner API · Schema

GetPricingResponse

The response schema for the `getPricing` and `getCompetitivePricing` operations.

E-CommerceMarketplaceSelling PartnerAmazonSeller CentralCatalogOrderInventoryFulfillmentMCPAgent Skills

Properties

Name Type Description
payload object The payload for the getPricing and getCompetitivePricing operations.
errors object One or more unexpected errors occurred during the operation.
View JSON Schema on GitHub

JSON Schema

amazon-seller-central-get-pricing-response-schema.json Raw ↑ 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/amazon-seller-central/main/json-schema/amazon-seller-central-get-pricing-response-schema.json",
  "title": "GetPricingResponse",
  "description": "The response schema for the `getPricing` and `getCompetitivePricing` operations.",
  "x-generated": "2026-09-24",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/amazon-seller-central-productpricing-api-openapi.yml#/components/schemas/GetPricingResponse",
  "type": "object",
  "properties": {
    "payload": {
      "description": "The payload for the getPricing and getCompetitivePricing operations.",
      "$ref": "#/$defs/PriceList"
    },
    "errors": {
      "description": "One or more unexpected errors occurred during the operation.",
      "$ref": "#/$defs/ErrorList_2"
    }
  },
  "$defs": {
    "ASINIdentifier": {
      "type": "object",
      "required": [
        "ASIN",
        "MarketplaceId"
      ],
      "properties": {
        "MarketplaceId": {
          "type": "string",
          "description": "A marketplace identifier."
        },
        "ASIN": {
          "type": "string",
          "description": "The Amazon Standard Identification Number (ASIN) of the item."
        }
      },
      "description": "Schema to identify an item by MarketPlaceId and ASIN."
    },
    "AttributeSetList": {
      "type": "array",
      "description": "A list of product attributes if they are applicable to the product that is returned.",
      "items": {
        "type": "object"
      }
    },
    "CompetitivePriceList": {
      "type": "array",
      "description": "A list of competitive pricing information.",
      "items": {
        "$ref": "#/$defs/CompetitivePriceType"
      }
    },
    "CompetitivePriceType": {
      "type": "object",
      "required": [
        "CompetitivePriceId",
        "Price"
      ],
      "properties": {
        "CompetitivePriceId": {
          "type": "string",
          "description": "The pricing model for each price that is returned.\n\nPossible values:\n\n* 1 - New Buy Box Price.\n* 2 - Used Buy Box Price."
        },
        "Price": {
          "description": "Pricing information for a given CompetitivePriceId value.",
          "$ref": "#/$defs/PriceType"
        },
        "condition": {
          "type": "string",
          "description": "Indicates the condition of the item whose pricing information is returned. Possible values are: New, Used, Collectible, Refurbished, or Club."
        },
        "subcondition": {
          "type": "string",
          "description": "Indicates the subcondition of the item whose pricing information is returned. Possible values are: New, Mint, Very Good, Good, Acceptable, Poor, Club, OEM, Warranty, Refurbished Warranty, Refurbished, Open Box, or Other."
        },
        "offerType": {
          "description": "Indicates the type of customer that the offer is valid for.<br><br>When the offer type is B2C in a quantity discount, the seller is winning the Buy Box because others do not have inventory at that quantity, not because they have a quantity discount on the ASIN.",
          "$ref": "#/$defs/OfferCustomerType"
        },
        "quantityTier": {
          "type": "integer",
          "format": "int32",
          "description": "Indicates at what quantity this price becomes active."
        },
        "quantityDiscountType": {
          "description": "Indicates the type of quantity discount this price applies to.",
          "$ref": "#/$defs/QuantityDiscountType"
        },
        "sellerId": {
          "type": "string",
          "description": "The seller identifier for the offer."
        },
        "belongsToRequester": {
          "type": "boolean",
          "description": " Indicates whether or not the pricing information is for an offer listing that belongs to the requester. The requester is the seller associated with the SellerId that was submitted with the request. Possible values are: true and false."
        }
      },
      "description": "Schema for competitive pricing information"
    },
    "CompetitivePricingType": {
      "type": "object",
      "required": [
        "CompetitivePrices",
        "NumberOfOfferListings"
      ],
      "properties": {
        "CompetitivePrices": {
          "$ref": "#/$defs/CompetitivePriceList"
        },
        "NumberOfOfferListings": {
          "$ref": "#/$defs/NumberOfOfferListingsList"
        },
        "TradeInValue": {
          "description": "The trade-in value of the item in the trade-in program.",
          "$ref": "#/$defs/MoneyType_2"
        }
      },
      "description": "Competitive pricing information for the item."
    },
    "Error": {
      "type": "object",
      "required": [
        "code",
        "message"
      ],
      "properties": {
        "code": {
          "type": "string",
          "description": "An error code that identifies the type of error that occurred."
        },
        "message": {
          "type": "string",
          "description": "A message that describes the error condition."
        },
        "details": {
          "type": "string",
          "description": "Additional details that can help the caller understand or fix the issue."
        }
      },
      "description": "Error response returned when the request is unsuccessful."
    },
    "ErrorList_2": {
      "type": "array",
      "description": "A list of error responses returned when a request is unsuccessful.",
      "items": {
        "$ref": "#/$defs/Error"
      }
    },
    "IdentifierType": {
      "type": "object",
      "required": [
        "MarketplaceASIN"
      ],
      "properties": {
        "MarketplaceASIN": {
          "description": "Indicates the item is identified by MarketPlaceId and ASIN.",
          "$ref": "#/$defs/ASINIdentifier"
        },
        "SKUIdentifier": {
          "description": "Indicates the item is identified by MarketPlaceId, SellerId, and SellerSKU.",
          "$ref": "#/$defs/SellerSKUIdentifier"
        }
      },
      "description": "Specifies the identifiers used to uniquely identify an item."
    },
    "MoneyType_2": {
      "type": "object",
      "properties": {
        "CurrencyCode": {
          "type": "string",
          "description": "The currency code in ISO 4217 format."
        },
        "Amount": {
          "type": "number",
          "description": "The monetary value."
        }
      },
      "description": "Currency type and monetary value. Schema for demonstrating pricing info."
    },
    "NumberOfOfferListingsList": {
      "type": "array",
      "description": "The number of active offer listings for the item that was submitted. The listing count is returned by condition, one for each listing condition value that is returned.",
      "items": {
        "$ref": "#/$defs/OfferListingCountType"
      }
    },
    "OfferCustomerType": {
      "type": "string",
      "enum": [
        "B2C",
        "B2B"
      ],
      "x-docgen-enum-table-extension": [
        {
          "value": "B2C",
          "description": "B2C"
        },
        {
          "value": "B2B",
          "description": "B2B"
        }
      ],
      "description": "Indicates whether the offer is a B2B or B2C offer"
    },
    "OfferListingCountType": {
      "type": "object",
      "required": [
        "Count",
        "condition"
      ],
      "properties": {
        "Count": {
          "type": "integer",
          "format": "int32",
          "description": "The number of offer listings."
        },
        "condition": {
          "type": "string",
          "description": "The condition of the item."
        }
      },
      "description": "The number of offer listings with the specified condition."
    },
    "OfferType": {
      "type": "object",
      "required": [
        "BuyingPrice",
        "FulfillmentChannel",
        "ItemCondition",
        "ItemSubCondition",
        "RegularPrice",
        "SellerSKU"
      ],
      "properties": {
        "offerType": {
          "description": "Indicates the type of customer that the offer is valid for.",
          "$ref": "#/$defs/OfferCustomerType"
        },
        "BuyingPrice": {
          "description": "Contains pricing information that includes promotions and contains the shipping cost.",
          "$ref": "#/$defs/PriceType"
        },
        "RegularPrice": {
          "description": "The current price excluding any promotions that apply to the product. Excludes the shipping cost.",
          "$ref": "#/$defs/MoneyType_2"
        },
        "businessPrice": {
          "description": "The current listing price for Business buyers.",
          "$ref": "#/$defs/MoneyType_2"
        },
        "quantityDiscountPrices": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/QuantityDiscountPriceType"
          },
          "description": "List of `QuantityDiscountPrice` that contains item's pricing information when buy in bulk."
        },
        "FulfillmentChannel": {
          "type": "string",
          "description": "The fulfillment channel for the offer listing. Possible values:\n\n* Amazon - Fulfilled by Amazon.\n* Merchant - Fulfilled by the seller."
        },
        "ItemCondition": {
          "type": "string",
          "description": "The item condition for the offer listing. Possible values: New, Used, Collectible, Refurbished, or Club."
        },
        "ItemSubCondition": {
          "type": "string",
          "description": "The item subcondition for the offer listing. Possible values: New, Mint, Very Good, Good, Acceptable, Poor, Club, OEM, Warranty, Refurbished Warranty, Refurbished, Open Box, or Other."
        },
        "SellerSKU": {
          "type": "string",
          "description": "The seller stock keeping unit (SKU) of the item."
        }
      },
      "description": "Schema for an individual offer."
    },
    "OffersList": {
      "type": "array",
      "description": "A list of offers.",
      "items": {
        "$ref": "#/$defs/OfferType"
      }
    },
    "Points_2": {
      "type": "object",
      "properties": {
        "PointsNumber": {
          "type": "integer",
          "format": "int32",
          "description": "The number of points."
        },
        "PointsMonetaryValue": {
          "description": "The monetary value of the points.",
          "$ref": "#/$defs/MoneyType_2"
        }
      },
      "description": "The number of Amazon Points offered with the purchase of an item, and their monetary value."
    },
    "PriceList": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/Price_2"
      },
      "maxItems": 20,
      "description": "The payload for the `getPricing` and `getCompetitivePricing` operations."
    },
    "PriceType": {
      "type": "object",
      "required": [
        "ListingPrice"
      ],
      "properties": {
        "LandedPrice": {
          "description": "The value calculated by adding ListingPrice + Shipping - Points. Note that if the landed price is not returned, the listing price represents the product with the lowest landed price.",
          "$ref": "#/$defs/MoneyType_2"
        },
        "ListingPrice": {
          "description": "The listing price of the item including any promotions that apply.",
          "$ref": "#/$defs/MoneyType_2"
        },
        "Shipping": {
          "description": "The shipping cost of the product. Note that the shipping cost is not always available.",
          "$ref": "#/$defs/MoneyType_2"
        },
        "Points": {
          "description": "The number of Amazon Points offered with the purchase of an item, and their monetary value.",
          "$ref": "#/$defs/Points_2"
        }
      },
      "description": "Schema for item's price information, including listing price, shipping price, and Amazon points."
    },
    "Price_2": {
      "type": "object",
      "required": [
        "status"
      ],
      "properties": {
        "status": {
          "type": "string",
          "description": "The status of the operation."
        },
        "SellerSKU": {
          "type": "string",
          "description": "The seller stock keeping unit (SKU) of the item."
        },
        "ASIN": {
          "type": "string",
          "description": "The Amazon Standard Identification Number (ASIN) of the item."
        },
        "Product": {
          "$ref": "#/$defs/Product"
        }
      },
      "description": "Schema for price info in `getPricing` response"
    },
    "Product": {
      "type": "object",
      "required": [
        "Identifiers"
      ],
      "properties": {
        "Identifiers": {
          "$ref": "#/$defs/IdentifierType"
        },
        "AttributeSets": {
          "$ref": "#/$defs/AttributeSetList"
        },
        "Relationships": {
          "$ref": "#/$defs/RelationshipList"
        },
        "CompetitivePricing": {
          "$ref": "#/$defs/CompetitivePricingType"
        },
        "SalesRankings": {
          "$ref": "#/$defs/SalesRankList"
        },
        "Offers": {
          "$ref": "#/$defs/OffersList"
        }
      },
      "description": "An item."
    },
    "QuantityDiscountPriceType": {
      "type": "object",
      "description": "Contains pricing information that includes special pricing when buying in bulk.",
      "required": [
        "quantityTier",
        "quantityDiscountType",
        "listingPrice"
      ],
      "properties": {
        "quantityTier": {
          "type": "integer",
          "format": "int32",
          "description": "Indicates at what quantity this price becomes active."
        },
        "quantityDiscountType": {
          "description": "Indicates the type of quantity discount this price applies to.",
          "$ref": "#/$defs/QuantityDiscountType"
        },
        "listingPrice": {
          "description": "The price at this quantity tier.",
          "$ref": "#/$defs/MoneyType_2"
        }
      }
    },
    "QuantityDiscountType": {
      "type": "string",
      "enum": [
        "QUANTITY_DISCOUNT"
      ],
      "x-docgen-enum-table-extension": [
        {
          "value": "QUANTITY_DISCOUNT",
          "description": "Quantity Discount"
        }
      ],
      "description": "Indicates the type of quantity discount this price applies to."
    },
    "RelationshipList": {
      "type": "array",
      "description": "A list that contains product variation information, if applicable.",
      "items": {
        "type": "object"
      }
    },
    "SalesRankList": {
      "type": "array",
      "description": "A list of sales rank information for the item, by category.",
      "items": {
        "$ref": "#/$defs/SalesRankType"
      }
    },
    "SalesRankType": {
      "type": "object",
      "required": [
        "ProductCategoryId",
        "Rank"
      ],
      "properties": {
        "ProductCategoryId": {
          "type": "string",
          "description": " Identifies the item category from which the sales rank is taken."
        },
        "Rank": {
          "type": "integer",
          "format": "int32",
          "description": "The sales rank of the item within the item category."
        }
      },
      "description": "Sales rank information for the item, by category"
    },
    "SellerSKUIdentifier": {
      "type": "object",
      "required": [
        "MarketplaceId",
        "SellerId",
        "SellerSKU"
      ],
      "properties": {
        "MarketplaceId": {
          "type": "string",
          "description": "A marketplace identifier."
        },
        "SellerId": {
          "type": "string",
          "description": "The seller identifier submitted for the operation."
        },
        "SellerSKU": {
          "type": "string",
          "description": "The seller stock keeping unit (SKU) of the item."
        }
      },
      "description": "Schema to identify an item by MarketPlaceId, SellerId, and SellerSKU."
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema 
curl "https://apis.io/api/v1/json-schemas/amazon-seller-central-get-pricing-response"
All schemas 
curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.