Request Pickup API

Deskripsi

Request Pickup API digunakan untuk memanggil kurir Lion Parcel ke lokasi pengirim setelah shipment berhasil dibuat dengan metode pickup.

API ini tidak membuat shipment atau STT, melainkan hanya mengajukan permintaan penjemputan paket berdasarkan Shipment ID dan lokasi (geolocation) pengirim yang telah didaftarkan sebelumnya.

API ini wajib digunakan pada skema:

• C2C / Marketplace flow

• Shipment Pickup Method

Endpoint

POST	https://api-stg-middleware.thelionparcel.com/v2/client/shipment/request-pickup
URL	[BASE_URL]/v2/client/shipment/request-pickup

Header

Name	Value
Content-Type	application/json
Authorization	Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjIzNTMyOTIyNTQsImlhdCI6MTcyMjU3MjI1NCwidXNlcm5hbWUiOiJib29raW5nYXBpX2NvcnBjZ2siLCJjbGllbnRfY29kZSI6IkNHSy0wMDAxLUMtMjgiLCJjbGllbnRfY29kZV9nZW5lc2lzIjoiQ0dLLTI5MTIifQ.gCw7DSepAyzPjlcjMUCPZqn9B7ai2ChiD8zOvJ33R3gNI7hMXofQviIStTQY5aEuF9Qe_YdYjjEpgeeYRg6qIxalJaMqsUNJNo8pxnuySK5AOBHsdgMgC9_A0A9tt0VTLnYIwKpNlIFBIDZvgb69h5PkM-NPX3XAv_aRqkQRLrkSQo8zzwQt29pG3cIwCAF9Xvt-QuG3TIl_5qtlfWyF4UPOKCawPlgXXAHwgaiGvgGH4fZKVMyAA10a1FxmNNMYzUSiG126Q_w93Kl435BrPdqx1oNIbSpq2SnngodKFKNIZpwQ715RNFMg0Gb1R19BK4Ew39yWSiARftotMVJ6kw
Timezone	+07:00

Request Body

Field	Data Type	Is Required	Sample Value	Description
shipment_ids	STRING	YES	"C1RFSDDV", "C1ZIHLYJ", "C1XCVMNF"	Only shipment ID C1XXXX (Shipment id pickup)
pickup_start_date	STRING	NO	"dd/mm/yyyy HH:mm"	Start date cannot below shipment create date.
pickup_end_date	STRING	NO	"dd/mm/yyyy HH:mm"	End date cannot below start date pickup

Request Example

{
  "shipment_ids": [
    "C1RFSDDV",
    "C1ZIHLYJ",
  ],
  "pickup_start_date": "06/10/2025 10:48",
  "pickup_end_date": "06/10/2025 12:48"
}

Response

200

{
  "success": true,
  "code": 200,
  "message": "Success request pickup",
  "data": {
    "pickup_statuses": [
      {
        "shipment_id": "C1RFSDDV",
        "is_success": true
      },
      {
        "shipment_id": "C1ZIHLYJ",
        "is_success": false
      }
    ]
  }
}

400