Kotlin client library for Etsy Open API v3

Get from Maven Central

dependencies {
    implementation("digital.guimauve.etsy:etsy:1.0.0")
}

Overview

This API client was generated by the OpenAPI Generator project. By using the openapi-spec from a remote server, you can easily generate an API client.

• API version: 3.0.0
• Package version:
• Generator version: 7.15.0
• Build package: org.openapitools.codegen.languages.KotlinClientCodegen

Requires

• Kotlin 1.5.10

Build

./gradlew check assemble

This runs all tests and packages the library.

Features/Implementation Notes

• Supports JSON inputs/outputs, File inputs, and Form inputs.
• Supports collection formats for query parameters: csv, tsv, ssv, pipes.
• Some Kotlin and Java types are fully qualified to avoid conflicts with types defined in OpenAPI definitions.

Documentation for API Endpoints

All URIs are relative to https://openapi.etsy.com

Class	Method	HTTP request	Description
BuyerTaxonomyApi	getBuyerTaxonomyNodes	GET /v3/application/buyer-taxonomy/nodes
BuyerTaxonomyApi	getPropertiesByBuyerTaxonomyId	GET /v3/application/buyer-taxonomy/nodes/{taxonomy_id}/properties
LedgerEntryApi	getShopPaymentAccountLedgerEntries	GET /v3/application/shops/{shop_id}/payment-account/ledger-entries
LedgerEntryApi	getShopPaymentAccountLedgerEntry	GET /v3/application/shops/{shop_id}/payment-account/ledger-entries/{ledger_entry_id}
OtherApi	ping	GET /v3/application/openapi-ping
OtherApi	tokenScopes	POST /v3/application/scopes
PaymentApi	getPaymentAccountLedgerEntryPayments	GET /v3/application/shops/{shop_id}/payment-account/ledger-entries/payments
PaymentApi	getPayments	GET /v3/application/shops/{shop_id}/payments
PaymentApi	getShopPaymentByReceiptId	GET /v3/application/shops/{shop_id}/receipts/{receipt_id}/payments
ReviewApi	getReviewsByListing	GET /v3/application/listings/{listing_id}/reviews
ReviewApi	getReviewsByShop	GET /v3/application/shops/{shop_id}/reviews
SellerTaxonomyApi	getPropertiesByTaxonomyId	GET /v3/application/seller-taxonomy/nodes/{taxonomy_id}/properties
SellerTaxonomyApi	getSellerTaxonomyNodes	GET /v3/application/seller-taxonomy/nodes
ShopApi	findShops	GET /v3/application/shops
ShopApi	getShop	GET /v3/application/shops/{shop_id}
ShopApi	getShopByOwnerUserId	GET /v3/application/users/{user_id}/shops
ShopApi	updateShop	PUT /v3/application/shops/{shop_id}
ShopHolidayPreferencesApi	getHolidayPreferences	GET /v3/application/shops/{shop_id}/holiday-preferences
ShopHolidayPreferencesApi	updateHolidayPreferences	PUT /v3/application/shops/{shop_id}/holiday-preferences/{holiday_id}
ShopListingApi	createDraftListing	POST /v3/application/shops/{shop_id}/listings
ShopListingApi	deleteListing	DELETE /v3/application/listings/{listing_id}
ShopListingApi	deleteListingProperty	DELETE /v3/application/shops/{shop_id}/listings/{listing_id}/properties/{property_id}
ShopListingApi	findAllActiveListingsByShop	GET /v3/application/shops/{shop_id}/listings/active
ShopListingApi	findAllListingsActive	GET /v3/application/listings/active
ShopListingApi	getFeaturedListingsByShop	GET /v3/application/shops/{shop_id}/listings/featured
ShopListingApi	getListing	GET /v3/application/listings/{listing_id}
ShopListingApi	getListingProperties	GET /v3/application/shops/{shop_id}/listings/{listing_id}/properties
ShopListingApi	getListingProperty	GET /v3/application/listings/{listing_id}/properties/{property_id}
ShopListingApi	getListingsByListingIds	GET /v3/application/listings/batch
ShopListingApi	getListingsByShop	GET /v3/application/shops/{shop_id}/listings
ShopListingApi	getListingsByShopReceipt	GET /v3/application/shops/{shop_id}/receipts/{receipt_id}/listings
ShopListingApi	getListingsByShopReturnPolicy	GET /v3/application/shops/{shop_id}/policies/return/{return_policy_id}/listings
ShopListingApi	getListingsByShopSectionId	GET /v3/application/shops/{shop_id}/shop-sections/listings
ShopListingApi	updateListing	PATCH /v3/application/shops/{shop_id}/listings/{listing_id}
ShopListingApi	updateListingProperty	PUT /v3/application/shops/{shop_id}/listings/{listing_id}/properties/{property_id}
ShopListingFileApi	deleteListingFile	DELETE /v3/application/shops/{shop_id}/listings/{listing_id}/files/{listing_file_id}
ShopListingFileApi	getAllListingFiles	GET /v3/application/shops/{shop_id}/listings/{listing_id}/files
ShopListingFileApi	getListingFile	GET /v3/application/shops/{shop_id}/listings/{listing_id}/files/{listing_file_id}
ShopListingFileApi	uploadListingFile	POST /v3/application/shops/{shop_id}/listings/{listing_id}/files
ShopListingImageApi	deleteListingImage	DELETE /v3/application/shops/{shop_id}/listings/{listing_id}/images/{listing_image_id}
ShopListingImageApi	getListingImage	GET /v3/application/listings/{listing_id}/images/{listing_image_id}
ShopListingImageApi	getListingImages	GET /v3/application/listings/{listing_id}/images
ShopListingImageApi	uploadListingImage	POST /v3/application/shops/{shop_id}/listings/{listing_id}/images
ShopListingInventoryApi	getListingInventory	GET /v3/application/listings/{listing_id}/inventory
ShopListingInventoryApi	updateListingInventory	PUT /v3/application/listings/{listing_id}/inventory
ShopListingOfferingApi	getListingOffering	GET /v3/application/listings/{listing_id}/products/{product_id}/offerings/{product_offering_id}
ShopListingProductApi	getListingProduct	GET /v3/application/listings/{listing_id}/inventory/products/{product_id}
ShopListingTranslationApi	createListingTranslation	POST /v3/application/shops/{shop_id}/listings/{listing_id}/translations/{language}
ShopListingTranslationApi	getListingTranslation	GET /v3/application/shops/{shop_id}/listings/{listing_id}/translations/{language}
ShopListingTranslationApi	updateListingTranslation	PUT /v3/application/shops/{shop_id}/listings/{listing_id}/translations/{language}
ShopListingVariationImageApi	getListingVariationImages	GET /v3/application/shops/{shop_id}/listings/{listing_id}/variation-images
ShopListingVariationImageApi	updateVariationImages	POST /v3/application/shops/{shop_id}/listings/{listing_id}/variation-images
ShopListingVideoApi	deleteListingVideo	DELETE /v3/application/shops/{shop_id}/listings/{listing_id}/videos/{video_id}
ShopListingVideoApi	getListingVideo	GET /v3/application/listings/{listing_id}/videos/{video_id}
ShopListingVideoApi	getListingVideos	GET /v3/application/listings/{listing_id}/videos
ShopListingVideoApi	uploadListingVideo	POST /v3/application/shops/{shop_id}/listings/{listing_id}/videos
ShopProcessingProfilesApi	createShopReadinessStateDefinition	POST /v3/application/shops/{shop_id}/readiness-state-definitions
ShopProcessingProfilesApi	deleteShopReadinessStateDefinition	DELETE /v3/application/shops/{shop_id}/readiness-state-definitions/{readiness_state_definition_id}
ShopProcessingProfilesApi	getShopReadinessStateDefinition	GET /v3/application/shops/{shop_id}/readiness-state-definitions/{readiness_state_definition_id}
ShopProcessingProfilesApi	getShopReadinessStateDefinitions	GET /v3/application/shops/{shop_id}/readiness-state-definitions
ShopProcessingProfilesApi	updateShopReadinessStateDefinition	PUT /v3/application/shops/{shop_id}/readiness-state-definitions/{readiness_state_definition_id}
ShopProductionPartnerApi	getShopProductionPartners	GET /v3/application/shops/{shop_id}/production-partners
ShopReceiptApi	createReceiptShipment	POST /v3/application/shops/{shop_id}/receipts/{receipt_id}/tracking
ShopReceiptApi	getShopReceipt	GET /v3/application/shops/{shop_id}/receipts/{receipt_id}
ShopReceiptApi	getShopReceipts	GET /v3/application/shops/{shop_id}/receipts
ShopReceiptApi	updateShopReceipt	PUT /v3/application/shops/{shop_id}/receipts/{receipt_id}
ShopReceiptTransactionsApi	getShopReceiptTransaction	GET /v3/application/shops/{shop_id}/transactions/{transaction_id}
ShopReceiptTransactionsApi	getShopReceiptTransactionsByListing	GET /v3/application/shops/{shop_id}/listings/{listing_id}/transactions
ShopReceiptTransactionsApi	getShopReceiptTransactionsByReceipt	GET /v3/application/shops/{shop_id}/receipts/{receipt_id}/transactions
ShopReceiptTransactionsApi	getShopReceiptTransactionsByShop	GET /v3/application/shops/{shop_id}/transactions
ShopReturnPolicyApi	consolidateShopReturnPolicies	POST /v3/application/shops/{shop_id}/policies/return/consolidate
ShopReturnPolicyApi	createShopReturnPolicy	POST /v3/application/shops/{shop_id}/policies/return
ShopReturnPolicyApi	deleteShopReturnPolicy	DELETE /v3/application/shops/{shop_id}/policies/return/{return_policy_id}
ShopReturnPolicyApi	getShopReturnPolicies	GET /v3/application/shops/{shop_id}/policies/return
ShopReturnPolicyApi	getShopReturnPolicy	GET /v3/application/shops/{shop_id}/policies/return/{return_policy_id}
ShopReturnPolicyApi	updateShopReturnPolicy	PUT /v3/application/shops/{shop_id}/policies/return/{return_policy_id}
ShopSectionApi	createShopSection	POST /v3/application/shops/{shop_id}/sections
ShopSectionApi	deleteShopSection	DELETE /v3/application/shops/{shop_id}/sections/{shop_section_id}
ShopSectionApi	getShopSection	GET /v3/application/shops/{shop_id}/sections/{shop_section_id}
ShopSectionApi	getShopSections	GET /v3/application/shops/{shop_id}/sections
ShopSectionApi	updateShopSection	PUT /v3/application/shops/{shop_id}/sections/{shop_section_id}
ShopShippingProfileApi	createShopShippingProfile	POST /v3/application/shops/{shop_id}/shipping-profiles
ShopShippingProfileApi	createShopShippingProfileDestination	POST /v3/application/shops/{shop_id}/shipping-profiles/{shipping_profile_id}/destinations
ShopShippingProfileApi	createShopShippingProfileUpgrade	POST /v3/application/shops/{shop_id}/shipping-profiles/{shipping_profile_id}/upgrades
ShopShippingProfileApi	deleteShopShippingProfile	DELETE /v3/application/shops/{shop_id}/shipping-profiles/{shipping_profile_id}
ShopShippingProfileApi	deleteShopShippingProfileDestination	DELETE /v3/application/shops/{shop_id}/shipping-profiles/{shipping_profile_id}/destinations/{shipping_profile_destination_id}
ShopShippingProfileApi	deleteShopShippingProfileUpgrade	DELETE /v3/application/shops/{shop_id}/shipping-profiles/{shipping_profile_id}/upgrades/{upgrade_id}
ShopShippingProfileApi	getShippingCarriers	GET /v3/application/shipping-carriers
ShopShippingProfileApi	getShopShippingProfile	GET /v3/application/shops/{shop_id}/shipping-profiles/{shipping_profile_id}
ShopShippingProfileApi	getShopShippingProfileDestinationsByShippingProfile	GET /v3/application/shops/{shop_id}/shipping-profiles/{shipping_profile_id}/destinations
ShopShippingProfileApi	getShopShippingProfileUpgrades	GET /v3/application/shops/{shop_id}/shipping-profiles/{shipping_profile_id}/upgrades
ShopShippingProfileApi	getShopShippingProfiles	GET /v3/application/shops/{shop_id}/shipping-profiles
ShopShippingProfileApi	updateShopShippingProfile	PUT /v3/application/shops/{shop_id}/shipping-profiles/{shipping_profile_id}
ShopShippingProfileApi	updateShopShippingProfileDestination	PUT /v3/application/shops/{shop_id}/shipping-profiles/{shipping_profile_id}/destinations/{shipping_profile_destination_id}
ShopShippingProfileApi	updateShopShippingProfileUpgrade	PUT /v3/application/shops/{shop_id}/shipping-profiles/{shipping_profile_id}/upgrades/{upgrade_id}
UserApi	getMe	GET /v3/application/users/me
UserApi	getUser	GET /v3/application/users/{user_id}
UserAddressApi	deleteUserAddress	DELETE /v3/application/user/addresses/{user_address_id}
UserAddressApi	getUserAddress	GET /v3/application/user/addresses/{user_address_id}
UserAddressApi	getUserAddresses	GET /v3/application/user/addresses

