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.

Etsy publishes 28 APIs on the APIs.io network, including Open API v3 Webhooks, BuyerTaxonomy API, Ledger Entry API, and 25 more. Tagged areas include Marketplace, Ecommerce, Handmade, Listings, and Orders.

The Etsy catalog on APIs.io includes 1 event-driven AsyncAPI specification, 2 JSON-LD contexts, and 3 Spectral governance rulesets.

Etsy’s developer surface includes authentication, documentation, pricing, support, changelog, tooling, and 41 more developer resources.

🌐 Visit website 📡 Source on GitHub

65.6/100 strong ▼ -6.7 Agent 50/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6

AccessFreemiumSelf serve⚡ Free to try

28 APIs

MarketplaceEcommerceHandmadeListingsOrdersPaymentsReviewsShippingTaxonomyOAuth2

Kin Score

Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6

Composite quality — 65.6/100 · strong

Contract Quality 20.5 / 25

Developer Ergonomics 8.7 / 20

Commercial Clarity 14.2 / 20

Operational Transparency 10.3 / 13

Governance 6.3 / 12

Discoverability 5.9 / 10

Agent readiness — 50/100 · agent ready

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

MCP Server 0 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 8 / 8

Request/Response Examples 7 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 6 / 6

Agent Skills 0 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/etsy: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 28

Individual APIs this provider publishes, each with its own machine-readable definition.

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...

Etsy BuyerTaxonomy API

The BuyerTaxonomy API from Etsy — 2 operation(s) for buyertaxonomy.

Etsy Ledger Entry API

The Ledger Entry API from Etsy — 2 operation(s) for ledger entry.

Etsy Other API

The Other API from Etsy — 2 operation(s) for other.

Etsy Payment API

The Payment API from Etsy — 3 operation(s) for payment.

Etsy Review API

The Review API from Etsy — 2 operation(s) for review.

Etsy SellerTaxonomy API

The SellerTaxonomy API from Etsy — 2 operation(s) for sellertaxonomy.

Etsy Shop API

The Shop API from Etsy — 3 operation(s) for shop.

Etsy Shop HolidayPreferences API

The Shop HolidayPreferences API from Etsy — 2 operation(s) for shop holidaypreferences.

Etsy Shop ProcessingProfiles API

The Shop ProcessingProfiles API from Etsy — 2 operation(s) for shop processingprofiles.

Etsy Shop ProductionPartner API

The Shop ProductionPartner API from Etsy — 1 operation(s) for shop productionpartner.

Etsy Shop Receipt API

The Shop Receipt API from Etsy — 3 operation(s) for shop receipt.

Etsy Shop Receipt Transactions API

The Shop Receipt Transactions API from Etsy — 4 operation(s) for shop receipt transactions.

Etsy Shop Return Policy API

The Shop Return Policy API from Etsy — 3 operation(s) for shop return policy.

Etsy Shop Section API

The Shop Section API from Etsy — 2 operation(s) for shop section.

Etsy Shop ShippingProfile API

The Shop ShippingProfile API from Etsy — 7 operation(s) for shop shippingprofile.

Etsy ShopListing API

The ShopListing API from Etsy — 13 operation(s) for shoplisting.

Etsy ShopListing File API

The ShopListing File API from Etsy — 2 operation(s) for shoplisting file.

Etsy ShopListing Image API

The ShopListing Image API from Etsy — 4 operation(s) for shoplisting image.

Etsy ShopListing Inventory API

The ShopListing Inventory API from Etsy — 1 operation(s) for shoplisting inventory.

Etsy ShopListing Offering API

The ShopListing Offering API from Etsy — 1 operation(s) for shoplisting offering.

Etsy ShopListing Personalization API

The ShopListing Personalization API from Etsy — 2 operation(s) for shoplisting personalization.

Etsy ShopListing Product API

The ShopListing Product API from Etsy — 1 operation(s) for shoplisting product.

Etsy ShopListing Translation API

The ShopListing Translation API from Etsy — 1 operation(s) for shoplisting translation.

Etsy ShopListing VariationImage API

The ShopListing VariationImage API from Etsy — 1 operation(s) for shoplisting variationimage.

Etsy ShopListing Video API

The ShopListing Video API from Etsy — 4 operation(s) for shoplisting video.

Etsy User API

The User API from Etsy — 2 operation(s) for user.

Etsy UserAddress API

The UserAddress API from Etsy — 2 operation(s) for useraddress.

Scroll for all 28

Postman Collections 1

Ready-to-run Postman collections for exercising this provider's APIs.

Etsy Open API v3

POSTMAN

Arazzo Workflows 18

Multi-step API workflows described with the Arazzo specification.

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

Scroll for all 18

Pricing Plans 1

Published pricing tiers and plan structures.

Etsy Plans Pricing

3 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Etsy Rate Limits

5 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Etsy Finops

FINOPS

Event Specifications 1

AsyncAPI definitions for this provider's event-driven and streaming APIs.

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 2

JSON-LD contexts and semantic vocabularies used across these APIs.

Etsy Open Api V3 Context

81 classes · 348 properties

JSON-LD

Etsy Webhooks Context

1 classes · 3 properties

JSON-LD

Spectral Rules 3

Spectral governance rulesets for linting and validating these APIs.

Etsy API Rules

7 rules · 1 errors 6 warnings

SPECTRAL

Etsy API Rules

5 rules · 4 warnings 1 info

SPECTRAL

Etsy API Rules

54 rules · 17 errors 26 warnings 11 info

SPECTRAL

JSON Schema 86

Standalone JSON Schema definitions for this provider's data models.

BuyerTaxonomyNodeProperties

2 properties

JSON SCHEMA

BuyerTaxonomyNodeProperty

11 properties

JSON SCHEMA

BuyerTaxonomyNode

6 properties

JSON SCHEMA

BuyerTaxonomyNodes

2 properties

JSON SCHEMA

BuyerTaxonomyPropertyScale

3 properties

JSON SCHEMA

BuyerTaxonomyPropertyValue

4 properties

JSON SCHEMA

ErrorSchema

1 properties

JSON SCHEMA

Etsy_Modules_ListingPersonalization_Api_Resources_OpenApi_ListingPersonalization

1 properties

JSON SCHEMA

Etsy_Modules_ListingPersonalization_Api_Resources_OpenApi_PersonalizationQuestion

8 properties

JSON SCHEMA

ListingBuyerPrice

10 properties

JSON SCHEMA

ListingImage

20 properties

JSON SCHEMA

ListingImages

2 properties

JSON SCHEMA

ListingInventoryProductOffering

6 properties

JSON SCHEMA

ListingInventoryProduct

5 properties

JSON SCHEMA

ListingInventory

5 properties

JSON SCHEMA

ListingInventoryWithAssociations

6 properties

JSON SCHEMA

ListingPropertyValue

