v2.ams.get_validation_list

GET /api/v2/ams/get_validation_list

Retrieve the seller's AMS validation bill

Endpoint URL

URL: https://partner.shopeemobile.com/api/v2/ams/get_validation_list

Common Request 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

No Request Parameters Set.

Response Parameters

Name	Type	Sample	Description
error	string	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.
request_id	string	b937c04e554847789cbf3fe33a0ad5f1	The identifier for an API request for error tracking.
response	object
validation_list	object[]
validation_id	string	363636002508	Unique identifier of the billing entry.
payment_method	int32	1	Payment method. Applicable values: 1 = Online 2 = Offline
validation_month	int32	202508	Billing month in the format YYYYMM (e.g., 202405).
campaign_source	string	ShopeeManaged	Source of campaign setup. Applicable values: ShopeeManaged Seller
online_bill	object		Billing details when payment method is Online.
total_amount	float	300.0	Total commission amount for the billing month.
bill_status	int32	2	Billing Status. Applicable values: 1 = Pending 2 = Completed 3 = In process 4 = To pay via payment link 5 = Manual completed 6 = To Be Settled Offline
deducted_amount	float	300.0	Commission amount already deducted.
ams_credit_deducted_amount	float	200.0	Commission amount paid using AMS Credits
pending_amount	int64	0	Commission amount pending deduction.
offline_bills	object[]		List of billing details when payment method is Offline, grouped by order placement month.
order_place_month	int32	202507	Order placement month in the format YYYYMM.
total_amount	float	420.5	Total commission amount = commission_amount_after_tax + ams_credit_deducted_amount.
commission_amount	float	200.0	Offline commission amount before tax.
commission_amount_after_tax	float	220.0	Offline commission amount including tax.
ams_credit_deducted_amount	float	200.5	Commission amount already paid using AMS Credits.