Open API v2 will be deprecated on April 3, 2023. Please begin transitioning to Open API v3 as soon as possible. As of September 29, 2022 all new apps will only be permitted to use Open API v3.

API Documentation

Testing the API

Etsy API Testing Policies

Developers test their Etsy API applications on production. However, some testing activity looks very similar to fraud. Our testing policies are designed to help you test your app while protecting our marketplace from abusive behavior.

  1. If you create test listings, use low prices (< $1) and deactivate them as soon as you have finished testing.
  2. Create listings in draft state when possible. This removes the need to deactivate them later and also helps you avoid listing fees.
  3. Set your shop to accept the payment type, "Other". To do this, visit Shop Manager > Finances > Payment Methods, and ensure that "Other" is enabled. If you have a scenario that you believe requires a different payment type, please email a description of the use case to developer@etsy.com.
  4. Enable Developer Mode for your shop. This will further reduce the chance that a buyer will accidentally find and buy your test listings. Note that you will still be charged for any test listings you create in production, and you are responsible for paying this bill.
  5. If you accidentally sell something, you must cancel the transaction. Contact Etsy Support if you have any trouble doing so. Failure to fulfill or cancel the order will result in suspension of your account.

If you have any questions about how to test the API, please contact Etsy's Developer Support at developer@etsy.com.

Open API v3New

Your developer account