6 properties

JSON SCHEMA

ListingPropertyValues

2 properties

JSON SCHEMA

ListingReview

10 properties

JSON SCHEMA

ListingReviews

2 properties

JSON SCHEMA

ListingTranslation

5 properties

JSON SCHEMA

ListingTranslations

13 properties

JSON SCHEMA

ListingVariationImage

4 properties

JSON SCHEMA

ListingVariationImages

2 properties

JSON SCHEMA

ListingVideo

6 properties

JSON SCHEMA

ListingVideos

2 properties

JSON SCHEMA

Money

3 properties

JSON SCHEMA

PaymentAccountLedgerEntries

2 properties

JSON SCHEMA

PaymentAccountLedgerEntry

14 properties

JSON SCHEMA

PaymentAdjustmentItem

9 properties

JSON SCHEMA

PaymentAdjustment

15 properties

JSON SCHEMA

Payment

26 properties

JSON SCHEMA

Payments

2 properties

JSON SCHEMA

Pong

1 properties

JSON SCHEMA

Scopes

0 properties

JSON SCHEMA

Self

2 properties

JSON SCHEMA

SellerTaxonomyNode

6 properties

JSON SCHEMA

SellerTaxonomyNodes

2 properties

JSON SCHEMA

ShippingCarrierMailClass

2 properties

JSON SCHEMA

ShippingCarrier

4 properties

JSON SCHEMA

ShippingCarriers

2 properties

JSON SCHEMA

ShopHolidayPreference

5 properties

JSON SCHEMA

ShopListingFile

9 properties

JSON SCHEMA

ShopListingFiles

2 properties

JSON SCHEMA

ShopListing

49 properties

JSON SCHEMA

ShopListingWithAssociations

61 properties

JSON SCHEMA

ShopListings

2 properties

JSON SCHEMA

ShopListingsWithAssociations

2 properties

JSON SCHEMA

ShopProcessingProfile

6 properties

JSON SCHEMA

ShopProcessingProfiles

2 properties

JSON SCHEMA

ShopProductionPartner

3 properties

JSON SCHEMA

ShopProductionPartners

2 properties

JSON SCHEMA

ShopReceipt

40 properties

JSON SCHEMA

ShopReceiptShipment

4 properties

JSON SCHEMA

ShopReceiptTransaction

30 properties

JSON SCHEMA

ShopReceiptTransactions

2 properties

JSON SCHEMA

ShopReceipts

2 properties

JSON SCHEMA

ShopRefund

5 properties

JSON SCHEMA

ShopReturnPolicies

2 properties

JSON SCHEMA

ShopReturnPolicy

5 properties

JSON SCHEMA

Shop

47 properties

JSON SCHEMA

ShopSection

5 properties

JSON SCHEMA

ShopSections

2 properties

JSON SCHEMA

ShopShippingProfileDestination

11 properties

JSON SCHEMA

ShopShippingProfileDestinations

2 properties

JSON SCHEMA

ShopShippingProfile

11 properties

JSON SCHEMA

ShopShippingProfileUpgrade

12 properties

JSON SCHEMA

ShopShippingProfileUpgrades

2 properties

JSON SCHEMA

ShopShippingProfiles

2 properties

JSON SCHEMA

Shops

2 properties

JSON SCHEMA

TaxonomyNodeProperties

2 properties

JSON SCHEMA

TaxonomyNodeProperty

11 properties

JSON SCHEMA

TaxonomyPropertyScale

3 properties

JSON SCHEMA

TaxonomyPropertyValue

4 properties

JSON SCHEMA

TransactionReview

12 properties

JSON SCHEMA

TransactionReviews

2 properties

JSON SCHEMA

TransactionVariations

5 properties

JSON SCHEMA

TypeDiscriminator

1 properties

JSON SCHEMA

UserAddress

11 properties

JSON SCHEMA

UserAddresses

2 properties

JSON SCHEMA

User

5 properties

JSON SCHEMA

OrderCanceledPayload

0 properties

JSON SCHEMA

OrderDeliveredPayload

0 properties

JSON SCHEMA

OrderPaidPayload

0 properties

JSON SCHEMA

OrderShippedPayload

0 properties

JSON SCHEMA

WebhookEnvelope

3 properties

JSON SCHEMA

Scroll for all 86

JSON Structure 86

JSON Structure definitions describing this provider's data shapes.

Open Api V3 Buyer Taxonomy Node Properties Structure

2 properties

JSON STRUCTURE

Open Api V3 Buyer Taxonomy Node Property Structure

11 properties

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 Buyer Taxonomy Property Scale Structure

3 properties

JSON STRUCTURE

Open Api V3 Buyer Taxonomy Property Value Structure

4 properties

JSON STRUCTURE

Open Api V3 Error Schema Structure

1 properties

JSON STRUCTURE

Open Api V3 Etsy Modules Listing Personalization Api Resources Open Api Listing Personalization Structure

1 properties

JSON STRUCTURE

Open Api V3 Etsy Modules Listing Personalization Api Resources Open Api Personalization Question Structure

8 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 Product Offering Structure

6 properties

JSON STRUCTURE

Open Api V3 Listing Inventory Product Structure

5 properties

JSON STRUCTURE

Open Api V3 Listing Inventory Structure

5 properties

JSON STRUCTURE

Open Api V3 Listing Inventory With Associations Structure

6 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 Variation Images Structure

2 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 Account Ledger Entries Structure

2 properties

JSON STRUCTURE

Open Api V3 Payment Account Ledger Entry Structure

14 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 Mail Class 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 Listing With Associations Structure

61 properties

JSON STRUCTURE

Open Api V3 Shop Listings Structure

2 properties

JSON STRUCTURE

Open Api V3 Shop Listings With Associations Structure

2 properties

JSON STRUCTURE

Open Api V3 Shop Processing Profile Structure

6 properties

JSON STRUCTURE

Open Api V3 Shop Processing Profiles Structure

2 properties

JSON STRUCTURE

Open Api V3 Shop Production Partner Structure

3 properties

JSON STRUCTURE

Open Api V3 Shop Production Partners Structure

2 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 Receipt Transactions Structure

2 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 Destination Structure

11 properties

JSON STRUCTURE

Open Api V3 Shop Shipping Profile Destinations Structure

2 properties

JSON STRUCTURE

Open Api V3 Shop Shipping Profile Structure

11 properties

JSON STRUCTURE

Open Api V3 Shop Shipping Profile Upgrade Structure

12 properties

JSON STRUCTURE

Open Api V3 Shop Shipping Profile Upgrades Structure

2 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 Properties 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

Scroll for all 86

Examples 86

Example request and response payloads for these APIs.

Open Api V3 Buyer Taxonomy Node Example

6 fields

EXAMPLE

Open Api V3 Buyer Taxonomy Node Properties Example

2 fields

