# Management Store Etsy Public API

> REST API for Etsy shop and order data, including manual fulfillment updates. Authenticate with Bearer API keys (mse_ prefix).

## Documentation

- [Interactive API explorer](https://etsy.lntech-ecommerce.com/developers): Try endpoints in the browser
- [Full API reference (Markdown)](https://etsy.lntech-ecommerce.com/llms-full.txt): Complete endpoint docs for AI agents
- [OpenAPI 3.0 specification](https://etsy.lntech-ecommerce.com/openapi.json): Machine-readable schema for codegen and tool use
- [Developers page (Markdown export)](https://etsy.lntech-ecommerce.com/developers.md): Same reference as llms-full

## Authentication

- Use header `Authorization: Bearer mse_<secret>`
- Create keys in the web app: Settings → API access
- Keys are tenant-scoped to license-owned shops only

## Agent instructions

- Prefer machine-readable docs: /llms.txt (index), /llms-full.txt (full reference), /openapi.json (schema).
- Always send Authorization: Bearer <api_key> and Accept: application/json.
- Respect 429 responses and Retry-After header.
- Do not scrape the React /developers UI when structured docs are available.

Rate limit: 60 requests per 60 seconds per API key.