| Name | Type | Description | Notes | | ———— | ————- | ————- | ————- | | listingId | kotlin.Long | The numeric ID for the listing associated to this transaction. | [optional] | | userId | kotlin.Long | The numeric ID for the user posting the listing. | [optional] | | shopId | kotlin.Long | The unique positive non-zero numeric ID for an Etsy Shop. | [optional] | | title | kotlin.String | The listing's title string. When creating or updating a listing, valid title strings contain only letters, numbers, punctuation marks, mathematical symbols, whitespace characters, ™, ©, and ®. (regex: /[^\p{L}\p{Nd}\p{P}\p{Sm}\p{Zs}™©®]/u) You can only use the %, :, & and + characters once each. | [optional] | | description | kotlin.String | A description string of the product for sale in the listing. | [optional] | | state | inline | When updating a listing, this value can be either `active` or `inactive`. Note: Setting a `draft` listing to `active` will also publish the listing on etsy.com and requires that the listing have an image set. Setting a `sold_out` listing to active will update the quantity to 1 and renew the listing on etsy.com. | [optional] | | creationTimestamp | kotlin.Int | The listing's creation time, in epoch seconds. | [optional] | | createdTimestamp | kotlin.Int | The listing's creation time, in epoch seconds. | [optional] | | endingTimestamp | kotlin.Int | The listing's expiration time, in epoch seconds. | [optional] | | originalCreationTimestamp | kotlin.Int | The listing's creation time, in epoch seconds. | [optional] | | lastModifiedTimestamp | kotlin.Int | The time of the last update to the listing, in epoch seconds. | [optional] | | updatedTimestamp | kotlin.Int | The time of the last update to the listing, in epoch seconds. | [optional] | | stateTimestamp | kotlin.Int | The date and time of the last state change of this listing. | [optional] | | quantity | kotlin.Int | The positive non-zero number of products available for purchase in the listing. Note: The listing quantity is the sum of available offering quantities. You can request the quantities for individual offerings from the ListingInventory resource using the getListingInventory endpoint. | [optional] | | shopSectionId | kotlin.Long | The numeric ID of a section in a specific Etsy shop. | [optional] | | featuredRank | kotlin.Int | The positive non-zero numeric position in the featured listings of the shop, with rank 1 listings appearing in the left-most position in featured listing on a shop's home page. | [optional] | | url | kotlin.String | The full URL to the listing's page on Etsy. | [optional] | | numFavorers | kotlin.Int | The number of users who marked this Listing a favorite. | [optional] | | nonTaxable | kotlin.Boolean | When true, applicable shop tax rates do not apply to this listing at checkout. | [optional] | | isTaxable | kotlin.Boolean | When true, applicable shop tax rates apply to this listing at checkout. | [optional] | | isCustomizable | kotlin.Boolean | When true, a buyer may contact the seller for a customized order. The default value is true when a shop accepts custom orders. Does not apply to shops that do not accept custom orders. | [optional] | | isPersonalizable | kotlin.Boolean | When true, this listing is personalizable. The default value is null. | [optional] | | personalizationIsRequired | kotlin.Boolean | When true, this listing requires personalization. The default value is null. Will only change if is_personalizable is 'true'. | [optional] | | personalizationCharCountMax | kotlin.Int | This is an integer value representing the maximum length for the personalization message entered by the buyer. Will only change if is_personalizable is 'true'. | [optional] | | personalizationInstructions | kotlin.String | When true, this listing requires personalization. The default value is null. Will only change if is_personalizable is 'true'. | [optional] | | listingType | inline | An enumerated type string that indicates whether the listing is physical or a digital download. | [optional] | | tags | kotlin.collections.List<kotlin.String> | A comma-separated list of tag strings for the listing. When creating or updating a listing, valid tag strings contain only letters, numbers, whitespace characters, -, ', ™, ©, and ®. (regex: /[^\p{L}\p{Nd}\p{Zs}\-'™©®]/u) Default value is null. | [optional] | | materials | kotlin.collections.List<kotlin.String> | A list of material strings for materials used in the product. Valid materials strings contain only letters, numbers, and whitespace characters. (regex: /[^\p{L}\p{Nd}\p{Zs}]/u) Default value is null. | [optional] | | shippingProfileId | kotlin.Long | The numeric ID of the shipping profile associated with the listing. Required when listing type is `physical`. | [optional] | | returnPolicyId | kotlin.Long | The numeric ID of the Return Policy. | [optional] | | processingMin | kotlin.Int | The minimum number of days required to process this listing. Default value is null. | [optional] | | processingMax | kotlin.Int | The maximum number of days required to process this listing. Default value is null. | [optional] | | whoMade | inline | An enumerated string indicating who made the product. Helps buyers locate the listing under the Handmade heading. Requires 'is_supply' and 'when_made'. | [optional] | | whenMade | inline | An enumerated string for the era in which the maker made the product in this listing. Helps buyers locate the listing under the Vintage heading. Requires 'is_supply' and 'who_made'. | [optional] | | isSupply | kotlin.Boolean | When true, tags the listing as a supply product, else indicates that it's a finished product. Helps buyers locate the listing under the Supplies heading. Requires 'who_made' and 'when_made'. | [optional] | | itemWeight | kotlin.Float | The numeric weight of the product measured in units set in 'item_weight_unit'. Default value is null. If set, the value must be greater than 0. | [optional] | | itemWeightUnit | inline | A string defining the units used to measure the weight of the product. Default value is null. | [optional] | | itemLength | kotlin.Float | The numeric length of the product measured in units set in 'item_dimensions_unit'. Default value is null. If set, the value must be greater than 0. | [optional] | | itemWidth | kotlin.Float | The numeric width of the product measured in units set in 'item_dimensions_unit'. Default value is null. If set, the value must be greater than 0. | [optional] | | itemHeight | kotlin.Float | The numeric length of the product measured in units set in 'item_dimensions_unit'. Default value is null. If set, the value must be greater than 0. | [optional] | | itemDimensionsUnit | inline | A string defining the units used to measure the dimensions of the product. Default value is null. | [optional] | | isPrivate | kotlin.Boolean | When true, this is a private listing intended for a specific buyer and hidden from shop view. | [optional] | | style | kotlin.collections.List<kotlin.String> | An array of style strings for this listing, each of which is free-form text string such as \"Formal\", or \"Steampunk\". When creating or updating a listing, the listing may have up to two styles. Valid style strings contain only letters, numbers, and whitespace characters. (regex: /[^\p{L}\p{Nd}\p{Zs}]/u) Default value is null. | [optional] | | fileData | kotlin.String | A string describing the files attached to a digital listing. | [optional] | | hasVariations | kotlin.Boolean | When true, the listing has variations. | [optional] | | shouldAutoRenew | kotlin.Boolean | When true, renews a listing for four months upon expiration. | [optional] | | language | kotlin.String | The IETF language tag for the default language of the listing. Ex: `de`, `en`, `es`, `fr`, `it`, `ja`, `nl`, `pl`, `pt`, `ru`. | [optional] | | price | Money | The positive non-zero price of the product. (Sold product listings are private) Note: The price is the minimum possible price. The `getListingInventory` method requests exact prices for available offerings. | [optional] | | taxonomyId | kotlin.Int | The numerical taxonomy ID of the listing. See SellerTaxonomy and BuyerTaxonomy for more information. | [optional] | | readinessStateId | kotlin.Long | The numeric ID of the processing profile associated with the listing. Required when listing type is `physical`. | [optional] |
| Name | Value | | —- | —– | | state | active, inactive, sold_out, draft, expired |
| Name | Value | | —- | —– | | listingType | physical, download, both |
| Name | Value | | —- | —– | | whoMade | i_did, someone_else, collective |
| Name | Value | | —- | —– | | whenMade | made_to_order, 2020_2025, 2010_2019, 2006_2009, before_2006, 2000_2005, 1990s, 1980s, 1970s, 1960s, 1950s, 1940s, 1930s, 1920s, 1910s, 1900s, 1800s, 1700s, before_1700 |
| Name | Value | | —- | —– | | itemWeightUnit | oz, lb, g, kg |
| Name | Value | | —- | —– | | itemDimensionsUnit | in, ft, mm, cm, m, yd, inches |