Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Wish Merchant API

Merchant APIs

Wish Merchant API is one of 21 APIs that Wish publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Merchant. The published artifact set on APIs.io includes an OpenAPI specification, authentication docs, and rate-limit docs.

This API exposes 8 operations across 6 paths, and defines 17 schemas. It is described by OpenAPI 3.0.0, at version 3.0.65.

Requests are made against a single base URL, https://merchant.wish.com.

8 operations 6 paths 17 schemas 5 GET1 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
3.0.65
Base URL
https://merchant.wish.com/api/v3
Authentication
OpenID Connect, OAuth 2.0
Resource Areas
1

Authentication & Security 2

Wish Merchant API declares 2 security schemes for authenticating requests. It supports OpenID Connect (OpenID) discovered at https://merchant.wish.com/oidc/.well-known/openid-configuration. It supports OAuth 2.0 (OAuth2) using the authorizationCode flow, exposing 37 scopes. By default, every request must be authenticated.

Paths & Operations 8

Across 6 paths, the API surfaces 8 operations — 5 GET, 1 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

Merchant 8

Merchant APIs

GET
/api/v3/merchant/currency_settings
Get merchant currency settings
getCurrencySettings → 200400
PUT
/api/v3/merchant/warehouses/{id}
Update warehouse information
updateWarehouse 1 param body → 200400
GET
/api/v3/merchant/settings
Get merchant settings
getSettings → 200400
POST
/api/v3/merchant/warehouses
Create a warehouse
createWarehouse body → 200400
GET
/api/v3/merchant/warehouses
Get merchant warehouses
listWarehouses → 200400
PUT
/api/v3/merchant/shipping_settings
Update shipping settings
updateShippingSettings body → 200400
GET
/api/v3/merchant/shipping_settings
Get shipping settings
listShippingSettings → 200400
GET
/api/v3/merchant/account_details
Get merchant account details
getMerchantAccountDetail → 200400

Schemas 17

The contract defines 17 schemas that model the data the API accepts and returns. The most detailed are WarehouseAddress (7 properties), AccountDetail (4 properties), WarehouseBase (4 properties), MerchantSettings (3 properties). Each schema is shown below with its type and property counts.

FashionExperience
object
1 property
UnificationInitiative
object
1 property
WarehouseRequest
object
UpdateWarehouse
object
1 property
AccountDetail
object
4 properties
APIError
object
2 properties 2 required
WarehouseAddress
object
7 properties 5 required
UpdateShippingSettings
array
Warehouses
array
WarehouseResponse
object
CreateWarehouse
object
ShippingSetting
object
2 properties 2 required
MerchantCurrencySettings
object
2 properties
WarehouseBase
object
4 properties
MerchantSettings
object
3 properties
ShippingSettings
array
AutomatedListingReviewExperience
object
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

wish-merchant-api-openapi.yml Raw ↑

Other APIs Wish publishes across the network.

Wish Brands API
Wish Bulk Products API
Wish Currencies API
Wish EU Product Compliance API
Wish France EPR Compliance API
Wish Germany EPR Compliance API
Wish OAuth API
Wish Orders API
Wish Payments API
Wish Penalties API
Wish ProductBoost API
Wish Products API