etsy-open-api-v3

name	etsy-open-api-v3
description	Etsy Open API v3 API skill. Use when working with Etsy Open API v3 for application. Covers 103 endpoints.
version	1.0.0
generator	lapsh

Etsy Open API v3

API version: 3.0.0

Auth

ApiKey x-api-key in header | OAuth2

Base URL

https://openapi.etsy.com

Setup

1. Set your API key in the appropriate header
2. GET /v3/application/buyer-taxonomy/nodes -- verify access
3. POST /v3/application/shops/{shop_id}/listings -- create first listings

Endpoints

103 endpoints across 1 groups. See references/api-spec.lap for full details.

application

Method	Path	Description
GET	/v3/application/buyer-taxonomy/nodes	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/buyer-taxonomy/nodes/{taxonomy_id}/properties	General ReleaseReport bug This endpoint is ready for production use.
POST	/v3/application/shops/{shop_id}/listings	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/shops/{shop_id}/listings	General ReleaseReport bug This endpoint is ready for production use.
DELETE	/v3/application/listings/{listing_id}	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/listings/{listing_id}	General ReleaseReport bug This endpoint is ready for production use.
DELETE	/v3/application/shops/{shop_id}/listings/{listing_id}/files/{listing_file_id}	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/shops/{shop_id}/listings/{listing_id}/files/{listing_file_id}	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/shops/{shop_id}/listings/{listing_id}/files	General ReleaseReport bug This endpoint is ready for production use.
POST	/v3/application/shops/{shop_id}/listings/{listing_id}/files	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/listings/active	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/shops/{shop_id}/listings/active	General ReleaseReport bug This endpoint is ready for production use.
DELETE	/v3/application/shops/{shop_id}/listings/{listing_id}/images/{listing_image_id}	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/listings/{listing_id}/images/{listing_image_id}	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/listings/{listing_id}/images	General ReleaseReport bug This endpoint is ready for production use.
POST	/v3/application/shops/{shop_id}/listings/{listing_id}/images	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/listings/{listing_id}/inventory	General ReleaseReport bug This endpoint is ready for production use.
PUT	/v3/application/listings/{listing_id}/inventory	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/listings/{listing_id}/inventory/products/{product_id}	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/listings/{listing_id}/products/{product_id}/offerings/{product_offering_id}	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/listings/batch	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/shops/{shop_id}/listings/featured	General ReleaseReport bug This endpoint is ready for production use.
DELETE	/v3/application/shops/{shop_id}/listings/{listing_id}/personalization	General ReleaseReport bug This endpoint is ready for production use.
POST	/v3/application/shops/{shop_id}/listings/{listing_id}/personalization	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/listings/{listing_id}/personalization	General ReleaseReport bug This endpoint is ready for production use.
DELETE	/v3/application/shops/{shop_id}/listings/{listing_id}/properties/{property_id}	General ReleaseReport bug This endpoint is ready for production use.
PUT	/v3/application/shops/{shop_id}/listings/{listing_id}/properties/{property_id}	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/listings/{listing_id}/properties/{property_id}	Feedback only Give feedback Development for this endpoint is in progress. It will only return a 501 response.
GET	/v3/application/shops/{shop_id}/listings/{listing_id}/properties	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/shops/{shop_id}/listings/{listing_id}/transactions	General ReleaseReport bug This endpoint is ready for production use.
POST	/v3/application/shops/{shop_id}/listings/{listing_id}/translations/{language}	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/shops/{shop_id}/listings/{listing_id}/translations/{language}	General ReleaseReport bug This endpoint is ready for production use.
PUT	/v3/application/shops/{shop_id}/listings/{listing_id}/translations/{language}	General ReleaseReport bug This endpoint is ready for production use.
PATCH	/v3/application/shops/{shop_id}/listings/{listing_id}	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/shops/{shop_id}/listings/{listing_id}/variation-images	General ReleaseReport bug This endpoint is ready for production use.
POST	/v3/application/shops/{shop_id}/listings/{listing_id}/variation-images	General ReleaseReport bug This endpoint is ready for production use.
DELETE	/v3/application/shops/{shop_id}/listings/{listing_id}/videos/{video_id}	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/listings/{listing_id}/videos/{video_id}	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/listings/{listing_id}/videos	General ReleaseReport bug This endpoint is ready for production use.
POST	/v3/application/shops/{shop_id}/listings/{listing_id}/videos	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/shops/{shop_id}/payment-account/ledger-entries/{ledger_entry_id}	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/shops/{shop_id}/payment-account/ledger-entries	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/shops/{shop_id}/payment-account/ledger-entries/payments	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/shops/{shop_id}/receipts/{receipt_id}/payments	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/shops/{shop_id}/payments	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/openapi-ping	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/shops/{shop_id}/receipts/{receipt_id}	General ReleaseReport bug This endpoint is ready for production use.
PUT	/v3/application/shops/{shop_id}/receipts/{receipt_id}	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/shops/{shop_id}/receipts	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/shops/{shop_id}/receipts/{receipt_id}/listings	General ReleaseReport bug This endpoint is ready for production use.
POST	/v3/application/shops/{shop_id}/receipts/{receipt_id}/tracking	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/shops/{shop_id}/receipts/{receipt_id}/transactions	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/listings/{listing_id}/reviews	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/shops/{shop_id}/reviews	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/seller-taxonomy/nodes	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/seller-taxonomy/nodes/{taxonomy_id}/properties	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/shipping-carriers	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/shops/{shop_id}	General ReleaseReport bug This endpoint is ready for production use.
PUT	/v3/application/shops/{shop_id}	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/users/{user_id}/shops	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/shops/{shop_id}/holiday-preferences	General ReleaseReport bug This endpoint is ready for production use.
PUT	/v3/application/shops/{shop_id}/holiday-preferences/{holiday_id}	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/shops	General ReleaseReport bug This endpoint is ready for production use.
POST	/v3/application/shops/{shop_id}/policies/return/consolidate	General ReleaseReport bug This endpoint is ready for production use.
POST	/v3/application/shops/{shop_id}/policies/return	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/shops/{shop_id}/policies/return	General ReleaseReport bug This endpoint is ready for production use.
DELETE	/v3/application/shops/{shop_id}/policies/return/{return_policy_id}	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/shops/{shop_id}/policies/return/{return_policy_id}	General ReleaseReport bug This endpoint is ready for production use.
PUT	/v3/application/shops/{shop_id}/policies/return/{return_policy_id}	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/shops/{shop_id}/policies/return/{return_policy_id}/listings	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/shops/{shop_id}/production-partners	General ReleaseReport bug This endpoint is ready for production use.
POST	/v3/application/shops/{shop_id}/readiness-state-definitions	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/shops/{shop_id}/readiness-state-definitions	General ReleaseReport bug This endpoint is ready for production use.
DELETE	/v3/application/shops/{shop_id}/readiness-state-definitions/{readiness_state_definition_id}	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/shops/{shop_id}/readiness-state-definitions/{readiness_state_definition_id}	General ReleaseReport bug This endpoint is ready for production use.
PUT	/v3/application/shops/{shop_id}/readiness-state-definitions/{readiness_state_definition_id}	General ReleaseReport bug This endpoint is ready for production use.
POST	/v3/application/shops/{shop_id}/sections	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/shops/{shop_id}/sections	General ReleaseReport bug This endpoint is ready for production use.
DELETE	/v3/application/shops/{shop_id}/sections/{shop_section_id}	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/shops/{shop_id}/sections/{shop_section_id}	General ReleaseReport bug This endpoint is ready for production use.
PUT	/v3/application/shops/{shop_id}/sections/{shop_section_id}	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/shops/{shop_id}/shop-sections/listings	General ReleaseReport bug This endpoint is ready for production use.
POST	/v3/application/shops/{shop_id}/shipping-profiles	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/shops/{shop_id}/shipping-profiles	General ReleaseReport bug This endpoint is ready for production use.
DELETE	/v3/application/shops/{shop_id}/shipping-profiles/{shipping_profile_id}	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/shops/{shop_id}/shipping-profiles/{shipping_profile_id}	General ReleaseReport bug This endpoint is ready for production use.
PUT	/v3/application/shops/{shop_id}/shipping-profiles/{shipping_profile_id}	General ReleaseReport bug This endpoint is ready for production use.
POST	/v3/application/shops/{shop_id}/shipping-profiles/{shipping_profile_id}/destinations	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/shops/{shop_id}/shipping-profiles/{shipping_profile_id}/destinations	General ReleaseReport bug This endpoint is ready for production use.
DELETE	/v3/application/shops/{shop_id}/shipping-profiles/{shipping_profile_id}/destinations/{shipping_profile_destination_id}	General ReleaseReport bug This endpoint is ready for production use.
PUT	/v3/application/shops/{shop_id}/shipping-profiles/{shipping_profile_id}/destinations/{shipping_profile_destination_id}	General ReleaseReport bug This endpoint is ready for production use.
POST	/v3/application/shops/{shop_id}/shipping-profiles/{shipping_profile_id}/upgrades	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/shops/{shop_id}/shipping-profiles/{shipping_profile_id}/upgrades	General ReleaseReport bug This endpoint is ready for production use.
DELETE	/v3/application/shops/{shop_id}/shipping-profiles/{shipping_profile_id}/upgrades/{upgrade_id}	General ReleaseReport bug This endpoint is ready for production use.
PUT	/v3/application/shops/{shop_id}/shipping-profiles/{shipping_profile_id}/upgrades/{upgrade_id}	General ReleaseReport bug This endpoint is ready for production use.
POST	/v3/application/scopes	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/shops/{shop_id}/transactions/{transaction_id}	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/shops/{shop_id}/transactions	General ReleaseReport bug This endpoint is ready for production use.
DELETE	/v3/application/user/addresses/{user_address_id}	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/user/addresses/{user_address_id}	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/user/addresses	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/users/{user_id}	General ReleaseReport bug This endpoint is ready for production use.
GET	/v3/application/users/me	General ReleaseReport bug This endpoint is ready for production use.

