v2.order.get_order_detail

stable本次发布有变化全部展示

来自 Shopee 官方资料快照 · 2026-09-06 12:13:48

打开官方原文 ↗

当前资料结构化阅读页
固定快照已留存，可追溯
官方原文可核对

查看技术与溯源信息

平台 / profile: Shopee / profile.shopee.api_reference
语言: en-US
发布版本: cn-20260909-2
标签: zhuge/sourceplatform/shopeeaudience/developercategory/api_doctopic/apitopic/developer

资料正文

§1 v2.order.get_order_detail

Use this api to get order detail.

§2 Overview

Overview

Field	Value
Module	Order
API type	Shop
HTTP method	GET
Path	/api/v2/order/get_order_detail
Production URL	https://partner.shopeemobile.com/api/v2/order/get_order_detail
Sandbox URL	https://partner.test-stable.shopeemobile.com/api/v2/order/get_order_detail
Rate limit	[0,0,0]
Permission	ERP System; Seller In House System; Order Management; Accounting And Finance; Customer Service; Brand Membership; Ads Service; Swam ERP; Livestream Management; Affiliate Marketing Solution Management

§3 Request parameters

Request parameters

Name	Type	Required	Sample	Description
order_sn_list	string	Yes	201214JAJXU6G7,201214JASXYXY6	The set of order_sn. If there are multiple order_sn, you need to use English comma to connect them. limit [1,50]
request_order_status_pending	boolean	No	true	Compatible parameter during migration period, send True will let API support PENDING status and return pending_terms, send False or don’t send will fallback to old logic
response_optional_fields	string	No	total_amount	a response fields you want to get. Please select from the below response parameters. If you input an object field, all the params under it will be included automatically in the response. If there are multiple response fields you want to get, you need to use English comma to connect them. Available values: buyer_user_id,buyer_username,estimated_shipping_fee,recipient_address,actual_shipping_fee ,goods_to_declare,note,note_update_time,item_list,pay_time,dropshipper, dropshipper_phone,split_up,buyer_cancel_reason,cancel_by,cancel_reason,actual_shipping_fee_confirmed,buyer_cpf_id,fulfillment_flag,pickup_done_time,package_list,shipping_carrier,payment_method,total_amount,buyer_username,invoice_data,order_chargeable_weight_gram,return_request_due_date,edt,payment_info,international_label

§4 Response parameters

Response parameters

