Etsy website screenshot

Etsy

Etsy is a global marketplace for unique and creative handmade, vintage, and craft-supply goods. The Etsy Open API v3 is a REST + OAuth 2.0 surface that third-party developers, sellers, and integration partners use to manage shops, listings, inventory, receipts, transactions, payments, ledger entries, reviews, shipping profiles, processing profiles, production partners, return policies, and seller/buyer taxonomy. Webhooks deliver order lifecycle events (order.paid, order.canceled, order.shipped, order.delivered) to subscriber endpoints. This profile catalogs the public API surface, machine-readable artifacts, plans, rate limits, FinOps alignment, and Naftiko capabilities.

2 APIs 0 Features
MarketplaceEcommerceHandmadeListingsOrdersPaymentsReviewsShippingTaxonomyOAuth2

APIs

Etsy Open API v3

The Etsy Open API v3 is the official REST + OAuth 2.0 surface used to build applications against the Etsy marketplace. It focuses on three primary use cases: listing management ...

Etsy Open API v3 Webhooks

AsyncAPI 2.6 description of Etsy's outbound webhook surface for the Open API v3. Covers the four documented event types (order.paid, order.canceled, order.shipped, order.deliver...

Collections

Arazzo Workflows

Etsy Clone an Image to a New Listing

Read a source listing's images, create a new draft listing, and assign the source image.

ARAZZO

Etsy Create Return Policy and Listing

Create a shop return policy, then create a draft listing that references it.

ARAZZO

Etsy Create Shipping Profile and Listing

Create a shop shipping profile, then create a draft listing that uses it.

ARAZZO

Etsy Fulfill a Receipt

Fetch a receipt, submit tracking to create a shipment, then mark it shipped.

ARAZZO

Etsy Get My Shop Listings

Resolve the authenticated seller's shop and list its listings filtered by state.

ARAZZO

Etsy Listing Reviews

Fetch a single listing, then retrieve the reviews left on that listing.

ARAZZO

Etsy Listing with Inventory

Fetch a listing, then retrieve its full inventory record.

ARAZZO

Etsy Organize a Listing into a Section

Create a shop section, then create a draft listing assigned to that section.

ARAZZO

Etsy Process Unshipped Orders

Resolve the seller's shop, list paid-but-unshipped receipts, and ship the first one.

ARAZZO

Etsy Publish a Physical Listing

Create a draft physical listing, upload its image, set inventory, then publish it live.

ARAZZO

Etsy Receipt Listings Detail

Fetch a receipt, then list the listings purchased on that receipt.

ARAZZO

Etsy Receipt with Transactions

Fetch a receipt, then retrieve the line-item transactions on that receipt.

ARAZZO

Etsy Reprice Listing Inventory

Read a listing's inventory, then rewrite its product offerings with new price and quantity.

ARAZZO

Etsy Shop Reviews Overview

Resolve the authenticated seller's shop and pull its reviews.

ARAZZO

Etsy Shop Shipping Profiles

Resolve the seller's shop and list its shipping profiles.

ARAZZO

Etsy Shop Transactions Report

Resolve the seller's shop and pull all of its transactions.

ARAZZO

Etsy Update Shop Storefront

Read a shop, then update its storefront messaging fields.

ARAZZO

Etsy User Shop Profile

Fetch a user profile, then resolve the shop that user owns.

ARAZZO

Pricing Plans

Etsy Plans Pricing

3 plans

PLANS

Rate Limits

Etsy Rate Limits

5 limits

RATE LIMITS

FinOps

Etsy Finops

FINOPS

Event Specifications

Etsy Open API v3 Webhooks

AsyncAPI description of Etsy's outbound webhook surface for the Open API v3. Etsy delivers event notifications by issuing HTTP POST requests with a JSON body to a subscriber-con...

ASYNCAPI

Semantic Vocabularies

Etsy Open Api V3 Context

81 classes · 348 properties

JSON-LD

Etsy Webhooks Context

1 classes · 3 properties

JSON-LD

API Governance Rules

Etsy API Rules

54 rules · 17 errors 26 warnings 11 info

SPECTRAL

JSON Structure

Open Api V3 Buyer Taxonomy Node Structure

6 properties

JSON STRUCTURE

Open Api V3 Buyer Taxonomy Nodes Structure

2 properties

JSON STRUCTURE

Open Api V3 Error Schema Structure

1 properties

JSON STRUCTURE

Open Api V3 Listing Buyer Price Structure

10 properties

JSON STRUCTURE

Open Api V3 Listing Image Structure

20 properties

JSON STRUCTURE

Open Api V3 Listing Images Structure

2 properties

JSON STRUCTURE

Open Api V3 Listing Inventory Structure

5 properties

JSON STRUCTURE

Open Api V3 Listing Property Value Structure

6 properties

JSON STRUCTURE

Open Api V3 Listing Property Values Structure

2 properties

JSON STRUCTURE

Open Api V3 Listing Review Structure

10 properties

JSON STRUCTURE

Open Api V3 Listing Reviews Structure