Documentation for Models

• com.etsy.models.BuyerTaxonomyNode
• com.etsy.models.BuyerTaxonomyNodeProperties
• com.etsy.models.BuyerTaxonomyNodeProperty
• com.etsy.models.BuyerTaxonomyNodes
• com.etsy.models.BuyerTaxonomyPropertyScale
• com.etsy.models.BuyerTaxonomyPropertyValue
• com.etsy.models.ErrorSchema
• com.etsy.models.ListingImage
• com.etsy.models.ListingImages
• com.etsy.models.ListingInventory
• com.etsy.models.ListingInventoryProduct
• com.etsy.models.ListingInventoryProductOffering
• com.etsy.models.ListingInventoryWithAssociations
• com.etsy.models.ListingPropertyValue
• com.etsy.models.ListingPropertyValues
• com.etsy.models.ListingReview
• com.etsy.models.ListingReviews
• com.etsy.models.ListingTranslation
• com.etsy.models.ListingTranslations
• com.etsy.models.ListingVariationImage
• com.etsy.models.ListingVariationImages
• com.etsy.models.ListingVideo
• com.etsy.models.ListingVideos
• com.etsy.models.Money
• com.etsy.models.Payment
• com.etsy.models.PaymentAccountLedgerEntries
• com.etsy.models.PaymentAccountLedgerEntry
• com.etsy.models.PaymentAdjustment
• com.etsy.models.PaymentAdjustmentItem
• com.etsy.models.Payments
• com.etsy.models.Pong
• com.etsy.models.Self
• com.etsy.models.SellerTaxonomyNode
• com.etsy.models.SellerTaxonomyNodes
• com.etsy.models.ShippingCarrier
• com.etsy.models.ShippingCarrierMailClass
• com.etsy.models.ShippingCarriers
• com.etsy.models.Shop
• com.etsy.models.ShopHolidayPreference
• com.etsy.models.ShopListing
• com.etsy.models.ShopListingFile
• com.etsy.models.ShopListingFiles
• com.etsy.models.ShopListingWithAssociations
• com.etsy.models.ShopListings
• com.etsy.models.ShopListingsWithAssociations
• com.etsy.models.ShopProcessingProfile
• com.etsy.models.ShopProcessingProfiles
• com.etsy.models.ShopProductionPartner
• com.etsy.models.ShopProductionPartners
• com.etsy.models.ShopReceipt
• com.etsy.models.ShopReceiptShipment
• com.etsy.models.ShopReceiptTransaction
• com.etsy.models.ShopReceiptTransactions
• com.etsy.models.ShopReceipts
• com.etsy.models.ShopRefund
• com.etsy.models.ShopReturnPolicies
• com.etsy.models.ShopReturnPolicy
• com.etsy.models.ShopSection
• com.etsy.models.ShopSections
• com.etsy.models.ShopShippingProfile
• com.etsy.models.ShopShippingProfileDestination
• com.etsy.models.ShopShippingProfileDestinations
• com.etsy.models.ShopShippingProfileUpgrade
• com.etsy.models.ShopShippingProfileUpgrades
• com.etsy.models.ShopShippingProfiles
• com.etsy.models.Shops
• com.etsy.models.TaxonomyNodeProperties
• com.etsy.models.TaxonomyNodeProperty
• com.etsy.models.TaxonomyPropertyScale
• com.etsy.models.TaxonomyPropertyValue
• com.etsy.models.TransactionReview
• com.etsy.models.TransactionReviews
• com.etsy.models.TransactionVariations
• com.etsy.models.TypeDiscriminator
• com.etsy.models.UpdateListingInventoryRequest
• com.etsy.models.UpdateListingInventoryRequestProductsInner
• com.etsy.models.UpdateListingInventoryRequestProductsInnerOfferingsInner
• com.etsy.models.UpdateListingInventoryRequestProductsInnerPropertyValuesInner
• com.etsy.models.UpdateVariationImagesRequest
• com.etsy.models.UpdateVariationImagesRequestVariationImagesInner
• com.etsy.models.User
• com.etsy.models.UserAddress
• com.etsy.models.UserAddresses

Documentation for Authorization

Authentication schemes defined for the API:

api_key

• Type: API key
• API key parameter name: x-api-key
• Location: HTTP header

oauth2

• Type: OAuth
• Flow: accessCode
• Authorization URL: https://www.etsy.com/oauth/connect
• Scopes:
  • address_r: see billing and shipping addresses
  • address_w: update billing and shipping addresses
  • billing_r: see all billing statement data
  • cart_r: read shopping carts
  • cart_w: add/remove from shopping carts
  • email_r: read a user profile
  • favorites_r: see private favorites
  • favorites_w: add/remove favorites
  • feedback_r: see purchase info in feedback
  • listings_d: delete listings
  • listings_r: see all listings (including expired etc)
  • listings_w: create/edit listings
  • profile_r: see all profile data
  • profile_w: update user profile, avatar, etc
  • recommend_r: see recommended listings
  • recommend_w: accept/reject recommended listings
  • shops_r: see private shop info
  • shops_w: update shop
  • transactions_r: see all checkout/payment data
  • transactions_w: update receipts

Author

developers@etsy.com