How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Wish

Wish Promotions Platform API

The Promotions Platform API from Wish — 6 operation(s) for promotions platform.

Documentation Provider Profile APIs.io OpenAPI GitHub

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

Tagged areas include Promotions Platform. 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 18 schemas. It is described by OpenAPI 3.2.0, at version 3.0.65.

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

8 operations 6 paths 18 schemas 5 GET1 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

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

Authentication & Security 2

Wish Promotions Platform 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.

Promotions Platform 8
GET
/api/v3/promotions/eligible_products
Get eligible products
getPromotionsEligibleProducts 7 params → 200400
PUT
/api/v3/promotions/campaigns/{id}/cancel
Cancel a promotion campaign
cancelPromotionsCampaign 1 param body → 200400
POST
/api/v3/promotions/campaigns
Create a promotion campaign
createPromotionsCampaign body → 200400
GET
/api/v3/promotions/campaigns
List promotion campaigns
listPromotionsCampaigns 12 params → 200400
PUT
/api/v3/promotions/campaigns/{id}
Update a promotion campaign
updatePromotionsCampaign 1 param body → 200400
GET
/api/v3/promotions/campaigns/{id}
Get a single promotion campaign
getPromotionsCampaign 1 param → 200400
GET
/api/v3/promotions/events
List promotion events
listPromotionEvents 6 params → 200400
GET
/api/v3/promotions/eligible_products/count
Get eligible products count
getPromotionsEligibleProductsCount 4 params → 200400

Schemas 18

The contract defines 18 schemas that model the data the API accepts and returns. The most detailed are PromotionsCampaign (14 properties), PromotionEvent (10 properties), CreatePromotionsCampaign (7 properties), VariationDiscountData (6 properties). Each schema is shown below with its type and property counts.

UpdatePromotionsCampaign
object
1 property
PromotionEligibleProduct
object
Eligible product for Promotions Platform
2 properties
PromotionEvent
object
10 properties
PromotionsCampaignState
string
Campaign State. 'PENDING' campaigns are created but pending for approval. 'APPROVED' campaigns are approved. 'CANCELLED' campaigns are cancelled.
APIError
object
2 properties 2 required
UnqualifiedReason
string
Reason of unqualified product variations. 'NOTINSTOCK': product out of stock. 'LOWRATING': product rating is too low (Minimum of 3 for Discount promotions, or…
MerchantCancelReason
string
Reason of merchant cancelling campaign.
PromotionsEligibleCountries
array
List of countries that are eligible for the campaign. The default value (not provided or empty list) are all countries that the products can be shipped to.
CancelPromotionsCampaign
object
2 properties 1 required
PromotionsCampaign
object
14 properties
PromotionsCampaignCancelComment
string
A detailed reason for the campaign cancellation. Used by Wish to collect feedbacks.
VariationsDiscountData
object
Campaign discount data. Only used when promotiontype is 'DISCOUNT' or 'FLASHSALE'.
3 properties 1 required
UnqualifiedVariation
object
Unqualified product variation.
3 properties
PromotionsEligibleVariation
object
Eligible variation for Promotions Platform.
1 property
CreatePromotionsCampaign
object
7 properties 1 required
CancelReason
string
Reason of cancelling campaign.
VariationDiscountData
object
6 properties 2 required
PromotionType
string
Promotion type of the campaign. 'DISCOUNT' campaigns support basic discount on variations. 'FLASHSALE' campaigns support significant discount on products for a…

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

wish-promotions-platform-api-openapi.yml Raw ↑

Other APIs Wish publishes across the network.

Wish Brands API
AE Profile APIs.io
Wish Bulk Products API
AE Profile APIs.io
Wish Currencies API
AE Profile APIs.io
Wish EU Product Compliance API
AE Profile APIs.io
Wish France EPR Compliance API
AE Profile APIs.io
Wish Germany EPR Compliance API
AE Profile APIs.io
Wish Merchant API
AE Profile APIs.io
Wish Orders API
AE Profile APIs.io
Wish Payments API
AE Profile APIs.io
Wish Penalties API
AE Profile APIs.io
Wish ProductBoost API
AE Profile APIs.io
Wish Products API
AE Profile APIs.io
#Promotions Platform
← Back to W APIs
API Details
ID
wish:wish-promotions-platform-api
Base URL
https://merchant.wish.com/api/v3
Docs
https://merchant.wish.com/documentation/api/v3/reference
Provider
Wish
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=wish-promotions-platform-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/wish-promotions-platform-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of Wish Promotions Platform API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.