2 properties

JSON STRUCTURE

Open Api V3 Listing Translation Structure

5 properties

JSON STRUCTURE

Open Api V3 Listing Translations Structure

13 properties

JSON STRUCTURE

Open Api V3 Listing Variation Image Structure

4 properties

JSON STRUCTURE

Open Api V3 Listing Video Structure

6 properties

JSON STRUCTURE

Open Api V3 Listing Videos Structure

2 properties

JSON STRUCTURE

Open Api V3 Money Structure

3 properties

JSON STRUCTURE

Open Api V3 Payment Adjustment Item Structure

9 properties

JSON STRUCTURE

Open Api V3 Payment Adjustment Structure

15 properties

JSON STRUCTURE

Open Api V3 Payment Structure

26 properties

JSON STRUCTURE

Open Api V3 Payments Structure

2 properties

JSON STRUCTURE

Open Api V3 Pong Structure

1 properties

JSON STRUCTURE

Open Api V3 Scopes Structure

0 properties

JSON STRUCTURE

Open Api V3 Self Structure

2 properties

JSON STRUCTURE

Open Api V3 Seller Taxonomy Node Structure

6 properties

JSON STRUCTURE

Open Api V3 Seller Taxonomy Nodes Structure

2 properties

JSON STRUCTURE

Open Api V3 Shipping Carrier Structure

4 properties

JSON STRUCTURE

Open Api V3 Shipping Carriers Structure

2 properties

JSON STRUCTURE

Open Api V3 Shop Holiday Preference Structure

5 properties

JSON STRUCTURE

Open Api V3 Shop Listing File Structure

9 properties

JSON STRUCTURE

Open Api V3 Shop Listing Files Structure

2 properties

JSON STRUCTURE

Open Api V3 Shop Listing Structure

49 properties

JSON STRUCTURE

Open Api V3 Shop Listings Structure

2 properties

JSON STRUCTURE

Open Api V3 Shop Processing Profile Structure

6 properties

JSON STRUCTURE

Open Api V3 Shop Production Partner Structure

3 properties

JSON STRUCTURE

Open Api V3 Shop Receipt Shipment Structure

4 properties

JSON STRUCTURE

Open Api V3 Shop Receipt Structure

40 properties

JSON STRUCTURE

Open Api V3 Shop Receipt Transaction Structure

30 properties

JSON STRUCTURE

Open Api V3 Shop Receipts Structure

2 properties

JSON STRUCTURE

Open Api V3 Shop Refund Structure

5 properties

JSON STRUCTURE

Open Api V3 Shop Return Policies Structure

2 properties

JSON STRUCTURE

Open Api V3 Shop Return Policy Structure

5 properties

JSON STRUCTURE

Open Api V3 Shop Section Structure

5 properties

JSON STRUCTURE

Open Api V3 Shop Sections Structure

2 properties

JSON STRUCTURE

Open Api V3 Shop Shipping Profile Structure

11 properties

JSON STRUCTURE

Open Api V3 Shop Shipping Profiles Structure

2 properties

JSON STRUCTURE

Open Api V3 Shop Structure

47 properties

JSON STRUCTURE

Open Api V3 Shops Structure

2 properties

JSON STRUCTURE

Open Api V3 Taxonomy Node Property Structure

11 properties

JSON STRUCTURE

Open Api V3 Taxonomy Property Scale Structure

3 properties

JSON STRUCTURE

Open Api V3 Taxonomy Property Value Structure

4 properties

JSON STRUCTURE

Open Api V3 Transaction Review Structure

12 properties

JSON STRUCTURE

Open Api V3 Transaction Reviews Structure

2 properties

JSON STRUCTURE

Open Api V3 Transaction Variations Structure

5 properties

JSON STRUCTURE

Open Api V3 Type Discriminator Structure

1 properties

JSON STRUCTURE

Open Api V3 User Address Structure

11 properties

JSON STRUCTURE

Open Api V3 User Addresses Structure

2 properties

JSON STRUCTURE

Open Api V3 User Structure

5 properties

JSON STRUCTURE

Webhooks Order Canceled Payload Structure

0 properties

JSON STRUCTURE

Webhooks Order Delivered Payload Structure

0 properties

JSON STRUCTURE

Webhooks Order Paid Payload Structure

0 properties

JSON STRUCTURE

Webhooks Order Shipped Payload Structure

0 properties

JSON STRUCTURE

Webhooks Webhook Envelope Structure

3 properties

JSON STRUCTURE

Example Payloads

Open Api V3 Money Example

3 fields

EXAMPLE

Open Api V3 Payment Example

26 fields

EXAMPLE

Open Api V3 Payments Example

2 fields

EXAMPLE

Open Api V3 Pong Example

1 fields

EXAMPLE

Open Api V3 Self Example

2 fields

EXAMPLE

Open Api V3 Shop Example

47 fields

EXAMPLE

Open Api V3 Shops Example

2 fields

EXAMPLE

Open Api V3 User Example

5 fields

EXAMPLE

