We’re so excited to share our first incremental release for Etsy’s Open API v3 schema! Below you’ll find a changelog calling out the updates we’ve made to our endpoints and reference documentation since our initial release. Going forward you can expect to see regular releases like this one approximately every two weeks during the alpha period.
We hope these release notes help you understand what we’re working on and plan your migration to v3. If you have any feedback or suggestions on this release or anything else, we’d love to hear about it!
Added
- getListingProperty feedback-only endpoint (getAttribute in V2)
- getUserAddress feedback-only endpoint (getUserAddress in V2)
- getSellerTaxonomy feedback-only endpoint
- findAllShopListingsActive feedback-only endpoint (search functionality associated with findAllShopListingsActive in V2)
- getPropertiesByTaxonomyId alpha endpoint (getTaxonomyNodeProperties in V2)
- OAS description fields for each of our schema objects
Changed
- getShopReceiptTransactionsByShop is now an alpha endpoint (findAllShopTransactions in V2)
- createListingShippingProfile is now an alpha endpoint (createShippingTemplate in V2)
- getPayments is now an alpha endpoint (findPayment in V2)
- getUser now requires the email_r OAuth scope
- destination_region_id field is now destination_region across all endpoints and resources. The field is now a string enum of regions to which the listing ships. Currently supported regions enum values are "eu" (European Union countries) and "non_eu" (European countries not in the European Union)
- *_country_id fields are now *_country_iso fields across all endpoints and resources. The fields are now ISO 3166-1 alpha-2 country code strings.
- Renamed image_listing_id to listing_image_id on the ShopTransaction resource.
Removed
- Country schema object and related endpoints. Removing these endpoints in favor of using ISO 3166-1 alpha-2 country code strings across all of V3.