# Etsy API Documentation

This is the complete API documentation for connecting to the Etsy API using MindCloud's Universal API.

MindCloud offers one normalized API to access 3,400+ apps from a single place. It centralizes authentication and normalizes app APIs so they are easier and more consistent to use.

## Quickstart

1. A **MindCloud account** — sign in or create an account at [MindCloud](https://app.mindcloud.co).
2. A **MindCloud API Key** — create one in [API Keys](https://app.mindcloud.co/user/api-keys). Keep it on your server.
3. At least one **Etsy connection** — create or choose one in [Connections](https://app.mindcloud.co/credentials). Note its `connectionId`.

```text
POST https://connect.mindcloud.co/v2/universal/apps/etsy/actions/{actionSlug}/run
```

## Etsy actions

- POST `create-receipt-shipment` Create Receipt Shipment
- GET `find-all-active-listings` Find All Active Listings
- GET `find-listings-by-shop` Find Listings by Shop
- GET `find-shops` Find Shops
- GET `find-transactions-by-shop` Find Transactions by Shop
- GET `get-listing-by-listing-id` Get Listing by Listing ID
- GET `get-listing-inventory` Get Listing Inventory
- GET `get-listing-product` Get Listing Product
- GET `get-payments` Get Payments
- GET `get-shipping-carriers` Get Shipping Carriers
- GET `get-shop-by-owner-user-id` Get Shop by Owner User ID
- GET `get-shop-by-shop-id` Get Shop by Shop ID
- GET `get-shop-receipt` Get Shop Receipt
- GET `get-transaction-by-id` Get Transaction by ID
- GET `list-shop-receipts` List Shop Receipts
- PUT `update-listing-inventory` Update Listing Inventory
- PUT `update-shop-receipt` Update Shop Receipt