Common Questions

Match user requests to endpoints in references/api-spec.lap. Key patterns:

• "List all nodes?" -> GET /v3/application/buyer-taxonomy/nodes
• "List all properties?" -> GET /v3/application/buyer-taxonomy/nodes/{taxonomy_id}/properties
• "Create a listing?" -> POST /v3/application/shops/{shop_id}/listings
• "List all listings?" -> GET /v3/application/shops/{shop_id}/listings
• "Delete a listing?" -> DELETE /v3/application/listings/{listing_id}
• "Get listing details?" -> GET /v3/application/listings/{listing_id}
• "Delete a file?" -> DELETE /v3/application/shops/{shop_id}/listings/{listing_id}/files/{listing_file_id}
• "Get file details?" -> GET /v3/application/shops/{shop_id}/listings/{listing_id}/files/{listing_file_id}
• "List all files?" -> GET /v3/application/shops/{shop_id}/listings/{listing_id}/files
• "Create a file?" -> POST /v3/application/shops/{shop_id}/listings/{listing_id}/files
• "List all active?" -> GET /v3/application/listings/active
• "List all active?" -> GET /v3/application/shops/{shop_id}/listings/active
• "Delete a image?" -> DELETE /v3/application/shops/{shop_id}/listings/{listing_id}/images/{listing_image_id}
• "Get image details?" -> GET /v3/application/listings/{listing_id}/images/{listing_image_id}
• "List all images?" -> GET /v3/application/listings/{listing_id}/images
• "Create a image?" -> POST /v3/application/shops/{shop_id}/listings/{listing_id}/images
• "List all inventory?" -> GET /v3/application/listings/{listing_id}/inventory
• "Get product details?" -> GET /v3/application/listings/{listing_id}/inventory/products/{product_id}
• "Get offering details?" -> GET /v3/application/listings/{listing_id}/products/{product_id}/offerings/{product_offering_id}
• "List all batch?" -> GET /v3/application/listings/batch
• "List all featured?" -> GET /v3/application/shops/{shop_id}/listings/featured
• "Create a personalization?" -> POST /v3/application/shops/{shop_id}/listings/{listing_id}/personalization
• "List all personalization?" -> GET /v3/application/listings/{listing_id}/personalization
• "Delete a property?" -> DELETE /v3/application/shops/{shop_id}/listings/{listing_id}/properties/{property_id}
• "Update a property?" -> PUT /v3/application/shops/{shop_id}/listings/{listing_id}/properties/{property_id}
• "Get property details?" -> GET /v3/application/listings/{listing_id}/properties/{property_id}
• "List all properties?" -> GET /v3/application/shops/{shop_id}/listings/{listing_id}/properties
• "List all transactions?" -> GET /v3/application/shops/{shop_id}/listings/{listing_id}/transactions
• "Get translation details?" -> GET /v3/application/shops/{shop_id}/listings/{listing_id}/translations/{language}

Response Tips

• Check response schemas in references/api-spec.lap for field details
• List endpoints may support pagination; check for limit, offset, or cursor params
• Create/update endpoints typically return the created/updated object

References

• Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas

Generated from the official API spec by LAP