Resources

🔗
PostmanWorkspace
PostmanWorkspace
🔗
Arazzo
Arazzo
🔗
Arazzo
Arazzo
🔗
Arazzo
Arazzo
🔗
Arazzo
Arazzo
🔗
Arazzo
Arazzo
🔗
Arazzo
Arazzo
🔗
Arazzo
Arazzo
🔗
Arazzo
Arazzo
🔗
Arazzo
Arazzo
🔗
Arazzo
Arazzo
🔗
Arazzo
Arazzo
🔗
Arazzo
Arazzo
🔗
Arazzo
Arazzo
🔗
Arazzo
Arazzo
🔗
Arazzo
Arazzo
🔗
Arazzo
Arazzo
🔗
Arazzo
Arazzo
🔗
Arazzo
Arazzo
🔗
Website
Website
🌐
DeveloperPortal
DeveloperPortal
🔗
Documentation
Documentation
🔗
Reference
Reference
👥
GitHubOrganization
GitHubOrganization
🔗
LinkedIn
LinkedIn
🔗
TwitterAccount
TwitterAccount
🟢
StatusPage
StatusPage
📜
TermsOfService
TermsOfService
📜
PrivacyPolicy
PrivacyPolicy
🔗
SecurityPolicy
SecurityPolicy
💰
Pricing
Pricing
💬
Support
Support
📄
ChangeLog
ChangeLog
💻
CodeOfConduct
CodeOfConduct
🔗
Plans
Plans
🔗
RateLimits
RateLimits
🔗
FinOps
FinOps
🔗
Vocabulary
Vocabulary
🔗
SpectralRules
SpectralRules
🔧
Pinot MCP Server (Etsy fork)
Tools
🔧
XCLogParser
Tools
🔧
Cartography
Tools

Sources

Raw ↑
info:
  _postman_id: d9d318bb-5339-449a-9598-97b52a277fbf
  name: Etsy Open API v3
  description: "<div class=\"wt-text-body-01\"><p class=\"wt-pt-xs-2 wt-pb-xs-2\">Etsy's Open API provides a simple RESTful\
    \ interface for various Etsy.com features.</p><p class=\"wt-pb-xs-2\">If you'd like to report an issue or provide feedback\
    \ on the API design, <a target=\"_blank\" class=\"wt-text-link wt-p-xs-0\" href=\"https://github.com/etsy/open-api/discussions\"\
    >please add an issue in Github</a>.</p></div>&copy; 2021-2026 Etsy, Inc. All Rights Reserved. Use of this code is subject\
    \ to Etsy's <a class='wt-text-link wt-p-xs-0' target='_blank' href='https://www.etsy.com/legal/api'>API Developer Terms\
    \ of Use</a>.\n\nContact Support:\n Email: developers@etsy.com"
  schema: https://schema.getpostman.com/json/collection/v2.1.0/collection.json
  createdAt: '2026-06-05T13:14:16.000Z'
  updatedAt: '2026-06-05T13:14:17.000Z'
  lastUpdatedBy: '35240'
  uid: 35240-d9d318bb-5339-449a-9598-97b52a277fbf
