Etsy · Schema

ListingPropertyValue

A representation of structured data values.

MarketplaceEcommerceHandmadeListingsOrdersPaymentsReviewsShippingTaxonomyOAuth2

Properties

Name	Type	Description
property_id	integer	The numeric ID of the Property.
property_name	string	The name of the Property.
scale_id	integer	The numeric ID of the scale (if any).
scale_name	string	The label used to describe the chosen scale (if any).
value_ids	array	The numeric IDs of the Property values
values	array	The Property values

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "ListingPropertyValue",
  "description": "A representation of structured data values.",
  "$id": "https://raw.githubusercontent.com/api-evangelist/etsy/refs/heads/main/json-schema/open-api-v3-listing-property-value-schema.json",
  "type": "object",
  "properties": {
    "property_id": {
      "type": "integer",
      "description": "The numeric ID of the Property.",
      "format": "int64",
      "minimum": 1,
      "example": 1
    },
    "property_name": {
      "type": "string",
      "description": "The name of the Property.",
      "nullable": true,
      "example": "Handmade Ceramic Mug"
    },
    "scale_id": {
      "type": "integer",
      "description": "The numeric ID of the scale (if any).",
      "format": "int64",
      "nullable": true,
      "minimum": 1,
      "example": 1
    },
    "scale_name": {
      "type": "string",
      "description": "The label used to describe the chosen scale (if any).",
      "nullable": true,
      "example": "Handmade Ceramic Mug"
    },
    "value_ids": {
      "type": "array",
      "description": "The numeric IDs of the Property values",
      "items": {
        "type": "integer",
        "format": "int64",
        "minimum": 1
      }
    },
    "values": {
      "type": "array",
      "description": "The Property values",
      "items": {
        "type": "string"
      }
    }
  }
}