Name	Type	Sample	Description
request_id	string	a8e1b94f51d64540bf5762abe7783073	The identifier for an API request for error tracking.
error	string	common.error_auth	Indicate error type if hit error. Empty if no error happened.
message	string	Invalid access_token.	Indicate error details if hit error. Empty if no error happened.
response	object		Detail informations you are querying.
response.order_list	object[]		The list of orders.
response.order_list.order_sn	string	2404098R48U37H	Return by default. Shopee's unique identifier for an order.
response.order_list.region	string	VN	Return by default. The two-digit code representing the region where the order was made.
response.order_list.currency	string	VND	Return by default. The three-digit code representing the currency unit for which the order was paid.
response.order_list.cod	boolean	false	Return by default. This value indicates whether the order was a COD (cash on delivery) order.
response.order_list.total_amount	float	1004.0	The total amount paid by the buyer for the order. This amount includes the total sale price of items, shipping cost beared by buyer; and offset by Shopee promotions if applicable. This value will only return after the buyer has completed payment for the order.
response.order_list.pending_terms	string[]	["SYSTEM_PENDING", "KYC_PENDING"]	The list of pending terms. Applicable values: - SYSTEM_PENDING: Under Shopee internal processing.; - KYC_PENDING: Under KYC checking (TW CB order only).; - ARRANGE_SHIPMENT_PENDING: Temporarily held due to 3PL capacity constraints.
response.order_list.pending_description	string[]	["Order is being processed by Shopee"]	The value of this field is the description of pending reason corresponding with pending terms. Applicable values: - For SYSTEM_PENDING: Order is being processed by Shopee.; - For KYC_PENDING: Order is pending buyer TW KYC pre-authorization.; - For ARRANGE_SHIPMENT_PENDING: Allocating delivery resources due to high order volume. Label print will be available within 4 days after buyer paid.
response.order_list.order_status	string	CANCELLED	Return by default. Enumerated type that defines the current status of the order.
response.order_list.shipping_carrier	string	Standard Delivery	The logistics service provider that the buyer selected for the order to deliver items.; Note: If logistics_channel_id is 90021, 90025 or 90026, service_code will be appended, e.g., Entrega Turbo - M1020.
response.order_list.payment_method	string	Bank Transfer	The payment method that the buyer selected to pay for the order. Applicable values: See Data Definition- Payment Methods.
response.order_list.estimated_shipping_fee	float	4.0	The estimated shipping fee is an estimation calculated by Shopee based on specific logistics courier's standard.
response.order_list.message_to_seller	string		Return by default. Message to seller.
response.order_list.create_time	timestamp	1607930885	Return by default. Timestamp that indicates the date and time that the order was created.
response.order_list.update_time	timestamp	1608134691	Return by default. Timestamp that indicates the last time that there was a change in value of order, such as order status changed from 'Paid' to 'Completed'.
response.order_list.days_to_ship	int32	2	Return by default. Shipping preparation time set by the seller when listing item on Shopee.
response.order_list.ship_by_date	timestamp	1608103685	Return by default. The deadline to ship out the parcel.
response.order_list.buyer_user_id	int64	9193214	The user id of buyer of this order, will be empty if it is a non-integrated order in TW region.
response.order_list.buyer_username	string	Tom	The name of buyer, will be masked as "****" if it is a non-integrated order in TW region.
response.order_list.recipient_address	object		This object contains detailed breakdown for the recipient address. Different parameters might be masked according to each market and kind of seller. For TW region integrated channel orders will be all masked as "****". More details may refer the announcement.
response.order_list.recipient_address.name	string	Max	Recipient's name for the address.
response.order_list.recipient_address.phone	string	3828203	Recipient's phone number input when order was placed. [Only for TW non-integrated channel] Will return "****" when the "virtual_contact_number" is available
response.order_list.recipient_address.town	string	Sara	The town of the recipient's address. Whether there is a town will depend on the region and/or country.
response.order_list.recipient_address.district	string	Dada	The district of the recipient's address. Whether there is a district will depend on the region and/or country.
response.order_list.recipient_address.city	string	Asajaya	The city of the recipient's address. Whether there is a city will depend on the region and/or country.
response.order_list.recipient_address.state	string	Sarawak	The state/province of the recipient's address. Whether there is a state/province will depend on the region and/or country.
response.order_list.recipient_address.region	string	MY	The two-digit code representing the region of the Recipient.
response.order_list.recipient_address.zipcode	string	40009	Recipient's postal code.
response.order_list.recipient_address.full_address	string	C-15-14 BLOK C JALAN 30/146, Asajaya, 40009, Sarawak	The full address of the recipient, including country, state, even street, and etc.
response.order_list.recipient_address.geolocation	object		Geolocation info. Only available for logistics_channel_id 90026.
response.order_list.recipient_address.geolocation.latitude	float	-23.567851	Latitude.
response.order_list.recipient_address.geolocation.longitude	float	-46.6912611	Longitude.
response.order_list.actual_shipping_fee	float	0.0	The actual shipping fee of the order if available from external logistics partners.
response.order_list.goods_to_declare	boolean	false	Only work for cross-border order.This value indicates whether the order contains goods that are required to declare at customs. "T" means true and it will mark as "T" on the shipping label; "F" means false and it will mark as "P" on the shipping label. This value is accurate ONLY AFTER the order trackingNo is generated, please capture this value AFTER your retrieve the trackingNo.
response.order_list.note	string	haha	The note seller made for own reference.
response.order_list.note_update_time	timestamp	1608103685	Update time for the note.
response.order_list.item_list	object[]		This object contains the detailed breakdown for the result of this API call.
response.order_list.item_list.item_id	int64	2600144043	Shopee's unique identifier for an item.
response.order_list.item_list.item_name	string	backpack	The name of the item.
response.order_list.item_list.item_sku	string	sku	A item SKU (stock keeping unit) is an identifier defined by a seller, sometimes called parent SKU. Item SKU can be assigned to an item in Shopee Listings.
response.order_list.item_list.model_id	int64	0	ID of the model that belongs to the same item.
response.order_list.item_list.model_name	string		Name of the model that belongs to the same item. A seller can offer models of the same item. For example, the seller could create a fixed-priced listing for a t-shirt design and offer the shirt in different colors and sizes. In this case, each color and size combination is a separate model. Each model can have a different quantity and price.
response.order_list.item_list.model_sku	string		A model SKU (stock keeping unit) is an identifier defined by a seller. It is only intended for the seller's use. Many sellers assign a SKU to an item of a specific type, size, and color, which are models of one item in Shopee Listings.
response.order_list.item_list.model_quantity_purchased	int32	1	The number of identical items purchased at the same time by the same buyer from one listing/item.
response.order_list.item_list.is_fulfillment_mapping	boolean		Flag indicating whether the item contains any bundle items configured with Fulfillment Mapping (FFM). Returns 'true' if the item uses FFM logic, 'false' otherwise. Field will only be returned if shop is whitelisted.
response.order_list.item_list.bundle_sku_id	string		The unique identifier (SKU ID) of the front-facing Bundle SKU purchased by the buyer on Shopee. Field will only be returned if shop is whitelisted and is_fulfillment_mapping returns true.
response.order_list.item_list.components	object[]		List of underlying Parent SKUs (component level) associated with the mapped Bundle SKU, used by WMS/ERP for physical picking and fulfillment. If is_fulfillment_mapping returns 'false', this array will not be returned. Array will only be returned if shop is whitelisted and is_fulfillment_mapping returns true.
response.order_list.item_list.components.parent_sku_id	string		The unique identifier (SKU ID) of the underlying physical component item (Parent SKU).
response.order_list.item_list.components.barcode_upc	string		The physical barcode or UPC of the Parent SKU, used for scanning and inventory picking in the warehouse.
response.order_list.item_list.components.quantity	int64		The mapping ratio/quantity of this specific Parent SKU required for ONE unit of the Bundle SKU (e.g., if Bundle A contains 2 units of Parent SKU B, quantity = 2)
response.order_list.item_list.components.warehouse_id	string		The ID of the warehouse where the Parent SKU component is located/stored.
response.order_list.item_list.components.mapping_type	string		The structure/type of mapping defined for the bundle. Available values: 1: Group; 2: Lucky bag; 3: Mapping List
response.order_list.item_list.model_original_price	float	1000.0	The original price of the item in the listing currency.
response.order_list.item_list.model_discounted_price	float	1000.0	The after-discount price of the item in the listing currency. If there is no discount, this value will be same as that of model_original_price. In case of bundle deal item, this value will return 0 as by design bundle deal discount will not be breakdown to item/model level. Due to technical restriction, the value will return the price before bundle deal if we don't configure it to 0. Please call GetEscrowDetails if you want to calculate item-level discounted price for bundle deal item.
response.order_list.item_list.wholesale	boolean	false	This value indicates whether buyer buy the order item in wholesale price.
response.order_list.item_list.weight	float	12.0	The weight of the item
response.order_list.item_list.add_on_deal	boolean	false	To indicate if this item belongs to an addon deal.
response.order_list.item_list.main_item	boolean	false	To indicate if this item is main item or sub item. True means main item, false means sub item.
response.order_list.item_list.add_on_deal_id	int64	0	A unique ID to distinguish groups of items in Cart, and Order. (e.g. AddOnDeal)
response.order_list.item_list.promotion_type	string	flash_sale	Available type：product_promotion, flash_sale, bundle_deal, add_on_deal_main, add_on_deal_sub.; For items which attend multiple promotions will only show one promotion, the order of priority is: bundle_deal > add_on_deal_main > add_on_deal_sub > product_promotion >flash_sale
response.order_list.item_list.promotion_id	int64	0	The ID of the promotion.
response.order_list.item_list.order_item_id	int64	2600144043	The identify of order item.
response.order_list.item_list.line_item_id	int64	2600144043	The identity of order item. In case the order item is a bundle deal, this value will be unique to distinguish the order item
response.order_list.item_list.promotion_group_id	int32	0	The identify of product promotion.
response.order_list.item_list.image_info	object		Image info of the product.
response.order_list.item_list.image_info.image_url	string		The image url of the product. Default to be variation image, if the model does not have a variation image, will use an item main image instead.
response.order_list.item_list.product_location_id	string		The fulfilment warehouse ID(s) of the items in the order. (Multi-Warehouse sellers only)
response.order_list.item_list.is_prescription_item	boolean		To indicate if this item is prescription item. Only for PH, TH, ID local shop.
response.order_list.item_list.error_in_fetching_is_prescription_item	boolean		To indicate if there was an error when validating whether this item is prescription. Default false. If is_prescription_item=false and this field is true, the item's prescription status is uncertain (label service call failed). Only for TH, PH, ID local shop.
response.order_list.item_list.consultation_id	string		An identifier of teleconsultation session which buyer did to order this item. Empty if item is not ordered through teleconsultation session
response.order_list.item_list.is_b2c_owned_item	boolean		determine if item is B2C_shop_item; It should be `is_b2c_shop_item` but it was a bug from dev. Then now it's is_b2c_owned_item
response.order_list.item_list.promotion_list	object[]
response.order_list.item_list.promotion_list.promotion_type	string	seller_discount	Indicates the type of item or package level promotion applied to a product. Each item can be associated with at most one item promotion and one package promotion at a time. Item Promotions: low_price_promotion; deep_discount; platform_sale; seller_discount; flash_sale; wholesale; welcome_package_free_gift; brand_flash_sale; in_shop_flash_sale; synced_promo; platform_streaming_price; seller_streaming_price; exclusive_streamer_price; price_bidding_with_rebate; price_bidding_without_rebate; seller_advisor_price; selling_price; settlement_price; campaign_settlement_price; local_sip_settlement_price; platform_exclusive_price; seller_exclusive_price; seller_member_exclusive_sku; item_price; order_sync_price; Package Promotions: bundle_deal add_on_deal_main add_on_deal_sub
response.order_list.item_list.promotion_list.promotion_id	int64	848474823	Represents the unique identifier of a specific promotion applied to an item. Each promotion_id corresponds to a distinct promotion rule or campaign, defined under a particular promotion_type. The value is expressed in a numeric string format.
response.order_list.item_list.hot_listing_item	boolean	true	[Only for PH,TH,VN,MY,BR,TW] True if the item is hot listing.
response.order_list.item_list.active_qty	int32		The quantity of the item model that remains active in the order and is still expected to be fulfilled.
response.order_list.item_list.cancel_requested_qty	int32		The quantity of the item model that is currently under a cancellation request but has not yet reached the final cancelled status.
response.order_list.item_list.cancelled_qty	int32		The quantity of the item model that has already been successfully cancelled.
response.order_list.item_list.return_requested_qty	int32		The quantity of the item model that is currently under a return/refund request.
response.order_list.item_list.returned_qty	int32		The quantity of the item model that has already been successfully returned through the return/refund process.
response.order_list.pay_time	timestamp	1607930885	The time when the order status is updated from UNPAID to PAID. This value is NULL when order is not paid yet.
response.order_list.dropshipper	string		For Indonesia orders only. The name of the dropshipper.
response.order_list.dropshipper_phone	string		The phone number of dropshipper, could be empty.
response.order_list.split_up	boolean	false	To indicate whether this order is split to fullfil order(forder) level. Call GetForderInfo if it's "true".
response.order_list.buyer_cancel_reason	string		Cancel reason from buyer, could be empty.
response.order_list.cancel_by	string	system	Could be one of buyer, seller, system or Ops.
response.order_list.cancel_reason	string	BACKEND_LOGISTICS_NOT_STARTED	Use this field to get reason for buyer, seller, and system cancellation.
response.order_list.actual_shipping_fee_confirmed	boolean	false	Use this filed to judge whether the actual_shipping_fee is confirmed.
response.order_list.buyer_cpf_id	string		Buyer's CPF number for taxation and invoice purposes. Only for Brazil order.
response.order_list.fulfillment_flag	string	fulfilled_by_shopee	Use this field to indicate the order is fulfilled by shopee or seller. Applicable values: fulfilled_by_shopee, fulfilled_by_cb_seller, fulfilled_by_local_seller.
response.order_list.pickup_done_time	timestamp	0	The timestamp when pickup is done.
response.order_list.package_list	object[]		The list of package under an order
response.order_list.package_list.package_number	string	"61630084074470"	Shopee's unique identifier for the package under an order.
response.order_list.package_list.logistics_status	string	LOGISTICS_INVALID	The Shopee logistics status for the order. Applicable values: See Data Definition-LogisticsStatus.
response.order_list.package_list.logistics_channel_id	int64	18080	The identity of logistic channel.
response.order_list.package_list.shipping_carrier	string	Standard Delivery	The logistics service provider that the buyer selected for the order to deliver items.; Note: If logistics_channel_id is 90021, 90025 or 90026, service_code will be appended, e.g., Entrega Turbo - M1020.
response.order_list.package_list.allow_self_design_awb	boolean	false	To indicate whether the package allows for self-designed AWB, if allow_self_design_awb returns false, it means that the package does not allow for self-designed AWB and only the system-AWB can be used.
response.order_list.package_list.item_list	object[]		The lis of items.
response.order_list.package_list.item_list.item_id	int64	2600144043	Shopee's unique identifier for an item.
response.order_list.package_list.item_list.model_id	int64	0	Shopee's unique identifier for a model.
response.order_list.package_list.item_list.model_quantity	int32	1	The number of identical items/variations purchased at the same time by the same buyer from one listing/item.
response.order_list.package_list.item_list.order_item_id	int64	2600144043	The identify of order item. For items in one same bundle deal promotion, the order_item_id should share the same id, such as 1,2. For items not in bundle deal promotion, the order_item_id should be the same as item_id.
response.order_list.package_list.item_list.promotion_group_id	int32	7850298	The identify of product promotion.
response.order_list.package_list.item_list.product_location_id	string	IDL	The warehouse ID of the item.
response.order_list.package_list.parcel_chargeable_weight	int		display weight used to calculate ASF for this parcel
response.order_list.package_list.group_shipment_id	int64	150654369130420	The common identifier for multiple orders combined in the same parcel.
response.order_list.package_list.virtual_contact_number	string	0928000886	[Only for TW non-integrated channel] The virtual phone number to contact the recipient.
response.order_list.package_list.package_query_number	string	66668888	[Only for TW non-integrated channel] The query number used in virtual phone number calls to contact the recipient of this package.
response.order_list.package_list.sorting_group	string	North	[Only for TW 30029 channel] This field indicate the sorting group value of the package. This field is only available for logistics_channel_id = 30029 and after the package has been arranged for shipment.
response.order_list.invoice_data	object		The invoice data of the order.
response.order_list.invoice_data.number	string		The number of the invoice.
response.order_list.invoice_data.series_number	string		The series number of the invoice.
response.order_list.invoice_data.access_key	string		The access key of the invoice.
response.order_list.invoice_data.issue_date	timestamp		The issue date of the invoice.
response.order_list.invoice_data.total_value	float		The total value of the invoice.
response.order_list.invoice_data.products_total_value	float		The products total value of the invoice.
response.order_list.invoice_data.tax_code	string		The tax code for the invoice.
response.order_list.invoice_data.status	string	valid	The invoice statuses should be: - valid (The invoice sent is valid); - pending (System is waiting to receive the invoice)
response.order_list.invoice_data.pending_reason	string		It's the failed reason if status is pending
response.order_list.checkout_shipping_carrier	string	Standard Delivery	For non masking order, the logistics service provider that the buyer selected for the order to deliver items. For masking order, the logistics service type that the buyer selected for the order to deliver items.
response.order_list.reverse_shipping_fee	float		Shopee charges the reverse shipping fee for the returned order.The value of this field will be non-negative.
response.order_list.order_chargeable_weight_gram	int		display weight used to calculate ASF for this order
response.order_list.prescription_check_status	int		Prescription check status. For ID, PH whitelisted sellers, the applicable values: 0: NONE; 1: PASSED; 2: FAILED; For TH whitelisted sellers, the applicable values: 0: NONE; 1: PASSED
response.order_list.pharmacist_name	string		Name of the Pharmacist for Prescription Order.
response.order_list.prescription_images	string[]		Return prescription images of this order, only for ID and PH whitelist sellers.; Please add the prefix to review: for ID: https://cf.shopee.co.id/file/+prescription_image; for PH:https://cf.shopee.ph/file/+prescription_image
response.order_list.prescription_approval_time	timestamp		Time of when the prescription is approved.
response.order_list.prescription_rejection_time	timestamp		Time of when the prescription is rejected.
response.order_list.prescription_reject_reason	string	Insufficient prescription detail	Return the reason why a prescription is rejected. If there is no rejection reason, return empty.Only for ID and PH whitelist sellers
response.order_list.is_buyer_shop_collection	boolean		To indicate if this order is buyer self collection at store order
response.order_list.buyer_proof_of_collection	string[]		The image url of the buyer self collection at the store.
response.order_list.edt_from	timestamp		Earliest estimated delivery date of orders (only available for BR region)
response.order_list.edt_to	timestamp		Latest estimated delivery time of orders (only available for BR region)
response.order_list.booking_sn	string	2404098R48U37H	Return by default. Shopee's unique identifier for a booking.; Only returned for advance fulfilment matched order only.
response.order_list.advance_package	boolean	true	Indicate whether order will be fulfilled using advance fulfilment stock or not. If value is true, order will be matched with a booking and seller should not arrange shipment.
response.order_list.return_request_due_date	timestamp		This field represents the deadline for buyers to initiate returns and refunds after order is completed.; The “return_request_due_date” response parameter will be returned if the requested order meets ALL the conditions below: - The status of the order is COMPLETED; - The return refund eligibility of the order is true; If you have any questions related to the function of "returns and refunds after order is completed," please refer to the following link: https://seller.shopee.tw/edu/article/18474
response.order_list.payment_info	object[]		[Only for BR] List of payment information, to follow NT 2025.001 (BR government invoice rules).
response.order_list.payment_info.payment_method	string	Debit Card	[Only for BR] Payment method used in the order, such as Credit Card, Debit Card, Pix, etc.
response.order_list.payment_info.payment_processor_register	string	38.372.267/0001-82	[Only for BR] CNPJ of the payment processor handling the transaction.
response.order_list.payment_info.card_brand	string	VISA	[Only for BR] Card brand for credit or debit transactions, such as VISA, MASTER, etc. Empty string for Pix payments.
response.order_list.payment_info.transaction_id	string	951679	[Only for BR] Payment authorization code generated by the bank or payment processor to validate the transaction.
response.order_list.payment_info.payment_amount	float	1004.0	[Only for BR] Amount paid by the corresponding payment method.
response.order_list.hot_listing_order	boolean	true	[Only for PH,TH,VN,MY,BR,TW] True if the order includes hot listing item.
response.order_list.is_international	boolean	false	[Only for BR] Indicate if the order is SIP order. This field will only be returned if international_label is included in response_optional_field in the request.
response.order_list.can_full_cancel_order	boolean	true	Indicates whether the order can be full cancelled: - If this value is true, seller can cancel the entire order; - If the value is false, full order cancellation is not available for the order
response.order_list.can_partial_cancel_order	boolean	false	Indicates whether the order is eligible for partial cancellation. This value is determined by both the system eligibility check and the buyer’s out-of-stock handling preference.; - If this value is true, seller can cancel selected out-of-stock item quantities while continuing to fulfill the remaining items.; - If this value is false, partial cancellation is not allowed.
response.order_list.buyer_preference_for_partial_cancellation	int64	1	Indicates the buyer’s preference for handling out-of-stock items in the order. Applicable values: 0 = Ship Available Items Only (The buyer allows the seller to cancel unavailable items and continue shipping the remaining available items); 1 = Cancel The Entire Order (The buyer does not allow partial cancellation. If any item is unavailable, the seller should cancel the entire order instead)
response.order_list.affiliate_sample_type	int32	1	Indicates that this order is a refundable sample order. Applicable values: 0 = Order is not a refundable sample order; 1 = Order is a refundable sample order
warning	string[]		Indicate warning message you should take care.

