# Wish

> Wish (ContextLogic Inc.) is a global mobile-first e-commerce marketplace. The Wish Marketplace V3 API lets merchants and ERP partners manage products, variations, orders, fulfillment, payments, penalties, tickets, ProductBoost campaigns, promotions, EU/EPR compliance, and webhook subscriptions over OAuth 2.0.

Generated by API Evangelist from apis.yml and repo artifacts on 2026-07-21 (no /llms.txt is published by Wish).

## APIs

- [Wish Marketplace V3 API reference](https://merchant.wish.com/documentation/api/v3/reference): Interactive reference (Stoplight) for the V3 API, version 3.0.65
- [API explorer](https://merchant.wish.com/documentation/api/v3/explorer): Try-it explorer for V3 operations
- [OAuth guide](https://merchant.wish.com/documentation/api/v3/oauth): How to authenticate with OAuth 2.0 (authorization code flow)
- [Webhooks documentation](https://merchant.wish.com/documentation/webhooks): Real-time event notifications instead of polling

## Specs

- [OpenAPI 3.0 (Wish Marketplace V3 API)](https://raw.githubusercontent.com/api-evangelist/wish/refs/heads/main/openapi/wish-marketplace-v3-openapi.json): 74 paths, 102 operations, OAuth2 + OpenID Connect
- [OpenID Connect discovery](https://merchant.wish.com/oidc/.well-known/openid-configuration): Live OIDC discovery document

## Docs

- [Merchant dashboard](https://merchant.wish.com/): Wish for Merchants portal (sign up / login)
- [Partner developer page](https://merchant.wish.com/partner-developer): Building public apps for Wish merchants
- [Sandbox](https://sandbox.merchant.wish.com): Isolated test environment; base URL https://sandbox.merchant.wish.com/api/v3/
- [Terms of service](https://www.wish.com/terms)
- [Privacy policy](https://www.wish.com/privacy_policy)

## Conventions

- Base URL: https://merchant.wish.com/api/v3/
- Auth: Authorization: Bearer <token> (OAuth 2.0 authorization code; 37 scopes)
- Errors: JSON envelope {message, code, data}; code 0 = success
- Pagination: keyset via limit + {attribute}_min/{attribute}_max; sorting via sort_by={param}.{asc|desc}
- Partial responses: fields parameter on all GET endpoints (nested via /, groups via parentheses, wildcard *)
- Rate limiting: Wish-Rate-Limit-Remaining / Wish-Rate-Limit-Reset headers; 429 on exceed
- Request tracing: Wish-Request-Id response header
- Support: partner-api@wish.com