Skip to main content

v2.returns.query_proof

GET /api/v2/returns/query_proof

Support sellers to query the evidence uploaded through the upload evidence API.

Endpoint URL

URL: https://partner.shopeemobile.com/api/v2/returns/query_proof

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.
shop_idint600000Shopee's unique identifier for a shop. Required param for most APIs.
signstringe318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2Signature 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

Request Parameters

NameTypeRequiredSampleDescription
return_snstringTrue123456The serial number of return.

Response Parameters

NameTypeSampleDescription
request_idstringopenapi-5c30ac4af4a567464b3bcb85f327d0deThe identifier for an API request for error tracking.
errorstringIndicate error code if hit error. Empty if no error happened.
messagestringsuccessIndicate error details if hit error. Empty if no error happened.
responseobject
imageobject[]
urlstringhttps://file-proxy.seller.test.shopee.com/api/v2/files/c2hvcGVlLWRyYzAx/6cd5662c25964655827057bb2bfa69e2.pngThe image url in dispute proof.
thumbnailstringhttps://file-proxy.seller.test.shopee.com/api/v2/files/c2hvcGVlLWRyYzAx/6cd5662c25964655827057bb2bfa69e2.pngThe thumbnail of image.
videoobject[]
urlstringhttps://file-proxy.seller.test.shopee.com/api/v2/files/c2hvcGVlLWRyYzAx/6cd5662c25964655827057bb2bfa69e2.pngThe video url in dispute proof.
thumbnailstringhttps://file-proxy.seller.test.shopee.com/api/v2/files/c2hvcGVlLWRyYzAx/6cd5662c25964655827057bb2bfa69e2.pngThe thumbnail of video
descriptionstringsome descriptionThe text description in the dispute proof.