Order Instant
POST
/order/instant
tariff_id from Check Tariff Instant.Main Request Fields
| Property Name | Data Type | Required | Notes |
|---|---|---|---|
shipper | Object | Yes | Shipper (sender) details. See table below. |
receiver | Object | Yes | Receiver details. See table below. |
stop | Object | No | Optional stop/waypoint details. See table below. |
item | Object | Yes | Item/package details. See table below. |
courier_code | String | Yes | Courier service provider code (e.g., lalamove, grab, etc.). Must match one from the tariff check. |
tariff_id | String | Yes | Tariff ID obtained from the Check Tariff API. Expires in 5 minutes and must be reused here to ensure consistent pricing. |
shipper Object
| Property Name | Data Type | Required | Notes |
|---|---|---|---|
name | String | Yes | Shipper’s full name. |
email | String | Yes | Shipper’s email address. |
address | String | Yes | Shipper’s full address. |
phone | String | Yes | Shipper’s phone number (must be in international format, e.g., 62812345678). |
receiver Object
| Property Name | Data Type | Required | Notes |
|---|---|---|---|
name | String | Yes | Receiver’s full name. |
email | String | Yes | Receiver’s email address. |
address | String | Yes | Receiver’s full address. |
phone | String | Yes | Receiver’s phone number (must be in international format, e.g., 62812345678). |
stop Object (Optional)
| Property Name | Data Type | Required | Notes |
|---|---|---|---|
address | String | No | Full stop/waypoint address. |
name | String | No | Contact person’s name at stop point. |
phone | String | No | Contact person’s phone number (international format). |
item Object
| Property Name | Data Type | Required | Notes |
|---|---|---|---|
name | String | Yes | Item name. |
desc | String | Yes | Item description. |
category | String | Yes | Item category. Allowed values: Perlengkapan Mobil & Motor, Peralatan Olahraga & Hiburan, Peralatan Kesehatan & Kecantikan, Peralatan Rumah Tangga, Peralatan Elektronik & Gadget, Dokumen, Dokumen Berharga, Pecah Belah, Pakaian, Aksesoris, Makanan, Elektronik, Obat, Frozen, Lainnya. |
weight | Number | Yes | Weight of the item in grams. |
width | Number | Yes | Width of the item in centimeters. |
height | Number | Yes | Height of the item in centimeters. |
length | Number | Yes | Length of the item in centimeters. |
value | Number | Yes | Declared value of the item in IDR. |
Response
API Response Explanation
{
"success": true,
"message": "Success",
"data": {
"awb": "AWB-67890",
"expect_pickup_start": "2025-07-25 10:00:00",
"expect_pickup_end": "2025-07-25 12:00:00",
"tariff": 15000
}
}Response Properties
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/order/instant' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic Og==' \
--data-raw '{
// "schedule": "2024-05-28 14:04:00", // YYYY-MM-DD HH:mm:ss (optional)
"shipper": {
"name": "John Doe",
"email": "john@example.com",
"address": "Jl. Cikini Raya",
"phone": "62812345678"
},
"receiver": {
"name": "John Doe",
"email": "john@example.com",
"address": "Jl. Puri Indah Raya",
"phone": "62812345678"
},
"stop":{//optional
"address":"Jl. Thamrin No.20, Jakarta",
"name": "John Doe2",
"phone": "62812345678"
},
"item": {
"name": "Item name",
"desc": "Item description",
"category": "Makanan",
"weight": 1000, //gram
"width": 10, // cm
"height": 10, // cm
"length": 1, //cm
"value": 10000
},
"courier_code": "lalamove",
"tariff_id": "0198c177-5efe-74ed-bd57-0585a3fe8282"
}'Response Response Example
201 - 200 - Works fine.
{
"success": true,
"message": "success",
"data": {
"awb": "3299216282796585922",
"expect_pickup_start": "2025-08-19T06:01:46.000Z",
"expect_pickup_end": "2025-08-19T06:01:46.000Z",
"tariff": 23618
},
"timestamp": "2025-08-19T06:01:47.001Z"
}Request
Body Params application/json
Responses
Modified at 2025-08-28 10:23:33