EXAMPLE

Open Api V3 Buyer Taxonomy Node Property Example

11 fields

EXAMPLE

Open Api V3 Buyer Taxonomy Nodes Example

2 fields

EXAMPLE

Open Api V3 Buyer Taxonomy Property Scale Example

3 fields

EXAMPLE

Open Api V3 Buyer Taxonomy Property Value Example

4 fields

EXAMPLE

Open Api V3 Error Schema Example

1 fields

EXAMPLE

Open Api V3 Etsy Modules Listing Personalization Api Resources Open Api Listing Personalization Example

1 fields

EXAMPLE

Open Api V3 Etsy Modules Listing Personalization Api Resources Open Api Personalization Question Example

8 fields

EXAMPLE

Open Api V3 Listing Buyer Price Example

10 fields

EXAMPLE

Open Api V3 Listing Image Example

20 fields

EXAMPLE

Open Api V3 Listing Images Example

2 fields

EXAMPLE

Open Api V3 Listing Inventory Example

5 fields

EXAMPLE

Open Api V3 Listing Inventory Product Example

5 fields

EXAMPLE

Open Api V3 Listing Inventory Product Offering Example

6 fields

EXAMPLE

Open Api V3 Listing Inventory With Associations Example

6 fields

EXAMPLE

Open Api V3 Listing Property Value Example

6 fields

EXAMPLE

Open Api V3 Listing Property Values Example

2 fields

EXAMPLE

Open Api V3 Listing Review Example

10 fields

EXAMPLE

Open Api V3 Listing Reviews Example

2 fields

EXAMPLE

Open Api V3 Listing Translation Example

5 fields

EXAMPLE

Open Api V3 Listing Translations Example

13 fields

EXAMPLE

Open Api V3 Listing Variation Image Example

4 fields

EXAMPLE

Open Api V3 Listing Variation Images Example

2 fields

EXAMPLE

Open Api V3 Listing Video Example

6 fields

EXAMPLE

Open Api V3 Listing Videos Example

2 fields

EXAMPLE

Open Api V3 Money Example

3 fields

EXAMPLE

Open Api V3 Payment Account Ledger Entries Example

2 fields

EXAMPLE

Open Api V3 Payment Account Ledger Entry Example

14 fields

EXAMPLE

Open Api V3 Payment Adjustment Example

15 fields

EXAMPLE

Open Api V3 Payment Adjustment Item Example

9 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 Scopes Example

0 fields

EXAMPLE

Open Api V3 Self Example

2 fields

EXAMPLE

Open Api V3 Seller Taxonomy Node Example

6 fields

EXAMPLE

Open Api V3 Seller Taxonomy Nodes Example

2 fields

EXAMPLE

Open Api V3 Shipping Carrier Example

4 fields

EXAMPLE

Open Api V3 Shipping Carrier Mail Class Example

2 fields

EXAMPLE

Open Api V3 Shipping Carriers Example

2 fields

EXAMPLE

Open Api V3 Shop Example

47 fields

EXAMPLE

Open Api V3 Shop Holiday Preference Example

5 fields

EXAMPLE

Open Api V3 Shop Listing Example

49 fields

EXAMPLE

Open Api V3 Shop Listing File Example

9 fields

EXAMPLE

Open Api V3 Shop Listing Files Example

2 fields

EXAMPLE

Open Api V3 Shop Listing With Associations Example

61 fields

EXAMPLE

Open Api V3 Shop Listings Example

2 fields

EXAMPLE

Open Api V3 Shop Listings With Associations Example

2 fields

EXAMPLE

Open Api V3 Shop Processing Profile Example

6 fields

EXAMPLE

Open Api V3 Shop Processing Profiles Example

2 fields

EXAMPLE

Open Api V3 Shop Production Partner Example

3 fields

EXAMPLE

Open Api V3 Shop Production Partners Example

2 fields

EXAMPLE

Open Api V3 Shop Receipt Example

40 fields

EXAMPLE

Open Api V3 Shop Receipt Shipment Example

4 fields

EXAMPLE

Open Api V3 Shop Receipt Transaction Example

30 fields

EXAMPLE

Open Api V3 Shop Receipt Transactions Example

2 fields

EXAMPLE

Open Api V3 Shop Receipts Example

2 fields

EXAMPLE

Open Api V3 Shop Refund Example

5 fields

EXAMPLE

Open Api V3 Shop Return Policies Example

2 fields

EXAMPLE

Open Api V3 Shop Return Policy Example

5 fields

EXAMPLE

Open Api V3 Shop Section Example

5 fields

EXAMPLE

Open Api V3 Shop Sections Example

2 fields

EXAMPLE

Open Api V3 Shop Shipping Profile Destination Example

11 fields

EXAMPLE

Open Api V3 Shop Shipping Profile Destinations Example

2 fields

EXAMPLE

Open Api V3 Shop Shipping Profile Example

11 fields

EXAMPLE

Open Api V3 Shop Shipping Profile Upgrade Example

12 fields

EXAMPLE

Open Api V3 Shop Shipping Profile Upgrades Example

2 fields

EXAMPLE

Open Api V3 Shop Shipping Profiles Example

2 fields

EXAMPLE

Open Api V3 Shops Example

2 fields

EXAMPLE

Open Api V3 Taxonomy Node Properties Example

2 fields

EXAMPLE

Open Api V3 Taxonomy Node Property Example

11 fields

EXAMPLE

Open Api V3 Taxonomy Property Scale Example

3 fields

EXAMPLE

Open Api V3 Taxonomy Property Value Example

4 fields

EXAMPLE

Open Api V3 Transaction Review Example

12 fields

EXAMPLE

Open Api V3 Transaction Reviews Example

2 fields

EXAMPLE

Open Api V3 Transaction Variations Example

5 fields

EXAMPLE

Open Api V3 Type Discriminator Example

1 fields

EXAMPLE

Open Api V3 User Address Example

11 fields

EXAMPLE

Open Api V3 User Addresses Example

2 fields

EXAMPLE

Open Api V3 User Example

5 fields

EXAMPLE

Webhooks Order Canceled Payload Example

1 fields

EXAMPLE

Webhooks Order Delivered Payload Example

1 fields

EXAMPLE

Webhooks Order Paid Payload Example

3 fields

EXAMPLE

Webhooks Order Shipped Payload Example

1 fields

EXAMPLE

Webhooks Webhook Envelope Example

3 fields

EXAMPLE

Scroll for all 86

Security Posture 3

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Etsy Authentication

apiKey/oauth2 · 2 schemes

SECURITY

Etsy Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Etsy Vulnerability Disclosure

Bugcrowd · security.txt · contact published

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Etsy Scopes

20 scopes · authorizationCode

20 scopes

SCOPES

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Etsy Agentic Access

103 operations · 42 acting

103 operations · 42 acting

AGENTIC

