Documentation

Create Order Instant

Request an instant delivery pickup and receive an AWB number for the courier

POST

Request

PayloadValuesTypeRequired
serviceCourier code: gosend, borzo, grab_expressStringYES
service_typeService type from pricing response (costs[].service_type)StringYES
vehicleVehicle type: motor (bike) or mobil (car)StringYES
order_prefixYour prefix for order ID generation (e.g., BDI)StringYES
packagesArray of package objects (see below)Array of ObjectYES

Package Object

PayloadValuesTypeRequired
origin_nameSender nameStringYES
origin_phoneSender phone (use country prefix)StringYES
origin_latSender latitudeFloatYES
origin_longSender longitudeFloatYES
origin_addressSender full addressStringYES
origin_address_noteSender address note (e.g., "Near office")StringYES
destination_nameRecipient nameStringYES
destination_phoneRecipient phone (use country prefix)StringYES
destination_latRecipient latitudeFloatYES
destination_longRecipient longitudeFloatYES
destination_addressRecipient full addressStringYES
destination_address_noteRecipient address note (e.g., "Near office")StringYES
shipping_priceShipping cost value (used for validation)IntegerYES
itemItem details (see below)ObjectYES

Item Object

PayloadValuesTypeRequired
nameItem nameStringYES
descriptionItem descriptionStringYES
priceGoods value (for insurance)IntegerYES
weightPackage weight in gramsIntegerYES

Example

{
  "service": "gosend",
  "service_type": "instant",
  "vehicle": "motor",
  "order_prefix": "BDI",
  "packages": [
    {
      "destination_name": "Okka Syahputra",
      "destination_phone": "081280045616",
      "destination_lat": -7.776192418965594,
      "destination_long": 110.32505379554323,
      "destination_address": "Godean, Sidoarum, Sleman",
      "destination_address_note": "Tidak Ada Destination",
      "origin_name": "Rizky Syahputra",
      "origin_phone": "081280045616",
      "origin_lat": -7.854584796417944,
      "origin_long": 110.33115444430031,
      "origin_address": "Wirobrajan, Kota Yogyakarta, Daerah Istimewa Yogyakarta, Indonesia",
      "origin_address_note": "Tidak Ada Origin",
      "shipping_price": 34000,
      "item": {
        "name": "Barang 1",
        "description": "Barang 1 Description",
        "price": 20000,
        "weight": 1000
      }
    }
  ]
}

Response (Success)

{
  "status": true,
  "text": "success",
  "code": 0,
  "method": null,
  "result": {
    "payment": {
      "payment_id": "PID-1736406074",
      "amount": 34000,
      "status_code": "Pembayaran berhasil",
      "qr_content": null,
      "pay_time": null
    },
    "packages": [
      {
        "awb": "GK-11-3177494",
        "order_id": "BDI-1736406073777",
        "service": "gosend",
        "service_type": "instant",
        "status": 105,
        "live_track_url": null,
        "poly_line": "db}n@{`l`TyAYp@yDhAaIt@yEd@wBTwAx@{FbAaGRgBf@_CjA}H?IoMoBeEi@iBY{PaCcCg@cGcCqFqBi@jIg@a@eNeBeKwA}Dc@u@Ck`@QuMIiCKcATu@?_AUuMUmC[SCQGUgAe@a@UCiCGsAEKAANsEhe@CfIXzKGh@Qr@Ul@mPzXa@nAYjAKbAIlEKnTQx@QZW\\_@Zk@T]Fk@@c{@mB}a@mAkAO_Bm@aAMqXJ[AOEMsAAo@H_@vCqKF_@Ae@Oe@c@o@m@g@_C_B_@[wAw@w@@iUu@uLe@}]eAkBCyJ]}KS?JqFQsBO_CI}FOeGUkDWo@GqAE]Lc@XCLGrA?fE@p@AN[|Am@|AO\\c@r@_@v@_@~BYrBo@jD`B\\XDLL@PKt@@J",
        "origin": {
          "name": "Rizky Syahputra",
          "address": "Wirobrajan, Kota Yogyakarta, Daerah Istimewa Yogyakarta, Indonesia",
          "phone": "081280045616",
          "lat_long": "-7.8545847964179,110.3311544443"
        },
        "destination": {
          "name": "Okka Syahputra",
          "address": "Godean, Sidoarum, Sleman",
          "phone": "081280045616",
          "lat_long": "-7.7761924189656,110.32505379554"
        },
        "driver": {
          "name": null,
          "phone": null,
          "image": null
        }
      }
    ]
  }
}

Response (Error)

{
  "status": false,
  "text": "cannot process the request, distance more than 40km",
  "code": 2,
  "method": null,
  "result": null
}