§5 Common parameters

Common parameters

Name	Type	Sample	Description
partner_id	int	1	Partner ID is assigned upon registration is successful. Required for all requests.
timestamp	timestamp	1610000000	This is to indicate the timestamp of the request. Required for all requests. Expires in 5 minutes.
access_token	string	c09222e3fc40ffb25fc947f738b1abf1	The token for API access, using to identify your permission to the api. Valid for multiple use and expires in 4 hours.
shop_id	int	600000	Shopee's unique identifier for a shop. Required param for most APIs.
sign	string	e318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2	Signature generated by partner_id, api path, timestamp, access_token, shop_id and partner_key via HMAC-SHA256 hashing algorithm. More details: https://open.shopee.com/documents?module=87&type=2&id=58&version=2

§6 Request samples

Request samples

§7 Java

Java

Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.get("https://open.admin.shopee.io/api/v2/order/get_order_detail?access_token=access_token&order_sn_list=201214JAJXU6G7%2C201214JASXYXY6&partner_id=partner_id&request_order_status_pending=true&response_optional_fields=total_amount&shop_id=shop_id&sign=sign&timestamp=timestamp")
.asString();

§8 PHP

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://open.admin.shopee.io/api/v2/order/get_order_detail?access_token=access_token&order_sn_list=201214JAJXU6G7%2C201214JASXYXY6&partner_id=partner_id&request_order_status_pending=true&response_optional_fields=total_amount&shop_id=shop_id&sign=sign&timestamp=timestamp',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

