| 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] | | shippingProfile | ShopShippingProfile | An array of data representing the shipping profile resource. | [optional] | | user | User | Represents a single user of the site | [optional] | | shop | Shop | A shop created by an Etsy user. | [optional] | | images | kotlin.collections.List<ListingImage> | Represents a list of listing image resources, each of which contains the reference URLs and metadata for an image | [optional] | | videos | kotlin.collections.List<ListingVideo> | The single video associated with a listing. | [optional] | | inventory | ListingInventory | An enumerated string that attaches a valid association. Default value is null. | [optional] | | productionPartners | kotlin.collections.List<ShopProductionPartner> | Represents a list of production partners for a shop. | [optional] | | skus | kotlin.collections.List<kotlin.String> | A list of SKU strings for the listing. SKUs will only appear if the requesting user owns the shop and a valid matching OAuth 2 token is provided. When requested without the token it will be an empty array. | [optional] | | translations | ListingTranslations | A map of translations for the listing. Default value is a map of all supported languages keyed to null. | [optional] | | views | kotlin.Int | The number of times the listing has been viewed. This value is tabulated once per day and only for active listings, so the value is not real-time. If `0`, the listing has either not been viewed, not yet tabulated, was not active during the last tabulation or there was an error fetching the value. If a value is expected, call `getListing` to confirm the value. | [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 |