Resources

Get Started 1

Portal, sign-up, and the first successful call

DeveloperPortal

DeveloperPortal

Documentation 2

Reference material describing how the API behaves

Documentation

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

Design & Contract 20

Pagination, idempotency, versioning, errors, and events

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

SpectralRules

Scroll for all 20

Build 6

SDKs, sample code, and the tooling you integrate with

PostmanWorkspace

PostmanWorkspace

GitHubOrganization

GitHubOrganization

CodeOfConduct

Pinot MCP Server (Etsy fork)

XCLogParser

Cartography

Access & Security 5

Authentication, authorization, and security posture

VulnerabilityDisclosure

VulnerabilityDisclosure

DomainSecurity

Authentication

OAuthScopes

SecurityPolicy

Operate 4

Status, limits, changes, and where to get help

Support

Commercial 5

Pricing, plans, and the legal terms of use

TermsOfService

PrivacyPolicy

Pricing

Plans

FinOps

Company 3

The organization behind the API

Website

TwitterAccount

Source (apis.yml)

aid: etsy
url: https://raw.githubusercontent.com/api-evangelist/etsy/refs/heads/main/apis.yml
name: Etsy
type: Index
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/etsy.png
description: 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.
created: '2026-05-05'
modified: '2026-05-30'
specificationVersion: '0.19'
tags:
- Marketplace
- Ecommerce
- Handmade
- Listings
- Orders
- Payments
- Reviews
- Shipping
- Taxonomy
- OAuth2
common:
- type: AgenticAccess
  url: agentic-access/etsy-agentic-access.yml
- type: VulnerabilityDisclosure
  url: security/etsy-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/etsy-domain-security.yml
- type: Authentication
  url: authentication/etsy-authentication.yml
- type: OAuthScopes
  url: scopes/etsy-scopes.yml
- type: PostmanWorkspace
  url: https://www.postman.com/kinlaneapi/etsy/overview
- type: Arazzo
  url: arazzo/etsy-clone-image-to-new-listing-workflow.yml
  name: Etsy Clone an Image to a New Listing
- type: Arazzo
  url: arazzo/etsy-create-return-policy-and-listing-workflow.yml
  name: Etsy Create Return Policy and Listing
- type: Arazzo
  url: arazzo/etsy-create-shipping-profile-and-listing-workflow.yml
  name: Etsy Create Shipping Profile and Listing
- type: Arazzo
  url: arazzo/etsy-fulfill-receipt-workflow.yml
  name: Etsy Fulfill a Receipt
- type: Arazzo
  url: arazzo/etsy-get-my-shop-listings-workflow.yml
  name: Etsy Get My Shop Listings
- type: Arazzo
  url: arazzo/etsy-listing-reviews-workflow.yml
  name: Etsy Listing Reviews
- type: Arazzo
  url: arazzo/etsy-listing-with-inventory-workflow.yml
  name: Etsy Listing with Inventory
- type: Arazzo
  url: arazzo/etsy-organize-listing-into-section-workflow.yml
  name: Etsy Organize a Listing into a Section
- type: Arazzo
  url: arazzo/etsy-process-unshipped-orders-workflow.yml
  name: Etsy Process Unshipped Orders
- type: Arazzo
  url: arazzo/etsy-publish-physical-listing-workflow.yml
  name: Etsy Publish a Physical Listing
- type: Arazzo
  url: arazzo/etsy-receipt-listings-detail-workflow.yml
  name: Etsy Receipt Listings Detail
- type: Arazzo
  url: arazzo/etsy-receipt-with-transactions-workflow.yml
  name: Etsy Receipt with Transactions
- type: Arazzo
  url: arazzo/etsy-reprice-listing-inventory-workflow.yml
  name: Etsy Reprice Listing Inventory
- type: Arazzo
  url: arazzo/etsy-shop-reviews-overview-workflow.yml
  name: Etsy Shop Reviews Overview
- type: Arazzo
  url: arazzo/etsy-shop-shipping-profiles-workflow.yml
  name: Etsy Shop Shipping Profiles
- type: Arazzo
  url: arazzo/etsy-shop-transactions-report-workflow.yml
  name: Etsy Shop Transactions Report
- type: Arazzo
  url: arazzo/etsy-update-shop-storefront-workflow.yml
  name: Etsy Update Shop Storefront
- type: Arazzo
  url: arazzo/etsy-user-shop-profile-workflow.yml
  name: Etsy User Shop Profile
- type: Website
  url: https://www.etsy.com
- type: DeveloperPortal
  url: https://developers.etsy.com/
- type: Documentation
  url: https://developers.etsy.com/documentation
- type: Reference
  url: https://developers.etsy.com/documentation/reference
- type: GitHubOrganization
  url: https://github.com/etsy
- type: LinkedIn
  url: https://www.linkedin.com/company/etsy
- type: TwitterAccount
  url: https://twitter.com/etsy
- type: StatusPage
  url: https://www.etsystatus.com/
- type: TermsOfService
  url: https://www.etsy.com/legal/api/terms
- type: PrivacyPolicy
  url: https://www.etsy.com/legal/privacy
- type: SecurityPolicy
  url: https://www.etsy.com/legal/api/terms
- type: Pricing
  url: https://developers.etsy.com/documentation/essentials/rate-limits
- type: Support
  url: mailto:developers@etsy.com
- type: ChangeLog
  url: https://developers.etsy.com/changelog
- type: CodeOfConduct
  url: https://etsy.github.io/codeofconduct.html
- type: Plans
  url: plans/etsy-plans-pricing.yml
- type: RateLimits
  url: rate-limits/etsy-rate-limits.yml
- type: FinOps
  url: finops/etsy-finops.yml
- type: Vocabulary
  url: vocabulary/etsy-vocabulary.yml
- type: SpectralRules
  url: rules/etsy-rules.yml
- type: Tools
  title: Pinot MCP Server (Etsy fork)
  url: https://github.com/etsy/mcp-pinot
- type: Tools
  title: XCLogParser
  url: https://github.com/etsy/XCLogParser
- type: Tools
  title: Cartography
  url: https://github.com/etsy/cartography
apis:
- aid: etsy:webhooks
  name: Etsy Open API v3 Webhooks
  description: 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.delivered), the common webhook envelope (event_type, resource_url,
    shop_id), the signing headers (webhook-id, webhook-timestamp, webhook-signature), HMAC-SHA256 signature verification procedure,
    and Etsy's documented retry schedule.
  humanURL: https://developers.etsy.com/documentation/essentials/webhooks
  tags:
  - Webhooks
  - Events
  - AsyncAPI
  - Order Lifecycle
  properties:
  - type: Documentation
    url: https://developers.etsy.com/documentation/essentials/webhooks
  - type: AsyncAPI
    url: https://raw.githubusercontent.com/api-evangelist/etsy/refs/heads/main/asyncapi/etsy-webhooks-asyncapi.yml