§9 cURL

cURL

curl --location --request GET 'https://open.admin.shopee.io/api/v2/order/get_order_detail?access_token=access_token&order_sn_list=201214JAJXU6G7%2C201214JASXYXY6&partner_id=partner_id&request_order_status_pending=true&response_optional_fields=total_amount&shop_id=shop_id&sign=sign&timestamp=timestamp'

§10 Python

Python

import requests

url = "https://open.admin.shopee.io/api/v2/order/get_order_detail?access_token=access_token&order_sn_list=201214JAJXU6G7%2C201214JASXYXY6&partner_id=partner_id&request_order_status_pending=true&response_optional_fields=total_amount&shop_id=shop_id&sign=sign&timestamp=timestamp"

payload={}
headers = {

}
response = requests.RPCRequest("GET",url,headers=headers, data=payload, allow_redirects=False)

print(response.text)

§11 Response sample

Response sample

§12 JSON

JSON

{
{
    "error": "",
    "message": "",
    "request_id": "023c50ace933ba38473a5fb2a7dc8821",
    "response": {
        "order_list": [
            {
                "actual_shipping_fee_confirmed": true,
                "buyer_cancel_reason": "",
                "buyer_cpf_id": null,
                "buyer_user_id": 1170319091,
                "buyer_username": "xt4fdsf96j",
                "cancel_by": "",
                "cancel_reason": "",
                "cod": true,
                "create_time": 1712601591,
                "currency": "VND",
                "days_to_ship": 2,
                "dropshipper": null,
                "dropshipper_phone": null,
                "estimated_shipping_fee": 5000,
                "fulfillment_flag": "fulfilled_by_local_seller",
                "goods_to_declare": false,
                "invoice_data": null,
                "item_list": [
                    {
                        "add_on_deal": false,
                        "add_on_deal_id": 0,
                        "image_info": {
                            "image_url": "https://cf.shopee.vn/file/vn-11134207-7qukw-lf6guphtf6oad3_tn"
                        },
                        "is_b2c_owned_item": false,
                        "is_prescription_item": false,
                        "item_id": 23620853561,
                        "item_name": "🦋giảm giá🦋Kem nở ngực SADOER enlarging breast cream Papaya / Coconut essence 60g Chiết xuất đu đủ, cùi dừa, nở ngực, kem nâng ngực nhanh",
                        "item_sku": "",
                        "main_item": false,
                        "model_discounted_price": 48000,
                        "model_id": 221404189791,
                        "model_name": "60g（Papaya）",
                        "model_original_price": 300000,
                        "model_quantity_purchased": 1,
                        "model_sku": "QAZ-SADOER-05",
                        "order_item_id": 23620853561,
                        "product_location_id": [
                            "VN10XX2UZ"
                        ],
                        "promotion_group_id": 0,
                        "promotion_id": 779222207758537,
                        "promotion_type": "flash_sale",
                        "weight": 0.01,
                        "wholesale": false
                    }
                ],
                "message_to_seller": "",
                "note": "",
                "note_update_time": 0,
                "order_sn": "2404098R48U37H",
                "order_status": "COMPLETED",
                "package_list": [
                    {
                        "group_shipment_id": null,
                        "item_list": [
                            {
                                "item_id": 23620853561,
                                "model_id": 221404189791,
                                "model_quantity": 1,
                                "order_item_id": 23620853561,
                                "product_location_id": "VN10XX2UZ",
                                "promotion_group_id": 0
                            }
                        ],
                        "logistics_status": "LOGISTICS_DELIVERY_DONE",
                        "package_number": "OFG166300791210964",
                        "parcel_chargeable_weight_gram": 10,
                        "shipping_carrier": "5-Day Delivery (SPX)",
                        "logistics_channel_id": 18080
                        "allow_self_design_awb": true,
			"sorting_group": "North"
                    }
                ],
                "pay_time": 1712817766,
                "payment_method": "Cash on Delivery",
                "pickup_done_time": 1712726577,
                "recipient_address": {
                    "city": "Huyện Phước Long",
                    "district": "Xã Phong Thạnh Tây B",
                    "full_address": "Ấp******",
                    "name": "P******n",
                    "phone": "******64",
                    "region": "VN",
                    "state": "Bạc Liêu",
                    "town": "",
                    "zipcode": ""
                },
                "region": "VN",
                "reverse_shipping_fee": 0,
                "ship_by_date": 1712671200,
                "shipping_carrier": "Giao Hàng Nhanh",
                "split_up": false,
                "total_amount": 32119,
                "update_time": 1713139948
            }
        ]
    }
}

§13 Error example

Error example

§14 JSON

JSON

{
    "error": "error_not_found",
    "message": "Wrong parameters, detail: the order is not found.",
    "request_id": "f72084b67edbe084aec5f4373d9f0f21"
}

§15 Errors

Errors

Error	Description	Solution
error_not_found	Wrong parameters, detail: {msg}.
error_param	Wrong parameters, detail: {msg}.
error_permission	Sorry you don't have the permission, detail: {msg}.
error_server	System error. Please try again later.
error_network	Inner http call failed
error_data	parse data failed
error_data	data not exist
error_param	parameter invalid
error_param	The information you queried is not found.
error_param	Wrong parameters, detail: {msg}.
error_server	Something wrong. Please try later.
error_shop	shopid is invalid
error_param	request not from gateway

§16 Common errors

Common errors

Error	Description	Solution
error_auth	partner_id is invalid
error_auth	The App is deleted, and you'll be unable to make any API call.
error_auth	App developer’s permissions for authorizations have been restricted. If you’re a seller, contact the developer for more information. If you’re the developer, refer to the Open Platform Console for details.
error_param	There is no partner_id in query.
error_param	Invalid partner_id.
error_param	no timestamp
error_param	Invalid timestamp
error_param	There is no sign in query.
error_sign	Wrong sign.
invalid_partner_id	Invalid partner_id, please have a check.
error_auth	No permission to current api.
error_api_call_restricted	The App permission for api call have been restricted. If you’re a seller, contact the developer for more information. If you’re the developer, refer to the Open Platform Console for details.
api_suspended	The API is offline. Please call v2 API instead.
error_limit	The total API call number made by your APP has reached the daily API call limit, please try again after 00: 00 (UTC+08:00)
error_rate_limit	Too many requests. You have reached the rate limit. Please try again later.
source_ip_undeclared	Request Source IP ({ip}) is undeclared. Please declare all your IP addresses in the Shopee Open Platform Console > App list > IP Address Whitelist
error_param	Permission denied. This API is currently offline or the request path is incorrect.
error_param	Partner_id is invalid, should be an integer between 0 and 4294967295.
error_param	no timestamp.
error_param	Timestamp is invalid, should be an integer between 0 and 4294967295.
error_param	Timestamp is expired.
error_partner_key_expired	Your API partner key has expired, please reset the Live API Partner Key in Console to get a new valid partner key to call open api.
error_api_permission	This app type has no permission to this API.
error_param	There is no access_token in query.
error_auth	Invalid access_token.
error_auth	Invalid partner_id or shopid.
shop_no_linked	Partner and shop has no linked.
shop_banned	The shop account has been banned. Permissions for shop authorization and API calls have been suspended until the shop account is restored.
invalid_acceess_token	Invalid access_token, please have a check.
partner_shop_no_link	Invalid partner_id or shop_id, please have a check.
error_ashop_api_permission	The shop is Affiliate shop has no permission to call this API.
error_kyc_auth	No permission. Please inform the seller to complete the Seller Registration on Shopee Seller Center first, then this shop can call for this API.
error_auth	System error, please try again later.
error_param	There is no shop_id in query.
error_param	shop_id is invalid, should be an integer between 0 and 4294967295.

§17 Update log

Update log

Date	Change
2026-08-27	Add "is_fulfillment_mapping""bundle_sku_id""components" as Response Parameter
2026-08-06	Add "status" and "pending_reason" under "invoice_data"
2026-07-17	add "line_item_id" as Response Parameter
2026-07-01	add affiliate_sample_type
2026-06-17	add a new field error_in_fetching_is_prescription_item

这条内容对你有帮助吗？