Skip to main content

v2.merchant.get_merchant_warehouse_list

POST /api/v2/merchant/get_merchant_warehouse_list

Get merchant warehouse with page

Endpoint URL

URL: https://partner.shopeemobile.com/api/v2/merchant/get_merchant_warehouse_list

Common Request Parameters

NameTypeSampleDescription
partner_idint1Partner ID is assigned upon registration is successful. Required for all requests.
timestamptimestamp1610000000This is to indicate the timestamp of the request. Required for all requests. Expires in 5 minutes.
access_tokenstringc09222e3fc40ffb25fc947f738b1abf1The token for API access, using to identify your permission to the api. Valid for multiple use and expires in 4 hours.
merchant_idint1Shopee’s unique identifier for a merchant. Required for all merchant level requests(CB CNSC user calling global product related APIs).
signstringe318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2Signature generated by partner_id, api path, timestamp, access_token, merchant_id and partner_key via HMAC-SHA256 hashing algorithm. More details: https://open.shopee.com/documents?module=87&type=2&id=58&version=2

Request Parameters

NameTypeRequiredSampleDescription
cursorobjectTrue// how to use DoubleSidedCursor // Get data for the first page: Please pass next_id = 0 or nil, page_size = {your page size}. // Get data for the next page: Please pass the Cursor from the previous response, and set prev_id=nil; // Get data for the prev page: Please pass the Cursor from the previous response, and set next_id=nil; // Stop fetching next data: The Cursor.next_id in the previous response is nil. // Stop fetching prev data: The Cursor.prev_id in the previous response is nil.
next_idintFalse
prev_idintFalse
page_sizeintTrueThe size of one page. Limit is [1,30].
warehouse_typeintTrue1 means pickup warehouse 2 means return warehouse

Response Parameters

NameTypeSampleDescription
request_idstringThe identifier of the API request for error tracking.
errorstringIndicate error type if hit error. Empty if no error happened.
messagestringIndicate error details if hit error. Empty if no error happened.
responseobject
total_countintTotal count of all warehouses.
warehouse_listobject[]
warehouse_idintWarehouse address identifier.
warehouse_namestringThe warehouse name filled in when creating the warehouse.
warehouse_typeint1 means pickup warehouse 2 means return warehouse
warehouse_regionstringRegion of your warehouse.
location_idstringLocation identifier for stocks. Different location_ids represent that your addresses are in different item stocks.
addressobject
address_namestringThe address name filled in when creating the warehouse.
regionstringRegion of your warehouse address.
addressstringDetail address of your warehouse address.
citystringCity of your warehouse address.
districtstringDistinct of your warehouse address.
statestringState of your warehouse address.
townstringTown of your warehouse address.
zip_codestringZipcode of your warehouse address.
enterprise_infoobject
company_namestring
cnpjstring
state_registration_numberstring
is_freight_payerboolean
cursorobject
next_idint
prev_idint
page_sizeint