- aid: etsy:etsy-buyertaxonomy-api
  name: Etsy BuyerTaxonomy API
  description: The BuyerTaxonomy API from Etsy — 2 operation(s) for buyertaxonomy.
  humanURL: https://developers.etsy.com/documentation
  baseURL: https://openapi.etsy.com
  tags:
  - BuyerTaxonomy
  properties:
  - type: OpenAPI
    url: openapi/etsy-buyertaxonomy-api-openapi.yml
  - type: Documentation
    url: https://developers.etsy.com/documentation
  - type: Reference
    url: https://developers.etsy.com/documentation/reference
  - type: Authentication
    url: https://developers.etsy.com/documentation/essentials/authentication
  - type: OAuth2
    url: https://developers.etsy.com/documentation/essentials/oauth2
  - type: RateLimits
    url: https://developers.etsy.com/documentation/essentials/rate-limits
  - type: Requests
    url: https://developers.etsy.com/documentation/essentials/requests
  - type: Migration
    url: https://developers.etsy.com/documentation/migration/index
  - type: SourceCode
    url: https://github.com/etsy/open-api
- aid: etsy:etsy-ledger-entry-api
  name: Etsy Ledger Entry API
  description: The Ledger Entry API from Etsy — 2 operation(s) for ledger entry.
  humanURL: https://developers.etsy.com/documentation
  baseURL: https://openapi.etsy.com
  tags:
  - Ledger Entry
  properties:
  - type: OpenAPI
    url: openapi/etsy-ledger-entry-api-openapi.yml
  - type: Documentation
    url: https://developers.etsy.com/documentation
  - type: Reference
    url: https://developers.etsy.com/documentation/reference
  - type: Authentication
    url: https://developers.etsy.com/documentation/essentials/authentication
  - type: OAuth2
    url: https://developers.etsy.com/documentation/essentials/oauth2
  - type: RateLimits
    url: https://developers.etsy.com/documentation/essentials/rate-limits
  - type: Requests
    url: https://developers.etsy.com/documentation/essentials/requests
  - type: Migration
    url: https://developers.etsy.com/documentation/migration/index
  - type: SourceCode
    url: https://github.com/etsy/open-api
- aid: etsy:etsy-other-api
  name: Etsy Other API
  description: The Other API from Etsy — 2 operation(s) for other.
  humanURL: https://developers.etsy.com/documentation
  baseURL: https://openapi.etsy.com
  tags:
  - Other
  properties:
  - type: OpenAPI
    url: openapi/etsy-other-api-openapi.yml
  - type: Documentation
    url: https://developers.etsy.com/documentation
  - type: Reference
    url: https://developers.etsy.com/documentation/reference
  - type: Authentication
    url: https://developers.etsy.com/documentation/essentials/authentication
  - type: OAuth2
    url: https://developers.etsy.com/documentation/essentials/oauth2
  - type: RateLimits
    url: https://developers.etsy.com/documentation/essentials/rate-limits
  - type: Requests
    url: https://developers.etsy.com/documentation/essentials/requests
  - type: Migration
    url: https://developers.etsy.com/documentation/migration/index
  - type: SourceCode
    url: https://github.com/etsy/open-api
- aid: etsy:etsy-payment-api
  name: Etsy Payment API
  description: The Payment API from Etsy — 3 operation(s) for payment.
  humanURL: https://developers.etsy.com/documentation
  baseURL: https://openapi.etsy.com
  tags:
  - Payment
  properties:
  - type: OpenAPI
    url: openapi/etsy-payment-api-openapi.yml
  - type: Documentation
    url: https://developers.etsy.com/documentation
  - type: Reference
    url: https://developers.etsy.com/documentation/reference
  - type: Authentication
    url: https://developers.etsy.com/documentation/essentials/authentication
  - type: OAuth2
    url: https://developers.etsy.com/documentation/essentials/oauth2
  - type: RateLimits
    url: https://developers.etsy.com/documentation/essentials/rate-limits
  - type: Requests
    url: https://developers.etsy.com/documentation/essentials/requests
  - type: Migration
    url: https://developers.etsy.com/documentation/migration/index
  - type: SourceCode
    url: https://github.com/etsy/open-api
- aid: etsy:etsy-review-api
  name: Etsy Review API
  description: The Review API from Etsy — 2 operation(s) for review.
  humanURL: https://developers.etsy.com/documentation
  baseURL: https://openapi.etsy.com
  tags:
  - Review
  properties:
  - type: OpenAPI
    url: openapi/etsy-review-api-openapi.yml
  - type: Documentation
    url: https://developers.etsy.com/documentation
  - type: Reference
    url: https://developers.etsy.com/documentation/reference
  - type: Authentication
    url: https://developers.etsy.com/documentation/essentials/authentication
  - type: OAuth2
    url: https://developers.etsy.com/documentation/essentials/oauth2
  - type: RateLimits
    url: https://developers.etsy.com/documentation/essentials/rate-limits
  - type: Requests
    url: https://developers.etsy.com/documentation/essentials/requests
  - type: Migration
    url: https://developers.etsy.com/documentation/migration/index
  - type: SourceCode
    url: https://github.com/etsy/open-api
- aid: etsy:etsy-sellertaxonomy-api
  name: Etsy SellerTaxonomy API
  description: The SellerTaxonomy API from Etsy — 2 operation(s) for sellertaxonomy.
  humanURL: https://developers.etsy.com/documentation
  baseURL: https://openapi.etsy.com
  tags:
  - SellerTaxonomy
  properties:
  - type: OpenAPI
    url: openapi/etsy-sellertaxonomy-api-openapi.yml
  - type: Documentation
    url: https://developers.etsy.com/documentation
  - type: Reference
    url: https://developers.etsy.com/documentation/reference
  - type: Authentication
    url: https://developers.etsy.com/documentation/essentials/authentication
  - type: OAuth2
    url: https://developers.etsy.com/documentation/essentials/oauth2
  - type: RateLimits
    url: https://developers.etsy.com/documentation/essentials/rate-limits
  - type: Requests
    url: https://developers.etsy.com/documentation/essentials/requests
  - type: Migration
    url: https://developers.etsy.com/documentation/migration/index
  - type: SourceCode
    url: https://github.com/etsy/open-api
- aid: etsy:etsy-shop-api
  name: Etsy Shop API
  description: The Shop API from Etsy — 3 operation(s) for shop.
  humanURL: https://developers.etsy.com/documentation
  baseURL: https://openapi.etsy.com
  tags:
  - Shop
  properties:
  - type: OpenAPI
    url: openapi/etsy-shop-api-openapi.yml
  - type: Documentation
    url: https://developers.etsy.com/documentation
  - type: Reference
    url: https://developers.etsy.com/documentation/reference
  - type: Authentication
    url: https://developers.etsy.com/documentation/essentials/authentication
  - type: OAuth2
    url: https://developers.etsy.com/documentation/essentials/oauth2
  - type: RateLimits
    url: https://developers.etsy.com/documentation/essentials/rate-limits
  - type: Requests
    url: https://developers.etsy.com/documentation/essentials/requests
  - type: Migration
    url: https://developers.etsy.com/documentation/migration/index
  - type: SourceCode
    url: https://github.com/etsy/open-api
