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.

Carriers
array
List of valid shipping carriers
AddressWithPhone
RevShareRegion
string
The region used to determine revshare
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
OrderDownloadJob
object
2 properties
RefundReasons
array
List of valid refund reasons
TaxItem
object
4 properties
ShippingAddress
object
10 properties 5 required
OrderType
string
Order type
VATAdditionalMaterial
string
VAT additional material
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…
RefundsInfo
object
Refund info
6 properties
OrderTax
object
Order tax requirements
4 properties
FBWFee
object
FBW fee
3 properties
OrderPayment
object
Returns relevant information regarding an order's payments
4 properties
PhoneNumber
object
2 properties 1 required
ShippingReimbursementStatus
string
Shipping reimbursement status
APIError
object
2 properties 2 required
CustomerPaidPricesDetail
object
Customer paid price of an order after various adjustments
5 properties
Order
object
20 properties
ShippingProvider
object
1 property
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.
Weight
object
2 properties 2 required
LotInfo
object
FBW lot info
2 properties
FulfillmentEvent
object
Fulfillment event
2 properties
UpdateTracking
object
4 properties 3 required
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…
OrderAddress
RefundOrder
object
2 properties 1 required
Money
object
2 properties 2 required
FulfillmentEventType
string
The type of fulfillment milestone
FBWFeeType
string
FBW Fee type
TrackingInfo
object
Tracking information
4 properties
ShippingReimbursement
object
Shipping reimbursement
2 properties
RefundReason
string
The reason for the refund
MerchantWarehouseType
string
Merchant warehouse type
ProductInfo
object
Product info
8 properties
EUVATCustomsDeclarationProduct
object
Product information for EU VAT customs, including name, imageurl, weight, and etc
6 properties
FulfillmentRequirements
object
Order's general requirements.
2 properties
UpdateOrder
object
3 properties
V3GenericReportStatus
object
A generic report status object used when an endpoint wants to return the status of their downloadable file
8 properties
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…
VOEC
object
Information for the VOEC
2 properties
VATPayer
object
Information about the payer of VAT
4 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…
EORI
object
Information for the EORI
2 properties
OrderTypeFilter
string
Order type to filter by
Orders
array
RefundSource
string
The source of the refund.
RequiredVATNumber
object
Information for the required VAT number
3 properties
PlatformEntity
string
Indicates if the platform (Wish) is the reseller or the owner of the product
SpecialProgramsInfo
object
Special program info
2 properties
TaxEntity
string
Tax entity type
VATAmount
object
Currently only for UK-bound orders; This field breaks down VAT quantities for this order.
3 properties
Price
object
2 properties 2 required
RevShareDetails
object
Relevant information regarding an order's revenue share
7 properties
VAT
object
VAT info
6 properties
CarrierSubsidy
object
Carrier subsidies
2 properties
WarehouseInformation
object
Warehouse information
4 properties
GeneralPaymentDetails
object
Relevant information regarding an order's payments
10 properties
OrderShippingDetail
Order shipping details
Address
object
8 properties 5 required

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