Get list

GET

/api/v1/return-shipments/b2b/list

This API returns a paginated list of B2B return shipments belonging to the authenticated merchant.

The result can be filtered by warehouse or keyword.

Notes

All timestamps are Unix timestamps (seconds).

Timestamp fields may be null if the corresponding process has not occurred.

Results are returned according to the specified pagination parameters.

keyword supports searching by return_tracking_code or merchant_return_tracking_code_reference.

Request

Authorization

Add parameter in header

Authorization

Example:

Authorization: ********************

Query Params

Responses

🟢200

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v1/return-shipments/b2b/list?page_size=10&page=1&warehouse_code=ONF_WH_HCM_APD&keyword=undefined' \
--header 'Authorization: <api-key>'

Response Example

{
    "data": [
        {
            "status_info": {
                "value": 100,
                "label": "Chờ nhận",
                "updated_time": 1783479964
            },
            "created_time": 1783479964,
            "updated_time": 1783479964,
            "return_tracking_code": "OARSB233096861",
            "merchant_return_tracking_code_reference": "MRCR_1898877889_9878",
            "warehouse_code": "ONF_WH_HCM_APD",
            "returned_time": null,
            "return_completed_time": null,
            "inspection_time": null,
            "estimated_arrival_time": 1783739163
        }
    ],
    "error": false,
    "error_code": null,
    "log_id": null,
    "messages": "OK",
    "total": 1,
    "version": "1.0.8",
    "error_detail": null,
    "execution_time": []
}

Modified at 2026-07-08 07:58:48

Create

Get detail

Get list

Notes#

Request

Responses

Notes