- aid: etsy:etsy-shop-holidaypreferences-api
  name: Etsy Shop HolidayPreferences API
  description: The Shop HolidayPreferences API from Etsy — 2 operation(s) for shop holidaypreferences.
  humanURL: https://developers.etsy.com/documentation
  baseURL: https://openapi.etsy.com
  tags:
  - Shop HolidayPreferences
  properties:
  - type: OpenAPI
    url: openapi/etsy-shop-holidaypreferences-api-openapi.yml
  - type: Documentation
    url: https://developers.etsy.com/documentation
  - type: Reference
    url: https://developers.etsy.com/documentation/reference
  - type: Authentication
    url: https://developers.etsy.com/documentation/essentials/authentication
  - type: OAuth2
    url: https://developers.etsy.com/documentation/essentials/oauth2
  - type: RateLimits
    url: https://developers.etsy.com/documentation/essentials/rate-limits
  - type: Requests
    url: https://developers.etsy.com/documentation/essentials/requests
  - type: Migration
    url: https://developers.etsy.com/documentation/migration/index
  - type: SourceCode
    url: https://github.com/etsy/open-api
- aid: etsy:etsy-shop-processingprofiles-api
  name: Etsy Shop ProcessingProfiles API
  description: The Shop ProcessingProfiles API from Etsy — 2 operation(s) for shop processingprofiles.
  humanURL: https://developers.etsy.com/documentation
  baseURL: https://openapi.etsy.com
  tags:
  - Shop ProcessingProfiles
  properties:
  - type: OpenAPI
    url: openapi/etsy-shop-processingprofiles-api-openapi.yml
  - type: Documentation
    url: https://developers.etsy.com/documentation
  - type: Reference
    url: https://developers.etsy.com/documentation/reference
  - type: Authentication
    url: https://developers.etsy.com/documentation/essentials/authentication
  - type: OAuth2
    url: https://developers.etsy.com/documentation/essentials/oauth2
  - type: RateLimits
    url: https://developers.etsy.com/documentation/essentials/rate-limits
  - type: Requests
    url: https://developers.etsy.com/documentation/essentials/requests
  - type: Migration
    url: https://developers.etsy.com/documentation/migration/index
  - type: SourceCode
    url: https://github.com/etsy/open-api
- aid: etsy:etsy-shop-productionpartner-api
  name: Etsy Shop ProductionPartner API
  description: The Shop ProductionPartner API from Etsy — 1 operation(s) for shop productionpartner.
  humanURL: https://developers.etsy.com/documentation
  baseURL: https://openapi.etsy.com
  tags:
  - Shop ProductionPartner
  properties:
  - type: OpenAPI
    url: openapi/etsy-shop-productionpartner-api-openapi.yml
  - type: Documentation
    url: https://developers.etsy.com/documentation
  - type: Reference
    url: https://developers.etsy.com/documentation/reference
  - type: Authentication
    url: https://developers.etsy.com/documentation/essentials/authentication
  - type: OAuth2
    url: https://developers.etsy.com/documentation/essentials/oauth2
  - type: RateLimits
    url: https://developers.etsy.com/documentation/essentials/rate-limits
  - type: Requests
    url: https://developers.etsy.com/documentation/essentials/requests
  - type: Migration
    url: https://developers.etsy.com/documentation/migration/index
  - type: SourceCode
    url: https://github.com/etsy/open-api
- aid: etsy:etsy-shop-receipt-api
  name: Etsy Shop Receipt API
  description: The Shop Receipt API from Etsy — 3 operation(s) for shop receipt.
  humanURL: https://developers.etsy.com/documentation
  baseURL: https://openapi.etsy.com
  tags:
  - Shop Receipt
  properties:
  - type: OpenAPI
    url: openapi/etsy-shop-receipt-api-openapi.yml
  - type: Documentation
    url: https://developers.etsy.com/documentation
  - type: Reference
    url: https://developers.etsy.com/documentation/reference
  - type: Authentication
    url: https://developers.etsy.com/documentation/essentials/authentication
  - type: OAuth2
    url: https://developers.etsy.com/documentation/essentials/oauth2
  - type: RateLimits
    url: https://developers.etsy.com/documentation/essentials/rate-limits
  - type: Requests
    url: https://developers.etsy.com/documentation/essentials/requests
  - type: Migration
    url: https://developers.etsy.com/documentation/migration/index
  - type: SourceCode
    url: https://github.com/etsy/open-api
- aid: etsy:etsy-shop-receipt-transactions-api
  name: Etsy Shop Receipt Transactions API
  description: The Shop Receipt Transactions API from Etsy — 4 operation(s) for shop receipt transactions.
  humanURL: https://developers.etsy.com/documentation
  baseURL: https://openapi.etsy.com
  tags:
  - Shop Receipt Transactions
  properties:
  - type: OpenAPI
    url: openapi/etsy-shop-receipt-transactions-api-openapi.yml
  - type: Documentation
    url: https://developers.etsy.com/documentation
  - type: Reference
    url: https://developers.etsy.com/documentation/reference
  - type: Authentication
    url: https://developers.etsy.com/documentation/essentials/authentication
  - type: OAuth2
    url: https://developers.etsy.com/documentation/essentials/oauth2
  - type: RateLimits
    url: https://developers.etsy.com/documentation/essentials/rate-limits
  - type: Requests
    url: https://developers.etsy.com/documentation/essentials/requests
  - type: Migration
    url: https://developers.etsy.com/documentation/migration/index
  - type: SourceCode
    url: https://github.com/etsy/open-api
- aid: etsy:etsy-shop-return-policy-api
  name: Etsy Shop Return Policy API
  description: The Shop Return Policy API from Etsy — 3 operation(s) for shop return policy.
  humanURL: https://developers.etsy.com/documentation
  baseURL: https://openapi.etsy.com
  tags:
  - Shop Return Policy
  properties:
  - type: OpenAPI
    url: openapi/etsy-shop-return-policy-api-openapi.yml
  - type: Documentation
    url: https://developers.etsy.com/documentation
  - type: Reference
    url: https://developers.etsy.com/documentation/reference
  - type: Authentication
    url: https://developers.etsy.com/documentation/essentials/authentication
  - type: OAuth2
    url: https://developers.etsy.com/documentation/essentials/oauth2
  - type: RateLimits
    url: https://developers.etsy.com/documentation/essentials/rate-limits
  - type: Requests
    url: https://developers.etsy.com/documentation/essentials/requests
  - type: Migration
    url: https://developers.etsy.com/documentation/migration/index
  - type: SourceCode
    url: https://github.com/etsy/open-api