item:
- name: v3
  item:
  - name: application
    item:
    - name: buyer-taxonomy
      item:
      - name: nodes
        item:
        - name: '{taxonomy_id}'
          item:
          - name: properties
            item:
            - name: Etsy Get Properties by Buyer Taxonomy Id
              id: 1f8f51cd-a1d7-4e00-ad0b-49fa57cf262a
              protocolProfileBehavior:
                disableBodyPruning: true
              request:
                method: GET
                header:
                - key: Accept
                  value: application/json
                url:
                  raw: '{{baseUrl}}/v3/application/buyer-taxonomy/nodes/:taxonomy_id/properties'
                  host:
                  - '{{baseUrl}}'
                  path:
                  - v3
                  - application
                  - buyer-taxonomy
                  - nodes
                  - :taxonomy_id
                  - properties
                  variable:
                  - id: 8a8cdcee-1226-4447-8b5b-f55d48fa21df
                    key: taxonomy_id
                    value: <long>
                    description: '(Required) The unique numeric ID of an Etsy taxonomy node, which is a metadata category
                      for listings organized into the seller taxonomy hierarchy tree. For example, the "shoes" taxonomy node
                      (ID: 1429, level: 1) is higher in the hierarchy than "girls'' shoes" (ID: 1440, level: 2). The taxonomy
                      nodes assigned to a listing support access to specific standardized product scales and properties. For
                      example, listings assigned the taxonomy nodes "shoes" or "girls'' shoes" support access to the "EU"
                      shoe size scale with its associated property names and IDs for EU shoe sizes, such as property `value_id`:"1394",
                      and `name`:"38".'
                description: '<div class="wt-display-flex-xs wt-align-items-center wt-mt-xs-2 wt-mb-xs-3"><span class="wt-badge
                  wt-badge--notificationPrimary wt-bg-slime-tint wt-mr-xs-2">General Release</span><a class="wt-text-link"
                  href="https://github.com/etsy/open-api/discussions" target="_blank" rel="noopener noreferrer">Report bug</a></div><div
                  class="wt-display-flex-xs wt-align-items-center wt-mt-xs-2 wt-mb-xs-3"><p class="wt-text-body-01 banner-text">This
                  endpoint is ready for production use.</p></div>


                  Retrieves a list of product properties, with applicable scales and values, supported for a specific buyer
                  taxonomy ID.'
              response:
              - id: 2813a268-631a-4c24-a3b5-26b3ecb56d79
                name: A list of product properties, with applicable scales and values.
                originalRequest:
                  method: GET
                  header:
                  - key: Accept
                    value: application/json
                  - description: 'Added as a part of security scheme: apikey'
                    key: x-api-key
                    value: <API Key>
                  url:
                    raw: '{{baseUrl}}/v3/application/buyer-taxonomy/nodes/:taxonomy_id/properties'
                    host:
                    - '{{baseUrl}}'
                    path:
                    - v3
                    - application
                    - buyer-taxonomy
                    - nodes
                    - :taxonomy_id
                    - properties
                    variable:
                    - key: taxonomy_id
                status: OK
                code: 200
                _postman_previewlanguage: json
                header:
                - key: Content-Type
                  value: application/json
                cookie: []
                responseTime: null
                body: "{\n  \"count\": \"<integer>\",\n  \"results\": [\n    {\n      \"property_id\": \"<long>\",\n     \
                  \ \"name\": \"<string>\",\n      \"display_name\": \"<string>\",\n      \"scales\": [\n        {\n     \
                  \     \"scale_id\": \"<long>\",\n          \"display_name\": \"<string>\",\n          \"description\": \"\
                  <string>\"\n        },\n        {\n          \"scale_id\": \"<long>\",\n          \"display_name\": \"<string>\"\
                  ,\n          \"description\": \"<string>\"\n        }\n      ],\n      \"is_required\": \"<boolean>\",\n\
                  \      \"supports_attributes\": \"<boolean>\",\n      \"supports_variations\": \"<boolean>\",\n      \"\
                  is_multivalued\": \"<boolean>\",\n      \"max_values_allowed\": \"<integer>\",\n      \"possible_values\"\
                  : [\n        {\n          \"value_id\": \"<long>\",\n          \"name\": \"<string>\",\n          \"scale_id\"\
                  : \"<long>\",\n          \"equal_to\": [\n            \"<integer>\",\n            \"<integer>\"\n      \
                  \    ]\n        },\n        {\n          \"value_id\": \"<long>\",\n          \"name\": \"<string>\",\n\
                  \          \"scale_id\": \"<long>\",\n          \"equal_to\": [\n            \"<integer>\",\n          \
                  \  \"<integer>\"\n          ]\n        }\n      ],\n      \"selected_values\": [\n        {\n          \"\
                  value_id\": \"<long>\",\n          \"name\": \"<string>\",\n          \"scale_id\": \"<long>\",\n      \
                  \    \"equal_to\": [\n            \"<integer>\",\n            \"<integer>\"\n          ]\n        },\n \
                  \       {\n          \"value_id\": \"<long>\",\n          \"name\": \"<string>\",\n          \"scale_id\"\
                  : \"<long>\",\n          \"equal_to\": [\n            \"<integer>\",\n            \"<integer>\"\n      \
                  \    ]\n        }\n      ]\n    },\n    {\n      \"property_id\": \"<long>\",\n      \"name\": \"<string>\"\
                  ,\n      \"display_name\": \"<string>\",\n      \"scales\": [\n        {\n          \"scale_id\": \"<long>\"\
                  ,\n          \"display_name\": \"<string>\",\n          \"description\": \"<string>\"\n        },\n    \
                  \    {\n          \"scale_id\": \"<long>\",\n          \"display_name\": \"<string>\",\n          \"description\"\
                  : \"<string>\"\n        }\n      ],\n      \"is_required\": \"<boolean>\",\n      \"supports_attributes\"\
                  : \"<boolean>\",\n      \"supports_variations\": \"<boolean>\",\n      \"is_multivalued\": \"<boolean>\"\
                  ,\n      \"max_values_allowed\": \"<integer>\",\n      \"possible_values\": [\n        {\n          \"value_id\"\
                  : \"<long>\",\n          \"name\": \"<string>\",\n          \"scale_id\": \"<long>\",\n          \"equal_to\"\
                  : [\n            \"<integer>\",\n            \"<integer>\"\n          ]\n        },\n        {\n       \
                  \   \"value_id\": \"<long>\",\n          \"name\": \"<string>\",\n          \"scale_id\": \"<long>\",\n\
                  \          \"equal_to\": [\n            \"<integer>\",\n            \"<integer>\"\n          ]\n       \
                  \ }\n      ],\n      \"selected_values\": [\n        {\n          \"value_id\": \"<long>\",\n          \"\
                  name\": \"<string>\",\n          \"scale_id\": \"<long>\",\n          \"equal_to\": [\n            \"<integer>\"\
                  ,\n            \"<integer>\"\n          ]\n        },\n        {\n          \"value_id\": \"<long>\",\n\
                  \          \"name\": \"<string>\",\n          \"scale_id\": \"<long>\",\n          \"equal_to\": [\n   \
                  \         \"<integer>\",\n            \"<integer>\"\n          ]\n        }\n      ]\n    }\n  ]\n}"
                createdAt: '2026-06-05T13:14:17.000Z'
                updatedAt: '2026-06-05T13:14:17.000Z'
                uid: 35240-2813a268-631a-4c24-a3b5-26b3ecb56d79
              - id: bf42b293-b5c7-43fb-8d9c-b3fa9c25b93c
                name: There was a problem with the request data. See the error message for details.
                originalRequest:
                  method: GET
                  header:
                  - key: Accept
                    value: application/json
                  - description: 'Added as a part of security scheme: apikey'
                    key: x-api-key
                    value: <API Key>
                  url:
                    raw: '{{baseUrl}}/v3/application/buyer-taxonomy/nodes/:taxonomy_id/properties'
                    host:
                    - '{{baseUrl}}'
                    path:
                    - v3
                    - application
                    - buyer-taxonomy
                    - nodes
                    - :taxonomy_id
                    - properties
                    variable:
                    - key: taxonomy_id
                status: Bad Request
                code: 400
                _postman_previewlanguage: json
                header:
                - key: Content-Type
                  value: application/json
                cookie: []
                responseTime: null
                body: "{\n  \"error\": \"<string>\"\n}"
                createdAt: '2026-06-05T13:14:17.000Z'
                updatedAt: '2026-06-05T13:14:17.000Z'
                uid: 35240-bf42b293-b5c7-43fb-8d9c-b3fa9c25b93c
              - id: f8a83159-6054-4824-a769-84e24b525a09
                name: A resource could not be found. See the error message for details.
                originalRequest:
                  method: GET
                  header:
                  - key: Accept
                    value: application/json
                  - description: 'Added as a part of security scheme: apikey'
                    key: x-api-key
                    value: <API Key>
                  url:
                    raw: '{{baseUrl}}/v3/application/buyer-taxonomy/nodes/:taxonomy_id/properties'
                    host:
                    - '{{baseUrl}}'
                    path:
                    - v3
                    - application
                    - buyer-taxonomy
                    - nodes
                    - :taxonomy_id
                    - properties
                    variable:
                    - key: taxonomy_id
                status: Not Found
                code: 404
                _postman_previewlanguage: json
                header:
                - key: Content-Type
                  value: application/json
                cookie: []
                responseTime: null
                body: "{\n  \"error\": \"<string>\"\n}"
                createdAt: '2026-06-05T13:14:17.000Z'
                updatedAt: '2026-06-05T13:14:17.000Z'
                uid: 35240-f8a83159-6054-4824-a769-84e24b525a09
              - id: 6ee7d060-55e7-4649-be66-83f45bd500ee
                name: The server encountered an internal error. See the error message for details.
                originalRequest:
                  method: GET
                  header:
                  - key: Accept
                    value: application/json
                  - description: 'Added as a part of security scheme: apikey'
                    key: x-api-key
                    value: <API Key>
                  url:
                    raw: '{{baseUrl}}/v3/application/buyer-taxonomy/nodes/:taxonomy_id/properties'
                    host:
                    - '{{baseUrl}}'
                    path:
                    - v3
                    - application
                    - buyer-taxonomy
                    - nodes
                    - :taxonomy_id
                    - properties
                    variable:
                    - key: taxonomy_id
                status: Internal Server Error
                code: 500
                _postman_previewlanguage: json
                header:
                - key: Content-Type
                  value: application/json
                cookie: []
                responseTime: null
                body: "{\n  \"error\": \"<string>\"\n}"
                createdAt: '2026-06-05T13:14:17.000Z'
                updatedAt: '2026-06-05T13:14:17.000Z'
                uid: 35240-6ee7d060-55e7-4649-be66-83f45bd500ee
              createdAt: '2026-06-05T13:14:17.000Z'
              updatedAt: '2026-06-05T13:14:17.000Z'
              uid: 35240-1f8f51cd-a1d7-4e00-ad0b-49fa57cf262a
            id: 478b0599-d96f-43b7-83c1-a5043583fdb6
            createdAt: '2026-06-05T13:14:16.000Z'
            updatedAt: '2026-06-05T13:14:16.000Z'
            uid: 35240-478b0599-d96f-43b7-83c1-a5043583fdb6
          id: 54ef1ee9-dc25-4ecc-ad12-28a74965b187
          createdAt: '2026-06-05T13:14:16.000Z'
          updatedAt: '2026-06-05T13:14:16.000Z'
          uid: 35240-54ef1ee9-dc25-4ecc-ad12-28a74965b187
        - name: Etsy Get Buyer Taxonomy Nodes
          id: ab6adeb1-7303-4556-b4e1-1c227257725f
          protocolProfileBehavior:
            disableBodyPruning: true
          request:
            method: GET
            header:
            - key: Accept
              value: application/json
            url:
              raw: '{{baseUrl}}/v3/application/buyer-taxonomy/nodes'
              host:
              - '{{baseUrl}}'
              path:
              - v3
              - application
              - buyer-taxonomy
              - nodes
            description: '<div class="wt-display-flex-xs wt-align-items-center wt-mt-xs-2 wt-mb-xs-3"><span class="wt-badge
              wt-badge--notificationPrimary wt-bg-slime-tint wt-mr-xs-2">General Release</span><a class="wt-text-link" href="https://github.com/etsy/open-api/discussions"
              target="_blank" rel="noopener noreferrer">Report bug</a></div><div class="wt-display-flex-xs wt-align-items-center
              wt-mt-xs-2 wt-mb-xs-3"><p class="wt-text-body-01 banner-text">This endpoint is ready for production use.</p></div>


              Retrieves the full hierarchy tree of buyer taxonomy nodes.'
          response:
          - id: ea35ce43-61c1-48ce-9fbc-b9872edaaecb
            name: List the full hierarchy tree of buyer taxonomy nodes.
            originalRequest:
              method: GET
              header:
              - key: Accept
                value: application/json
              - description: 'Added as a part of security scheme: apikey'
                key: x-api-key
                value: <API Key>
              url:
                raw: '{{baseUrl}}/v3/application/buyer-taxonomy/nodes'
                host:
                - '{{baseUrl}}'
                path:
                - v3
                - application
                - buyer-taxonomy
                - nodes
            status: OK
            code: 200
            _postman_previewlanguage: json
            header:
            - key: Content-Type
              value: application/json
            cookie: []
            responseTime: null
            body: "{\n  \"count\": \"<integer>\",\n  \"results\": [\n    {\n      \"id\": \"<long>\",\n      \"level\": \"\
              <integer>\",\n      \"name\": \"<string>\",\n      \"parent_id\": null,\n      \"children\": [\n        {\n\
              \          \"value\": \"<Circular reference to #/components/schemas/BuyerTaxonomyNode detected>\"\n        },\n\
              \        {\n          \"value\": \"<Circular reference to #/components/schemas/BuyerTaxonomyNode detected>\"\
              \n        }\n      ],\n      \"full_path_taxonomy_ids\": [\n        \"<long>\",\n        \"<long>\"\n      ]\n\
              \    },\n    {\n      \"id\": \"<long>\",\n      \"level\": \"<integer>\",\n      \"name\": \"<string>\",\n\
              \      \"parent_id\": null,\n      \"children\": [\n        {\n          \"value\": \"<Circular reference to\
              \ #/components/schemas/BuyerTaxonomyNode detected>\"\n        },\n        {\n          \"value\": \"<Circular\
              \ reference to #/components/schemas/BuyerTaxonomyNode detected>\"\n        }\n      ],\n      \"full_path_taxonomy_ids\"\
              : [\n        \"<long>\",\n        \"<long>\"\n      ]\n    }\n  ]\n}"
            createdAt: '2026-06-05T13:14:17.000Z'
            updatedAt: '2026-06-05T13:14:17.000Z'
            uid: 35240-ea35ce43-61c1-48ce-9fbc-b9872edaaecb
          - id: ee3687eb-bf21-4e17-95f2-ab3e0c198546
            name: The server encountered an internal error. See the error message for details.
            originalRequest:
              method: GET
              header:
              - key: Accept
                value: application/json
              - description: 'Added as a part of security scheme: apikey'
                key: x-api-key
                value: <API Key>
              url:
                raw: '{{baseUrl}}/v3/application/buyer-taxonomy/nodes'
                host:
                - '{{baseUrl}}'
                path:
                - v3
                - application
                - buyer-taxonomy
                - nodes
            status: Internal Server Error
            code: 500
            _postman_previewlanguage: json
            header:
            - key: Content-Type
              value: application/json
            cookie: []
            responseTime: null
            body: "{\n  \"error\": \"<string>\"\n}"
            createdAt: '2026-06-05T13:14:17.000Z'
            updatedAt: '2026-06-05T13:14:17.000Z'
            uid: 35240-ee3687eb-bf21-4e17-95f2-ab3e0c198546
          createdAt: '2026-06-05T13:14:17.000Z'
          updatedAt: '2026-06-05T13:14:17.000Z'
          uid: 35240-ab6adeb1-7303-4556-b4e1-1c227257725f
        id: d45920e7-12ed-43d7-b76c-e26bca773edc
        createdAt: '2026-06-05T13:14:16.000Z'
        updatedAt: '2026-06-05T13:14:16.000Z'
        uid: 35240-d45920e7-12ed-43d7-b76c-e26bca773edc
      id: ab9169b8-4344-4abe-9946-54efff70a6e3
      createdAt: '2026-06-05T13:14:16.000Z'
      updatedAt: '2026-06-05T13:14:16.000Z'
      uid: 35240-ab9169b8-4344-4abe-9946-54efff70a6e3
    - name: shops
      item:
      - name: '{shop_id}'
        item:
        - name: listings
          item:
          - name: '{listing_id}'
            item:
            - name: files
              item:
              - name: '{listing_file_id}'
                item:
                - name: Etsy Delete Listing File
                  id: f94d4aa7-2c1a-4a6f-b375-705267ddd73c
                  protocolProfileBehavior:
                    disableBodyPruning: true
                  request:
                    auth:
                      type: apikey
                      apikey:
                      - key: key
                        value: x-api-key
                        type: string
                      - key: value
                        value: '{{apiKey}}'
                        type: string
                      - key: in
                        value: header
                        type: string
                    method: DELETE
                    header:
                    - key: Accept
                      value: application/json
                    url:
                      raw: '{{baseUrl}}/v3/application/shops/:shop_id/listings/:listing_id/files/:listing_file_id'
                      host:
                      - '{{baseUrl}}'
                      path:
                      - v3
                      - application
                      - shops
                      - :shop_id
                      - listings
                      - :listing_id
                      - files
                      - :listing_file_id
                      variable:
                      - id: 6ce3c91e-ea17-443e-a7df-a1829ee1f152
                        key: shop_id
                        value: <long>
                        description: (Required) The unique positive non-zero numeric ID for an Etsy Shop.
                      - id: a8daf952-36e5-48a4-bf1d-9ee8557b610c
                        key: listing_id
                        value: <long>
                        description: (Required) The numeric ID for the [listing](/documentation/reference#tag/ShopListing)
                          associated to this transaction.
                      - id: 641db630-78ca-40f7-91f5-37f74108557c
                        key: listing_file_id
                        value: <long>
                        description: (Required) The unique numeric ID of a file associated with a digital listing.
                    description: '<div class="wt-display-flex-xs wt-align-items-center wt-mt-xs-2 wt-mb-xs-3"><span class="wt-badge
                      wt-badge--notificationPrimary wt-bg-slime-tint wt-mr-xs-2">General Release</span><a class="wt-text-link"
                      href="https://github.com/etsy/open-api/discussions" target="_blank" rel="noopener noreferrer">Report
                      bug</a></div><div class="wt-display-flex-xs wt-align-items-center wt-mt-xs-2 wt-mb-xs-3"><p class="wt-text-body-01
                      banner-text">This endpoint is ready for production use.</p></div>


                      Deletes a file from a specific listing. When you delete the final file for a digital listing, the listing
                      converts into a physical listing. The response to a delete request returns a list of the remaining file
                      records associated with the given listing.'
                  response:
                  - id: 2fb7940e-343c-4466-b23c-f0ac85af3f24
                    name: The ShopListingFile resource was correctly deleted
                    originalRequest:
                      method: DELETE
                      header:
                      - description: 'Added as a part of security scheme: apikey'
                        key: x-api-key
                        value: <API Key>
                      url:
                        raw: '{{baseUrl}}/v3/application/shops/:shop_id/listings/:listing_id/files/:listing_file_id'
                        host:
                        - '{{baseUrl}}'
                        path:
                        - v3
                        - application
                        - shops
                        - :shop_id
                        - listings
                        - :listing_id
                        - files
                        - :listing_file_id
                        variable:
                        - key: shop_id
                        - key: listing_id
                        - key: listing_file_id
                    status: No Content
                    code: 204
                    _postman_previewlanguage: text
                    header: []
                    cookie: []
                    responseTime: null
                    body: null
                    createdAt: '2026-06-05T13:14:17.000Z'
                    updatedAt: '2026-06-05T13:14:17.000Z'
                    uid: 35240-2fb7940e-343c-4466-b23c-f0ac85af3f24
                  - id: 6347a1ea-c307-413a-aa97-2f43116bb9b6
                    name: There was a problem with the request data. See the error message for details.
                    originalRequest:
                      method: DELETE
                      header:
                      - key: Accept
                        value: application/json
                      - description: 'Added as a part of security scheme: apikey'
                        key: x-api-key
                        value: <API Key>
                      url:
                        raw: '{{baseUrl}}/v3/application/shops/:shop_id/listings/:listing_id/files/:listing_file_id'
                        host:
                        - '{{baseUrl}}'
                        path:
                        - v3
                        - application
                        - shops
                        - :shop_id
                        - listings
                        - :listing_id
                        - files
                        - :listing_file_id
                        variable:
                        - key: shop_id
                        - key: listing_id
                        - key: listing_file_id
                    status: Bad Request
                    code: 400
                    _postman_previewlanguage: json
                    header:
                    - key: Content-Type
                      value: application/json
                    cookie: []
                    responseTime: null
                    body: "{\n  \"error\": \"<string>\"\n}"
                    createdAt: '2026-06-05T13:14:17.000Z'
                    updatedAt: '2026-06-05T13:14:17.000Z'
                    uid: 35240-6347a1ea-c307-413a-aa97-2f43116bb9b6
                  - id: 65f34bb8-6877-401a-9b4e-71ffc99dd124
                    name: The request lacks valid authentication credentials. See the error message for details.
                    originalRequest:
                      method: DELETE
                      header:
                      - key: Accept
                        value: application/json
                      - description: 'Added as a part of security scheme: apikey'
                        key: x-api-key
                        value: <API Key>
                      url:
                        raw: '{{baseUrl}}/v3/application/shops/:shop_id/listings/:listing_id/files/:listing_file_id'
                        host:
                        - '{{baseUrl}}'
                        path:
                        - v3
                        - application
                        - shops
                        - :shop_id
                        - listings
                        - :listing_id
                        - files
                        - :listing_file_id
                        variable:
                        - key: shop_id
                        - key: listing_id
                        - key: listing_file_id
                    status: Unauthorized
                    code: 401
                    _postman_previewlanguage: json
                    header:
                    - key: Content-Type
                      value: application/json
                    cookie: []
                    responseTime: null
                    body: "{\n  \"error\": \"<string>\"\n}"
                    createdAt: '2026-06-05T13:14:17.000Z'
                    updatedAt: '2026-06-05T13:14:17.000Z'
                    uid: 35240-65f34bb8-6877-401a-9b4e-71ffc99dd124
                  - id: 1a6bef5e-5269-426a-8d81-fbdc84d7eba5
                    name: The request attempted to perform an operation it is not allowed to. See the error message for details.
                    originalRequest:
                      method: DELETE
                      header:
                      - key: Accept
                        value: application/json
                      - description: 'Added as a part of security scheme: apikey'
                        key: x-api-key
                        value: <API Key>
                      url:
                        raw: '{{baseUrl}}/v3/application/shops/:shop_id/listings/:listing_id/files/:listing_file_id'
                        host:
                        - '{{baseUrl}}'
                        path:
                        - v3
                        - application
                        - shops
                        - :shop_id
                        - listings
                        - :listing_id
                        - files
                        - :listing_file_id
                        variable:
                        - key: shop_id
                        - key: listing_id
                        - key: listing_file_id
                    status: Forbidden
                    code: 403
                    _postman_previewlanguage: json
                    header:
                    - key: Content-Type
                      value: application/json
                    cookie: []
                    responseTime: null
                    body: "{\n  \"error\": \"<string>\"\n}"
                    createdAt: '2026-06-05T13:14:17.000Z'
                    updatedAt: '2026-06-05T13:14:17.000Z'
                    uid: 35240-1a6bef5e-5269-426a-8d81-fbdc84d7eba5
                  - id: 4fe50db0-12c4-4250-a88c-e7cb20d219a7
                    name: A resource could not be found. See the error message for details.
                    originalRequest:
                      method: DELETE
                      header:
                      - key: Accept
                        value: application/json
                      - description: 'Added as a part of security scheme: apikey'
                        key: x-api-key
                        value: <API Key>
                      url:
                        raw: '{{baseUrl}}/v3/application/shops/:shop_id/listings/:listing_id/files/:listing_file_id'
                        host:
                        - '{{baseUrl}}'
                        path:
                        - v3
                        - application
                        - shops
                        - :shop_id
                        - listings
                        - :listing_id
                        - files
                        - :listing_file_id
                        variable:
                        - key: shop_id
                        - key: listing_id
                        - key: listing_file_id
                    status: Not Found
                    code: 404
                    _postman_previewlanguage: json
                    header:
                    - key: Content-Type
                      value: application/json
                    cookie: []
                    responseTime: null
                    body: "{\n  \"error\": \"<string>\"\n}"
                    createdAt: '2026-06-05T13:14:17.000Z'
                    updatedAt: '2026-06-05T13:14:17.000Z'
                    uid: 35240-4fe50db0-12c4-4250-a88c-e7cb20d219a7
                  - id: 1df4901d-6f02-45e4-b1e5-fc95a3fff49d
                    name: There was a request conflict with the current state of the target resource. See the error message
                      for details.
                    originalRequest:
                      method: DELETE
                      header:
                      - key: Accept
                        value: application/json
                      - description: 'Added as a part of security scheme: apikey'
                        key: x-api-key
                        value: <API Key>
                      url:
                        raw: '{{baseUrl}}/v3/application/shops/:shop_id/listings/:listing_id/files/:listing_file_id'
                        host:
                        - '{{baseUrl}}'
                        path:
                        - v3
                        - application
                        - shops
                        - :shop_id
                        - listings
                        - :listing_id
                        - files
                        - :listing_file_id
                        variable:
                        - key: shop_id
                        - key: listing_id
                        - key: listing_file_id
                    status: Conflict
                    code: 409
                    _postman_previewlanguage: json
                    header:
                    - key: Content-Type
                      value: application/json
                    cookie: []
                    responseTime: null
                    body: "{\n  \"error\": \"<string>\"\n}"
                    createdAt:

# --- truncated at 32 KB (1901 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/etsy/refs/heads/main/apis.yml