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 Orders API

The Orders API from Wish — 9 operation(s) for orders.

Documentation Provider Profile APIs.io OpenAPI GitHub

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

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

This API exposes 10 operations across 9 paths, and defines 62 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.

10 operations 9 paths 62 schemas 5 GET1 POST4 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 Orders 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 10

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

Orders 10
GET
/api/v3/orders/shipping_carriers
Get accepted shipping carriers
GetShippingCarriers 2 params → 200
POST
/api/v3/orders/bulk_get
Batch download orders
downloadOrders 8 params → 200400
GET
/api/v3/orders/bulk_get/{id}
Get batch download job status
getOrderDownloadJob 1 param → 200400
PUT
/api/v3/orders/{id}/tracking
Ship or update tracking
ShipOrder 1 param body → 200
GET
/api/v3/orders/{id}/refund_reasons
Get valid refund reasons
GetValidRefundReasons 1 param → 200
PUT
/api/v3/orders/{id}
Update an LTL order
UpdateOrder 1 param body → 200
GET
/api/v3/orders/{id}
Get an order
GetOrder 1 param → 200
PUT
/api/v3/orders/{id}/address
Modify shipping address
ModifyAddress 1 param body → 200
PUT
/api/v3/orders/{id}/refund
Refund/Cancel an order
RefundOrder 1 param body → 200
GET
/api/v3/orders
List orders
GetMultipleOrders 8 params → 200

Schemas 62

The contract defines 62 schemas that model the data the API accepts and returns. The most detailed are Order (20 properties), EUVATCustomsDeclaration (15 properties), ShippingAddress (10 properties), GeneralPaymentDetails (10 properties). Each schema is shown below with its type and property counts.

APIError
object
2 properties 2 required
TaxEntity
string
Tax entity type
State
string
Returns the order's current state. Possible values are: 1. APPROVED: Order is ready to be shipped. 2. SHIPPED: Order has been shipped. 3. REFUNDED: Order has b…
SpecialProgramsInfo
object
Special program info
2 properties
RefundReasons
array
List of valid refund reasons
RemitType
string
Displays who should remit taxes for this order. 1. WISHREMIT: Wish will remit. 2. MERCHANTREMIT: Merchant will remit. 3. TBDREMIT: UK-specific; this will resol…
RefundSource
string
The source of the refund.
MerchantWarehouseType
string
Merchant warehouse type
VAT
object
VAT info
6 properties
OrderType
string
Order type
RevShareRegion
string
The region used to determine revshare
ProductInfo
object
Product info
8 properties
OrderTypeFilter
string
Order type to filter by
VATPayer
object
Information about the payer of VAT
4 properties
OrderAddress
Money
object
2 properties 2 required
ShippingReimbursement
object
Shipping reimbursement
2 properties
PhoneNumber
object
2 properties 1 required
GeneralPaymentDetails
object
Relevant information regarding an order's payments
10 properties
Order
object
20 properties
ProcessingSource
string
Reflects asynchronous actions currently being applied to order from Ship or update tracking, Refund/Cancel an order, and Modify shipping address endpoints. Pai…
RefundsInfo
object
Refund info
6 properties
ShippingAddress
object
10 properties 5 required
VATAdditionalMaterial
string
VAT additional material
UpdateTracking
object
4 properties 3 required
EUVATCustomsDeclarationProduct
object
Product information for EU VAT customs, including name, imageurl, weight, and etc
6 properties
OrderShippingDetail
Order shipping details
VATAmount
object
Currently only for UK-bound orders; This field breaks down VAT quantities for this order.
3 properties
CarrierSubsidy
object
Carrier subsidies
2 properties
ShippingReimbursementStatus
string
Shipping reimbursement status
VOEC
object
Information for the VOEC
2 properties
Address
object
8 properties 5 required
TrackingInfo
object
Tracking information
4 properties
EUVATCustomsDeclaration
object
If the order is subject to EU VAT and is valued at lower than 150 EUR, this field will return all required information for customs declaration.
15 properties
FBWFeeType
string
FBW Fee type
RefundOrder
object
2 properties 1 required
FulfillmentEventType
string
The type of fulfillment milestone
PlatformEntity
string
Indicates if the platform (Wish) is the reseller or the owner of the product
AddressWithPhone
EORI
object
Information for the EORI
2 properties
OrderDownloadJob
object
2 properties
Price
object
2 properties 2 required
OrderTax
object
Order tax requirements
4 properties
ShippingProvider
object
1 property
V3GenericReportStatus
object
A generic report status object used when an endpoint wants to return the status of their downloadable file
8 properties
CustomerPaidPricesDetail
object
Customer paid price of an order after various adjustments
5 properties
FBWFee
object
FBW fee
3 properties
RevShareDetails
object
Relevant information regarding an order's revenue share
7 properties
CustomerIdentityNumberType
string
Orders entering into certain countries require an individual taxpayer ID or customs information. This field indicates the type of ID provided. Possible values…
WarehouseInformation
object
Warehouse information
4 properties
Orders
array
RefundReason
string
The reason for the refund
Weight
object
2 properties 2 required
TaxItem
object
4 properties
OrderPayment
object
Returns relevant information regarding an order's payments
4 properties
LotInfo
object
FBW lot info
2 properties
FulfillmentRequirements
object
Order's general requirements.
2 properties
FulfillmentEvent
object
Fulfillment event
2 properties
ProcessingStatus
string
Reflects the progress of the action shown in processingsource. The attribute will be empty until V3 PUT endpoints are released later this year.
UpdateOrder
object
3 properties
RequiredVATNumber
object
Information for the required VAT number
3 properties
Carriers
array
List of valid shipping carriers

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

wish-orders-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 OAuth 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
#Order
← Back to W APIs
API Details
ID
wish:wish-orders-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-orders-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/wish-orders-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 Orders 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.