- aid: etsy:etsy-shop-section-api
  name: Etsy Shop Section API
  description: The Shop Section API from Etsy — 2 operation(s) for shop section.
  humanURL: https://developers.etsy.com/documentation
  baseURL: https://openapi.etsy.com
  tags:
  - Shop Section
  properties:
  - type: OpenAPI
    url: openapi/etsy-shop-section-api-openapi.yml
  - type: Documentation
    url: https://developers.etsy.com/documentation
  - type: Reference
    url: https://developers.etsy.com/documentation/reference
  - type: Authentication
    url: https://developers.etsy.com/documentation/essentials/authentication
  - type: OAuth2
    url: https://developers.etsy.com/documentation/essentials/oauth2
  - type: RateLimits
    url: https://developers.etsy.com/documentation/essentials/rate-limits
  - type: Requests
    url: https://developers.etsy.com/documentation/essentials/requests
  - type: Migration
    url: https://developers.etsy.com/documentation/migration/index
  - type: SourceCode
    url: https://github.com/etsy/open-api
- aid: etsy:etsy-shop-shippingprofile-api
  name: Etsy Shop ShippingProfile API
  description: The Shop ShippingProfile API from Etsy — 7 operation(s) for shop shippingprofile.
  humanURL: https://developers.etsy.com/documentation
  baseURL: https://openapi.etsy.com
  tags:
  - Shop ShippingProfile
  properties:
  - type: OpenAPI
    url: openapi/etsy-shop-shippingprofile-api-openapi.yml
  - type: Documentation
    url: https://developers.etsy.com/documentation
  - type: Reference
    url: https://developers.etsy.com/documentation/reference
  - type: Authentication
    url: https://developers.etsy.com/documentation/essentials/authentication
  - type: OAuth2
    url: https://developers.etsy.com/documentation/essentials/oauth2
  - type: RateLimits
    url: https://developers.etsy.com/documentation/essentials/rate-limits
  - type: Requests
    url: https://developers.etsy.com/documentation/essentials/requests
  - type: Migration
    url: https://developers.etsy.com/documentation/migration/index
  - type: SourceCode
    url: https://github.com/etsy/open-api
- aid: etsy:etsy-shoplisting-api
  name: Etsy ShopListing API
  description: The ShopListing API from Etsy — 13 operation(s) for shoplisting.
  humanURL: https://developers.etsy.com/documentation
  baseURL: https://openapi.etsy.com
  tags:
  - ShopListing
  properties:
  - type: OpenAPI
    url: openapi/etsy-shoplisting-api-openapi.yml
  - type: Documentation
    url: https://developers.etsy.com/documentation
  - type: Reference
    url: https://developers.etsy.com/documentation/reference
  - type: Authentication
    url: https://developers.etsy.com/documentation/essentials/authentication
  - type: OAuth2
    url: https://developers.etsy.com/documentation/essentials/oauth2
  - type: RateLimits
    url: https://developers.etsy.com/documentation/essentials/rate-limits
  - type: Requests
    url: https://developers.etsy.com/documentation/essentials/requests
  - type: Migration
    url: https://developers.etsy.com/documentation/migration/index
  - type: SourceCode
    url: https://github.com/etsy/open-api
- aid: etsy:etsy-shoplisting-file-api
  name: Etsy ShopListing File API
  description: The ShopListing File API from Etsy — 2 operation(s) for shoplisting file.
  humanURL: https://developers.etsy.com/documentation
  baseURL: https://openapi.etsy.com
  tags:
  - ShopListing File
  properties:
  - type: OpenAPI
    url: openapi/etsy-shoplisting-file-api-openapi.yml
  - type: Documentation
    url: https://developers.etsy.com/documentation
  - type: Reference
    url: https://developers.etsy.com/documentation/reference
  - type: Authentication
    url: https://developers.etsy.com/documentation/essentials/authentication
  - type: OAuth2
    url: https://developers.etsy.com/documentation/essentials/oauth2
  - type: RateLimits
    url: https://developers.etsy.com/documentation/essentials/rate-limits
  - type: Requests
    url: https://developers.etsy.com/documentation/essentials/requests
  - type: Migration
    url: https://developers.etsy.com/documentation/migration/index
  - type: SourceCode
    url: https://github.com/etsy/open-api
- aid: etsy:etsy-shoplisting-image-api
  name: Etsy ShopListing Image API
  description: The ShopListing Image API from Etsy — 4 operation(s) for shoplisting image.
  humanURL: https://developers.etsy.com/documentation
  baseURL: https://openapi.etsy.com
  tags:
  - ShopListing Image
  properties:
  - type: OpenAPI
    url: openapi/etsy-shoplisting-image-api-openapi.yml
  - type: Documentation
    url: https://developers.etsy.com/documentation
  - type: Reference
    url: https://developers.etsy.com/documentation/reference
  - type: Authentication
    url: https://developers.etsy.com/documentation/essentials/authentication
  - type: OAuth2
    url: https://developers.etsy.com/documentation/essentials/oauth2
  - type: RateLimits
    url: https://developers.etsy.com/documentation/essentials/rate-limits
  - type: Requests
    url: https://developers.etsy.com/documentation/essentials/requests
  - type: Migration
    url: https://developers.etsy.com/documentation/migration/index
  - type: SourceCode
    url: https://github.com/etsy/open-api
- aid: etsy:etsy-shoplisting-inventory-api
  name: Etsy ShopListing Inventory API
  description: The ShopListing Inventory API from Etsy — 1 operation(s) for shoplisting inventory.
  humanURL: https://developers.etsy.com/documentation
  baseURL: https://openapi.etsy.com
  tags:
  - ShopListing Inventory
  properties:
  - type: OpenAPI
    url: openapi/etsy-shoplisting-inventory-api-openapi.yml
  - type: Documentation
    url: https://developers.etsy.com/documentation
  - type: Reference
    url: https://developers.etsy.com/documentation/reference
  - type: Authentication
    url: https://developers.etsy.com/documentation/essentials/authentication
  - type: OAuth2
    url: https://developers.etsy.com/documentation/essentials/oauth2
  - type: RateLimits
    url: https://developers.etsy.com/documentation/essentials/rate-limits
  - type: Requests
    url: https://developers.etsy.com/documentation/essentials/requests
  - type: Migration
    url: https://developers.etsy.com/documentation/migration/index
  - type: SourceCode
    url: https://github.com/etsy/open-api
- aid: etsy:etsy-shoplisting-offering-api
  name: Etsy ShopListing Offering API
  description: The ShopListing Offering API from Etsy — 1 operation(s) for shoplisting offering.
  humanURL: https://developers.etsy.com/documentation
  baseURL: https://openapi.etsy.com
  tags:
  - ShopListing Offering
  properties:
  - type: OpenAPI
    url: openapi/etsy-shoplisting-offering-api-openapi.yml
  - type: Documentation
    url: https://developers.etsy.com/documentation
  - type: Reference
    url: https://developers.etsy.com/documentation/reference
  - type: Authentication
    url: https://developers.etsy.com/documentation/essentials/authentication
  - type: OAuth2
    url: https://developers.etsy.com/documentation/essentials/oauth2
  - type: RateLimits
    url: https://developers.etsy.com/documentation/essentials/rate-limits
  - type: Requests
    url: https://developers.etsy.com/documentation/essentials/requests
  - type: Migration
    url: https://developers.etsy.com/documentation/migration/index
  - type: SourceCode
    url: https://github.com/etsy/open-api
- aid: etsy:etsy-shoplisting-personalization-api
  name: Etsy ShopListing Personalization API
  description: The ShopListing Personalization API from Etsy — 2 operation(s) for shoplisting personalization.
  humanURL: https://developers.etsy.com/documentation
  baseURL: https://openapi.etsy.com
  tags:
  - ShopListing Personalization
  properties:
  - type: OpenAPI
    url: openapi/etsy-shoplisting-personalization-api-openapi.yml
  - type: Documentation
    url: https://developers.etsy.com/documentation
  - type: Reference
    url: https://developers.etsy.com/documentation/reference
  - type: Authentication
    url: https://developers.etsy.com/documentation/essentials/authentication
  - type: OAuth2
    url: https://developers.etsy.com/documentation/essentials/oauth2
  - type: RateLimits
    url: https://developers.etsy.com/documentation/essentials/rate-limits
  - type: Requests
    url: https://developers.etsy.com/documentation/essentials/requests
  - type: Migration
    url: https://developers.etsy.com/documentation/migration/index
  - type: SourceCode
    url: https://github.com/etsy/open-api
- aid: etsy:etsy-shoplisting-product-api
  name: Etsy ShopListing Product API
  description: The ShopListing Product API from Etsy — 1 operation(s) for shoplisting product.
  humanURL: https://developers.etsy.com/documentation
  baseURL: https://openapi.etsy.com
  tags:
  - ShopListing Product
  properties:
  - type: OpenAPI
    url: openapi/etsy-shoplisting-product-api-openapi.yml
  - type: Documentation
    url: https://developers.etsy.com/documentation
  - type: Reference
    url: https://developers.etsy.com/documentation/reference
  - type: Authentication
    url: https://developers.etsy.com/documentation/essentials/authentication
  - type: OAuth2
    url: https://developers.etsy.com/documentation/essentials/oauth2
  - type: RateLimits
    url: https://developers.etsy.com/documentation/essentials/rate-limits
  - type: Requests
    url: https://developers.etsy.com/documentation/essentials/requests
  - type: Migration
    url: https://developers.etsy.com/documentation/migration/index
  - type: SourceCode
    url: https://github.com/etsy/open-api
- aid: etsy:etsy-shoplisting-translation-api
  name: Etsy ShopListing Translation API
  description: The ShopListing Translation API from Etsy — 1 operation(s) for shoplisting translation.
  humanURL: https://developers.etsy.com/documentation
  baseURL: https://openapi.etsy.com
  tags:
  - ShopListing Translation
  properties:
  - type: OpenAPI
    url: openapi/etsy-shoplisting-translation-api-openapi.yml
  - type: Documentation
    url: https://developers.etsy.com/documentation
  - type: Reference
    url: https://developers.etsy.com/documentation/reference
  - type: Authentication
    url: https://developers.etsy.com/documentation/essentials/authentication
  - type: OAuth2
    url: https://developers.etsy.com/documentation/essentials/oauth2
  - type: RateLimits
    url: https://developers.etsy.com/documentation/essentials/rate-limits
  - type: Requests
    url: https://developers.etsy.com/documentation/essentials/requests
  - type: Migration
    url: https://developers.etsy.com/documentation/migration/index
  - type: SourceCode
    url: https://github.com/etsy/open-api
- aid: etsy:etsy-shoplisting-variationimage-api
  name: Etsy ShopListing VariationImage API
  description: The ShopListing VariationImage API from Etsy — 1 operation(s) for shoplisting variationimage.
  humanURL: https://developers.etsy.com/documentation
  baseURL: https://openapi.etsy.com
  tags:
  - ShopListing VariationImage
  properties:
  - type: OpenAPI
    url: openapi/etsy-shoplisting-variationimage-api-openapi.yml
  - type: Documentation
    url: https://developers.etsy.com/documentation
  - type: Reference
    url: https://developers.etsy.com/documentation/reference
  - type: Authentication
    url: https://developers.etsy.com/documentation/essentials/authentication
  - type: OAuth2
    url: https://developers.etsy.com/documentation/essentials/oauth2
  - type: RateLimits
    url: https://developers.etsy.com/documentation/essentials/rate-limits
  - type: Requests
    url: https://developers.etsy.com/documentation/essentials/requests
  - type: Migration
    url: https://developers.etsy.com/documentation/migration/index
  - type: SourceCode
    url: https://github.com/etsy/open-api
- aid: etsy:etsy-shoplisting-video-api
  name: Etsy ShopListing Video API
  description: The ShopListing Video API from Etsy — 4 operation(s) for shoplisting video.
  humanURL: https://developers.etsy.com/documentation
  baseURL: https://openapi.etsy.com
  tags:
  - ShopListing Video
  properties:
  - type: OpenAPI
    url: openapi/etsy-shoplisting-video-api-openapi.yml
  - type: Documentation
    url: https://developers.etsy.com/documentation
  - type: Reference
    url: https://developers.etsy.com/documentation/reference
  - type: Authentication
    url: https://developers.etsy.com/documentation/essentials/authentication
  - type: OAuth2
    url: https://developers.etsy.com/documentation/essentials/oauth2
  - type: RateLimits
    url: https://developers.etsy.com/documentation/essentials/rate-limits
  - type: Requests
    url: https://developers.etsy.com/documentation/essentials/requests
  - type: Migration
    url: https://developers.etsy.com/documentation/migration/index
  - type: SourceCode
    url: https://github.com/etsy/open-api
- aid: etsy:etsy-user-api
  name: Etsy User API
  description: The User API from Etsy — 2 operation(s) for user.
  humanURL: https://developers.etsy.com/documentation
  baseURL: https://openapi.etsy.com
  tags:
  - User
  properties:
  - type: OpenAPI
    url: openapi/etsy-user-api-openapi.yml
  - type: Documentation
    url: https://developers.etsy.com/documentation
  - type: Reference
    url: https://developers.etsy.com

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