### Request Example

Source: https://developer.kiriminaja.com/docs/order/tracking-instant

This example shows how to make a GET request to the tracking API.

```curl
curl --location 'https://tdev.kiriminaja.com/api/mitra/v4/instant/tracking/NBL2-1705636897084' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {token}'
```

--------------------------------

### Go Installation

Source: https://developer.kiriminaja.com/docs/others/sdk-availability

Command to install the KiriminAja Go SDK.

```bash
go get github.com/kiriminaja/go
```

--------------------------------

### Node.js Installation

Source: https://developer.kiriminaja.com/docs/others/sdk-availability

Command to install the KiriminAja Node.js SDK.

```bash
bun add kiriminaja
```

--------------------------------

### Ruby Installation

Source: https://developer.kiriminaja.com/docs/others/sdk-availability

Command to install the KiriminAja Ruby SDK.

```bash
gem install kiriminaja
```

--------------------------------

### Instant Response Example

Source: https://developer.kiriminaja.com/docs/payment

Example JSON response for an Instant payment inquiry.

```json
{
  "status": true,
  "text": "get_payment",
  "method": null,
  "result": {
    "payment_id": "PID-1683603627",
    "amount": 54000,
    "status_code": 0,
    "qr_content": null,
    "pay_time": null,
    "packages": [
      {
        "awb": "GK-11-2239895",
        "order_id": "YAN-1683603626755",
        "service": "gosend",
        "service_name": "instant",
        "status": 105,
        "live_track_url": null,
        "origin": {
          "name": "sopo jei aku ra ngerti",
          "address": "Kawasan Mega Kuningan, Jalan Dr Ide Anak Agung Gde Agung Kav E.1.2 No 1&2, Jakarta, 12950",
          "phone": "08967872837",
          "latitude": -6.2184034,
          "longitude": 106.8276737
        },
        "destination": {
          "name": "sopo jei aku ra ngerti",
          "address": "Jl. Jenderal Sudirman No.45 - 46, RT.3/RW.4, Karet Semanggi, Kecamatan Setiabudi, Kota Jakarta Selatan, Daerah Khusus Ibukota Jakarta 12930",
          "phone": "08967872837",
          "latitude": -6.1599934,
          "longitude": 106.6872187
        }
      }
    ]
  },
  "code": null
}
```

--------------------------------

### PHP Installation

Source: https://developer.kiriminaja.com/docs/others/sdk-availability

Command to install the KiriminAja PHP SDK.

```bash
compose require kiriminaja/kiriminaja-php
```

--------------------------------

### Response Example

Source: https://developer.kiriminaja.com/docs/webhook/setup

Example of a successful response after setting the callback.

```json
{
  "status": true,
  "method": "set_callback",
  "text": "Callback di set ke https://kiriminaja.com/webhook-test"
}
```

--------------------------------

### Python Installation

Source: https://developer.kiriminaja.com/docs/others/sdk-availability

Command to install the KiriminAja Python SDK.

```bash
pip install kiriminaja
```

--------------------------------

### Request Body Example

Source: https://developer.kiriminaja.com/docs/pricing/express

Example of a request body to get pricing for express shipping.

```json
{
  "origin": 5783,
  "subdistrict_origin": 31532,
  "destination": 5507,
  "subdistrict_destination": 65005,
  "weight": 322,
  "length": 1,
  "width": 1,
  "height": 1,
  "item_value": "149990",
  "insurance": 1,
  "courier": ["jne"]
}
```

--------------------------------

### Response Example

Source: https://developer.kiriminaja.com/docs/coverage-area/subdistrict-by-name

Example of a successful response when searching for subdistricts.

```json
{
  "status": true,
  "text": "Success",
  "data": [
    {
      "province_id": 11,
      "city_id": 164,
      "district_id": 2275,
      "subdistrict_id": 46310,
      "full_address": "Sidokerto, Mojowarno, Jombang, Jawa Timur, 61475"
    },
    {
      "province_id": 11,
      "city_id": 251,
      "district_id": 3550,
      "subdistrict_id": 40316,
      "full_address": "Sidokerto, Sidorejo, Magetan, Jawa Timur, 63352"
    },
    {
      "province_id": 11,
      "city_id": 306,
      "district_id": 4348,
      "subdistrict_id": 40399,
      "full_address": "Sidokerto, Karangjati, Ngawi, Jawa Timur, 63284"
    },
    {
      "province_id": 10,
      "city_id": 344,
      "district_id": 4833,
      "subdistrict_id": 66968,
      "full_address": "Sidokerto, Pati, Pati, Jawa Tengah, 59111"
    },
    {
      "province_id": 11,
      "city_id": 409,
      "district_id": 5632,
      "subdistrict_id": 70886,
      "full_address": "Sidokerto, Buduran, Sidoarjo, Jawa Timur, 61252"
    },
    {
      "province_id": 10,
      "city_id": 427,
      "district_id": 5874,
      "subdistrict_id": 62642,
      "full_address": "Sidokerto, Plupuh, Sragen, Jawa Tengah, 57283"
    },
    {
      "province_id": 10,
      "city_id": 497,
      "district_id": 6889,
      "subdistrict_id": 62966,
      "full_address": "Sidokerto, Girimarto, Wonogiri, Jawa Tengah, 57683"
    },
    {
      "province_id": 18,
      "city_id": 225,
      "district_id": 3179,
      "subdistrict_id": 74983,
      "full_address": "Sidokerto, Bumi Ratu Nuban, Lampung Tengah, Lampung, 34161"
    },
    {
      "province_id": 11,
      "city_id": 444,
      "district_id": 6152,
      "subdistrict_id": 69312,
      "full_address": "Simokerto, Simokerto, Surabaya, Jawa Timur, 60143"
    },
    {
      "province_id": 11,
      "city_id": 444,
      "district_id": 6152,
      "subdistrict_id": 69310,
      "full_address": "Kapasan, Simokerto, Surabaya, Jawa Timur, 60141"
    },
    {
      "province_id": 11,
      "city_id": 444,
      "district_id": 6152,
      "subdistrict_id": 69311,
      "full_address": "Sidodadi, Simokerto, Surabaya, Jawa Timur, 60145"
    },
    {
      "province_id": 11,
      "city_id": 444,
      "district_id": 6152,
      "subdistrict_id": 69313,
      "full_address": "Simolawang, Simokerto, Surabaya, Jawa Timur, 60144"
    },
    {
      "province_id": 11,
      "city_id": 444,
      "district_id": 6152,
      "subdistrict_id": 69314,
      "full_address": "Tambakrejo, Simokerto, Surabaya, Jawa Timur, 60142"
    }
  ],
  "method": "getAddresses"
}
```

--------------------------------

### Express Response Example

Source: https://developer.kiriminaja.com/docs/payment

Example JSON response for an Express payment inquiry.

```json
{
  "status": true,
  "text": "Success",
  "method": "payment",
  "data": {
    "payment_id": "XID-5732095327",
    "qr_content": "XXX",
    "method": "08",
    "pay_time": "20210712103644",
    "status": "Billing berhasil dibuat",
    "status_code": "9",
    "amount": 65000,
    "paid_at": null,
    "created_at": "2021-07-12T03:35:42.000000Z"
  }
}
```

--------------------------------

### Request Sample

Source: https://developer.kiriminaja.com/docs/pricing/instant

This is a sample request to get pricing for instant delivery services.

```curl
curl --location 'https://tdev.kiriminaja.com/api/mitra/v4/instant/pricing' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {token}' \
--data '{
    "service" : ["gosend", "borzo", "grab_express"],
    "item_price" : 20000,
    "origin" : {
        "lat" : -7.8032616,
        "long" : 110.350244,
        "address" : "Wirobrajan, Kota Yogyakarta, Daerah Istimewa Yogyakarta, Indonesia"
    },
    "destination" : {
        "lat" : -7.734943400000001,
        "long" : 110.405355,
        "address" : "Minomartani, Kec. Ngaglik, Kabupaten Sleman, Daerah Istimewa Yogyakarta, Indonesia"
    },
    "weight" : 2,
    "vehicle" : "motor",
    "timezone" : "WIB"
}'
```

--------------------------------

### Request Example

Source: https://developer.kiriminaja.com/docs/order/express

An example JSON payload for creating an express order.

```json
{
  "address": "Jl. Jodipati No.29 Perum Taman Kencana Sejahtera",
  "phone": "0813334546789",
  "kecamatan_id": 548,
  "kelurahan_id": 31487,
  "packages": [
    {
      "order_id": "YGL-000000019",
      "destination_name": "Flag Test",
      "destination_phone": "082223323333",
      "destination_address": "Jl. Magelang KM 11",
      "destination_kecamatan_id": 548,
      "destination_kelurahan_id": 31483,
      "destination_zipcode": 55598,
      "weight": 520,
      "width": 8,
      "height": 8,
      "length": 8,
      "item_value": 275000,
      "shipping_cost": 65000,
      "service": "posindonesia",
      "service_type": "901979",
      "item_name": "TEST Item name",
      "package_type_id": 7,
      "cod": 100000
    }
  ],
  "name": "Tokotries",
  "zipcode": "55598",
  "schedule": "2021-11-30 22:00:00"
}
```

--------------------------------

### Response

Source: https://developer.kiriminaja.com/docs/pricing/express

This is an example of a successful response from the shipping price API.

```json
{
  "status": true,
  "method": "shipping_price",
  "text": "Success",
  "details": {
    "origin_district_id": 5783,
    "origin_subdistrict_id": 31532,
    "destination_district_id": 5507,
    "destination_subdistrict_id": 65005,
    "origin_latitude": 0,
    "origin_longitude": 0,
    "weight": 322,
    "item_value": "149990",
    "width": 1,
    "length": 1,
    "insurance": 1,
    "height": 1,
    "expeditions": ["jne"],
    "cod": 0,
    "origin": 5783,
    "destination": 5507,
    "origin_kelurahan": 31532,
    "destination_kelurahan": 65005,
    "courier": ["jne"]
  },
  "results": [
    {
      "service": "jne",
      "service_name": "JNE Express Reguler",
      "service_type": "REG23",
      "cost": "12000",
      "etd": "2-3",
      "cod": true,
      "group": "regular",
      "drop": true,
      "cut_off_time": null,
      "force_insurance": false,
      "use_geolocation": false,
      "discount_campaign": {
        "discount": 0,
        "discount_percentage": 0,
        "discount_campaign_id": 0,
        "discount_type": ""
      },
      "discount_amount": 360,
      "discount_percentage": 0.03,
      "discount_type": "drop_only",
      "setting": {
        "cod_fee": "0.03",
        "minimum_cod_fee": "2500",
        "insurance_fee": "0.002",
        "insurance_add_cost": 0,
        "cod_fee_amount": 5466
      },
      "insurance": 2500
    },
    {
      "service": "jne",
      "service_name": "JNE Express Flat",
      "service_type": "FLREG23",
      "cost": "10500",
      "etd": "2-3",
      "cod": true,
      "group": "regular",
      "drop": false,
      "cut_off_time": null,
      "force_insurance": false,
      "use_geolocation": false,
      "discount_campaign": {
        "discount": 0,
        "discount_percentage": 0,
        "discount_campaign_id": 0,
        "discount_type": ""
      },
      "discount_amount": 0,
      "discount_percentage": 0,
      "discount_type": null,
      "setting": {
        "cod_fee": "0.03",
        "minimum_cod_fee": "2500",
        "insurance_fee": "0.002",
        "insurance_add_cost": 0,
        "cod_fee_amount": 5428
      },
      "insurance": 2500
    }
  ]
}
```

--------------------------------

### Request Example

Source: https://developer.kiriminaja.com/docs/order/void-instant

Example cURL command to cancel an instant delivery order.

```bash
curl --location --request DELETE 'https://tdev.kiriminaja.com/api/mitra/v4/instant/pickup/void/NBL2-1705636897084' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {token}'
```

--------------------------------

### Success Response Example

Source: https://developer.kiriminaja.com/docs/order/instant

Example of a successful response when creating an instant delivery order.

```json
{
  "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 Sample

Source: https://developer.kiriminaja.com/docs/pricing/instant

This is a sample response for the instant delivery pricing API.

```json
{
  "status": true,
  "text": "success",
  "method": "mitra_pricing",
  "result": [
    {
      "name": "gosend",
      "costs": [
        {
          "service_type": "instant",
          "estimation": "1-2 hours",
          "price": {
            "admin_fee": 1000,
            "shipping_costs": 54000,
            "total_price": 55000
          }
        },
        {
          "service_type": "sameday',
          "estimation": "6-8 hours",
          "price": {
            "admin_fee": 1000,
            "shipping_costs": 31500,
            "total_price": 32500
          }
        }
      ],
      "insurances": [
        {
          "value": 500,
          "type": "silver"
        },
        {
          "value": 1000,
          "type": "gold"
        }
      ]
    },
    {
      "name": "borzo",
      "costs": [
        {
          "service_type": "instant",
          "estimation": null,
          "price": {
            "admin_fee": 1500,
            "shipping_costs": 8800,
            "total_price": 10300
          }
        }
      ],
      "insurances": [
        {
          "value": 500,
          "type": "silver"
        },
        {
          "value": 1000,
          "type": "gold"
        }
      ]
    }
  ],
  "code": null
}
```

--------------------------------

### Request Payload Example

Source: https://developer.kiriminaja.com/docs/order/instant

Example of the JSON payload required to create an instant delivery order.

```json
{
  "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
      }
    }
  ]
}
```

--------------------------------

### Request Body Example

Source: https://developer.kiriminaja.com/docs/others/courier-detail

Example of the request body for the courier detail endpoint.

```json
{
  "courier_code": "jne"
}
```

--------------------------------

### Error Response Example

Source: https://developer.kiriminaja.com/docs/order/instant

Example of an error response when the delivery distance exceeds the limit.

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

--------------------------------

### Subdistrict Response Example

Source: https://developer.kiriminaja.com/docs/coverage-area/sub-district

Example of a successful response when retrieving subdistricts.

```json
{
  "status": true,
  "text": "Courier Loaded",
  "method": "get_kelurahan_from_kecamatan_id",
  "results": [
    {
      "id": 31483,
      "kelurahan_name": "Bawuran",
      "kecamatan_id": 548
    },
    {
      "id": 31484,
      "kelurahan_name": "Pleret",
      "kecamatan_id": 548
    },
    {
      "id": 31485,
      "kelurahan_name": "Segoroyoso",
      "kecamatan_id": 548
    },
    {
      "id": 31486,
      "kelurahan_name": "Wonokromo",
      "kecamatan_id": 548
    },
    {
      "id": 31487,
      "kelurahan_name": "Wonolelo",
      "kecamatan_id": 548
    }
  ]
}
```

--------------------------------

### Response Success

Source: https://developer.kiriminaja.com/docs/order/tracking-instant

This is an example of a successful response from the tracking API.

```json
{
  "status": true,
  "text": "success",
  "code": 0,
  "method": null,
  "result": {
    "driver": {
      "name": null,
      "phone": null,
      "photo": null
    },
    "origin": {
      "name": "Arfian",
      "address": "Wirobrajan, Kota Yogyakarta, Daerah Istimewa Yogyakarta, Indonesia",
      "address_note": "Tidak Ada Origin",
      "phone": "081280045616",
      "lat": -7.8032616,
      "long": 110.350244
    },
    "destination": {
      "name": "Arfian",
      "address": "Minomartani, Kec. Ngaglik, Kabupaten Sleman, Daerah Istimewa Yogyakarta, Indonesia",
      "address_note": "Tidak Ada Destination",
      "phone": "081280045616",
      "lat": -7.7349434,
      "long": 110.405355
    },
    "date": {
      "created_at": "2024-01-19T04:01:37.000000Z",
      "finished_at": null,
      "allocated_at": null,
      "canceled_at": null
    },
    "cost": {
      "shipping_cost": 34000,
      "insurance": null,
      "admin_fee": 1000,
      "total_price": 35000
    },
    "item": {
      "price": 20000,
      "description": "Barang 1"
    },
    "order_id": "NBL2-1705636897084",
    "service": "gosend",
    "service_type": "instant",
    "tracking_code": "GK-11-3120092",
    "cancel_description": null,
    "live_tracking_url": null
  }
}
```

--------------------------------

### Example Response

Source: https://developer.kiriminaja.com/docs/order/void

Example JSON object for the response when cancelling a package.

```json
{
  "status": true,
  "method": "cancel_shipment",
  "text": "Paket akan dibatalkan dalam 2x24jam",
  "data": {
    "success": "pending",
    "date": "2024-06-17 02:00:00"
  }
}
```

--------------------------------

### Subdistrict Request Example

Source: https://developer.kiriminaja.com/docs/coverage-area/sub-district

Example of a request to retrieve subdistricts based on a district ID.

```json
{
  "kecamatan_id": 548
}
```

--------------------------------

### Response Failed

Source: https://developer.kiriminaja.com/docs/order/tracking-instant

This is an example of a failed response from the tracking API.

```json
{
  "status": false,
  "text": "data not found",
  "code": 2,
  "method": null,
  "result": null
}
```

--------------------------------

### Pickup Schedule Response

Source: https://developer.kiriminaja.com/docs/pickup/schedule

Example JSON response for the pickup schedule endpoint, detailing available pickup windows.

```json
{
  "status": true,
  "method": "schedules",
  "text": "Success",
  "schedules": [
    {
      "clock": "2021-02-15 14:00:00",
      "until": "16:00",
      "expired": 1613385000,
      "libur": false
    },
    {
      "clock": "2021-02-16 08:00:00",
      "until": "11:00",
      "expired": 1613457000,
      "libur": false
    }
  ]
}
```

--------------------------------

### Request Body

Source: https://developer.kiriminaja.com/docs/coverage-area/district-by-name

Example of the request body to search for a district by name.

```json
{
  "search": "Ngemplak"
}
```

--------------------------------

### Response Body

Source: https://developer.kiriminaja.com/docs/coverage-area/district-by-name

Example of the response body when searching for a district by name.

```json
{
  "status": true,
  "text": "Success",
  "method": "get_address_by_name",
  "data": [
    {
      "id": 1251,
      "text": "Ngemplak, Kabupaten Boyolali, Jawa Tengah"
    },
    {
      "id": 5789,
      "text": "Ngemplak, Kabupaten Sleman, DI Yogyakarta"
    }
  ]
}
```

--------------------------------

### Response

Source: https://developer.kiriminaja.com/docs/order/void-instant

Example JSON response for a successful instant order cancellation.

```json
{
  "status": true,
  "text": "success",
  "code": 0,
  "method": null,
  "result": {
    "payment": {
      "payment_id": "PID-1705636897",
      "amount": 35000,
      "status_code": 0,
      "qr_content": "some-random-qr-string",
      "pay_time": "2024-01-19T04:01:38.450035Z"
    },
    "packages": [
      {
        "awb": "GK-11-3120092",
        "order_id": "NBL2-1705636897084",
        "service": "gosend",
        "service_type": "instant",
        "status": 105,
        "live_track_url": null,
        "polyline": "jasn@_xo`TPwD@WwEm@iDa@mFo@a@M}K{AgEe@wAQmEi@y@MyBSwBWiC[iCSaGw@qAKmCOKAFwALqBCmAWwAw@}BeAqC_@gAqCKaAEUIKu@o@sCUo@Wg@c@s@GAIIGKAEk@_@g@YsBeAaEkB[Iu@EsGIiCE}@@wEEyFK_KUkQYyJQsIMmUe@iEE}JQ}FKuXe@oP[oLOqEK}KKsEGeAC{AC_BCGPQRMBI?QCOKCGEQBQFOLGVw@`@_AjA_Ej@wBTc@l@aERgDP{BJsD`@eGh@cEj@cE`@qERoAf@yEx@iHHiA@o@IyAIsAEi@EeADmAB_@\eBBOICXuAr@qC^aAd@kAjAmC`AwBj@_AbAwAb@g@dA{@Dc@ASGQOKeAq@sAm@w@e@{GcDaAa@eAk@eAg@kAk@mHqD_CgAkBaAgD}AeG_DmFoCgAa@gAe@eDeBwDoByAs@mB_AsAq@{CyAsAq@uAu@eIcE{EcCuBaAkBy@iDcBqB_AcD}AmB{@gEsB_Ak@_Bu@KEf@cANY`CiFr@mAZs@?MIo@Bk@PoAJa@BMFMTSPMPQ^]^g@B[DkALyCDg@L@f@BbDD|@?pBDv@BAg@C}@G]E_ADOn@k@DuAHu@@KqAMWCB[",
        "origin": {
          "name": "Arfian",
          "address": "Wirobrajan, Kota Yogyakarta, Daerah Istimewa Yogyakarta, Indonesia",
          "phone": "081280045616",
          "latitude": -7.8032616,
          "longitude": 110.350244
        },
        "destination": {
          "name": "Arfian",
          "address": "Minomartani, Kec. Ngaglik, Kabupaten Sleman, Daerah Istimewa Yogyakarta, Indonesia",
          "phone": "081280045616",
          "latitude": -7.7349434,
          "longitude": 110.405355
        }
      }
    ]
  }
}
```

--------------------------------

### Request Payload

Source: https://developer.kiriminaja.com/docs/webhook/setup

Example of the JSON payload for setting a callback URL.

```json
{
  "url": "https://kiriminaja.com/webhook-test"
}
```

--------------------------------

### Express Order Response

Source: https://developer.kiriminaja.com/docs/order/express

Example JSON response for a successful express order request.

```json
{
  "status": true,
  "text": "Request pickup berhasil",
  "method": "request_pickup",
  "qr_url": "QR URL Of Payment",
  "payment_status": "unpaid",
  "details": [
    {
      "order_id": "OKAadasdad2awwda",
      "kj_order_id": "OKAadasdad2awwda",
      "awb": null,
      "service": "JNE",
      "service_type": "REG23"
    }
  ],
  "pickup_number": "EPR-123456789"
}

```

--------------------------------

### Finished Packages Webhook Payload

Source: https://developer.kiriminaja.com/docs/webhook/event-instant

Example JSON payload received when a package is marked as delivered.

```json
{
  "method": "finished_packages",
  "data": [
    {
      "order_id": "BDI-1754377171060",
      "awb": "GK-11-3289048",
      "date": "2025-08-05T06:59:31.000000Z",
      "shipped_at": "2025-08-05T07:00:05.000000Z",
      "finished_at": "2025-08-05T07:00:43.000000Z",
      "returned_at": null,
      "rejected_at": null,
      "reason": null
    }
  ],
  "payment": {
    "payment_id": "PID-1754377171",
    "amount": 30500,
    "status_code": 0,
    "qr_content": null,
    "pay_time": null
  },
  "packages": [
    {
      "awb": "GK-11-3289048",
      "order_id": "BDI-1754377171060",
      "service": "gosend",
      "service_type": "instant",
      "status": 200,
      "live_tracking_url": "live-tracking-url-instant",
      "poly_line": "poly-line-instant",
      "origin": {
        "name": "Daniel",
        "address": "Wirobrajan, Kota Yogyakarta, Daerah Istimewa Yogyakarta, Indonesia",
        "phone": "(sender phone number)",
        "latitude": -7.8032616,
        "longitude": 110.350244
      },
      "destination": {
        "name": "Rizky Okka S",
        "address": "Minomartani, Kec. Ngaglik, Kabupaten Sleman, Daerah Istimewa Yogyakarta, Indonesia",
        "phone": "(receiver phone number)",
        "latitude": -7.7349434,
        "longitude": 110.405355
      },
      "driver": {
        "name": null,
        "phone": null,
        "image": null
      }
    }
  ]
}
```

--------------------------------

### Response Sample

Source: https://developer.kiriminaja.com/docs/others/courier-detail

Sample of the response when fetching courier details.

```json
{
  "status": true,
  "method": "get_services_from_courier",
  "text": "Data Loaded",
  "datas": [
    {
      "name": "Reguler",
      "code": "REG",
      "cut_off_time": "23:03:00",
      "volumetrik": "6000",
      "rounded": 0.3,
      "courier_group": "regular"
    },
    {
      "name": "OKE",
      "code": "OKE",
      "cut_off_time": null,
      "volumetrik": "6000",
      "rounded": 0.3,
      "courier_group": "economy"
    },
    {
      "name": "Trucking",
      "code": "JTR",
      "cut_off_time": null,
      "volumetrik": "6000",
      "rounded": 0.3,
      "courier_group": "cargo"
    },
    {
      "name": "YES",
      "code": "YES",
      "cut_off_time": null,
      "volumetrik": "6000",
      "rounded": 0.3,
      "courier_group": "next_day"
    },
    {
      "name": "Reguler",
      "code": "REG19",
      "cut_off_time": "06:03:00",
      "volumetrik": "6000",
      "rounded": 0.3,
      "courier_group": "regular"
    },
    {
      "name": "OKE",
      "code": "OKE19",
      "cut_off_time": null,
      "volumetrik": "6000",
      "rounded": 0.3,
      "courier_group": "economy"
    },
    {
      "name": "YES",
      "code": "YES19",
      "cut_off_time": "05:05:00",
      "volumetrik": "6000",
      "rounded": 0.3,
      "courier_group": "next_day"
    },
    {
      "name": "Trucking",
      "code": "JTR18",
      "cut_off_time": null,
      "volumetrik": "5000",
      "rounded": 0.3,
      "courier_group": "cargo"
    },
    {
      "name": "Trucking",
      "code": "JTR23",
      "cut_off_time": null,
      "volumetrik": null,
      "rounded": null,
      "courier_group": "cargo"
    }
  ]
}
```

--------------------------------

### Response Sample

Source: https://developer.kiriminaja.com/docs/others/courier-list

This is a sample JSON response showing the structure of the courier list.

```json
{
  "status": true,
  "method": "get_active_courier",
  "text": "Data Loaded",
  "datas": [
    {
      "code": "tiki",
      "name": "Tiki",
      "type": "Express"
    },
    {
      "code": "posindonesia",
      "name": "Pos Indonesia",
      "type": "Express"
    },
    {
      "code": "paxel",
      "name": "Paxel",
      "type": "Express"
    },
    {
      "code": "gosend",
      "name": "GoSend",
      "type": "Instant"
    },
    {
      "code": "ninja",
      "name": "Ninja",
      "type": "Express"
    },
    {
      "code": "rpx",
      "name": "RPX Logistics",
      "type": "Express"
    },
    {
      "code": "borzo",
      "name": "Borzo",
      "type": "Instant"
    },
    {
      "code": "lion",
      "name": "Lion Parcel",
      "type": "Express"
    },
    {
      "code": "grab_express",
      "name": "Grab Express",
      "type": "Instant"
    },
    {
      "code": "jtcargo",
      "name": "J&T Cargo",
      "type": "Express"
    },
    {
      "code": "sentral",
      "name": "Sentral Cargo",
      "type": "Express"
    },
    {
      "code": "anteraja",
      "name": "AnterAja",
      "type": "Express"
    },
    {
      "code": "ncs",
      "name": "NCS Courier",
      "type": "Express"
    },
    {
      "code": "sicepat",
      "name": "Sicepat Express",
      "type": "Express"
    },
    {
      "code": "sap",
      "name": "SAP Courier",
      "type": "Express"
    },
    {
      "code": "idx",
      "name": "ID Express",
      "type": "Express"
    },
    {
      "code": "jne",
      "name": "JNE Express",
      "type": "Express"
    },
    {
      "code": "jnt",
      "name": "J&T Express",
      "type": "Express"
    }
  ]
}
```

--------------------------------

### Response Payload

Source: https://developer.kiriminaja.com/docs/order/tracking

This is an example of the response payload when tracking an order.

```json
{
  "status": true,
  "text": "Delivered to BAGUS | 14-07-2021 16:00 | YOGYAKARTA ",
  "method": "shTracking",
  "status_code": 200,
  "details": {
    "awb": "DEVEL-000000004",
    "signature_code": "C1OJWQAG",
    "sorting_code": "JOG-JOG1000-JKT2020",
    "order_id": "OID-8793949106",
    "status_code": null,
    "estimation": "-",
    "service": "jne",
    "service_name": "REG",
    "drop": false,
    "shipped_at": "2021-07-13 17:44:04",
    "delivered": true,
    "delivered_at": "2021-10-17 16:53:00",
    "refunded": false,
    "refunded_at": "",
    "images": {
      "camera_img": "https://s3-ap-southeast-1.amazonaws.com/pod.paket.id/1626253243482P||1411922100004643.jpeg",
      "signature_img": "https://s3-ap-southeast-1.amazonaws.com/pod.paket.id/1626253255242S||1411922100004643.jpeg",
      "pop_img": null
    },
    "costs": {
      "add_cost": 0,
      "currency": "IDR",
      "cod": 0,
      "insurance_amount": 0,
      "insurance_percent": 0,
      "discount_amount": 0,
      "subsidi_amount": 0,
      "shipping_cost": 10000,
      "correction": 0
    },
    "origin": {
      "name": "KiriminAja",
      "address": "Jl. Utara Stadion No.8, Jetis, Wedomartani",
      "phone": "628000000",
      "city": "Kabupaten Sleman",
      "zip_code": "55283"
    },
    "destination": {
      "name": "Zainal Arifin",
      "address": "Ngaglik RT. 32 Pendowoharjo Sewon Bantul Yogyakarta 55185",
      "phone": "6287839087416",
      "city": "Kabupaten Bantul",
      "zip_code": "55715"
    }
  },
  "histories": [
    {
      "created_at": "2021-07-14 16:00:00",
      "status": "Delivered to BAGUS | 14-07-2021 16:00 | YOGYAKARTA ",
      "status_code": 200,
      "driver": "",
      "receiver": "BAGUS"
    },
    {
      "created_at": "2021-07-14 09:53:00",
      "status": "With delivery courier YOGYAKARTA",
      "status_code": 100,
      "driver": "",
      "receiver": ""
    },
    {
      "created_at": "2021-07-14 00:02:00",
      "status": "Received at inbound station YOGYAKARTA - KP. GAMBIRAN",
      "status_code": 100,
      "driver": "",
      "receiver": ""
    },
    {
      "created_at": "2021-07-13 20:44:00",
      "status": "Shipment forwarded to destination YOGYAKARTA - KP. GAMBIRAN",
      "status_code": 100,
      "driver": "",
      "receiver": ""
    },
    {
      "created_at": "2021-07-13 18:34:00",
      "status": "Received at sorting center YOGYAKARTA",
      "status_code": 100,
      "driver": "",
      "receiver": ""
    },
    {
      "created_at": "2021-07-13 17:44:00",
      "status": "Shipment received by jne counter officer at YOGYAKARTA",
      "status_code": 100,
      "driver": "",
      "receiver": ""
    },
    {
      "status": "Paket dibuat oleh KiriminAja",
      "status_code": 100,
      "created_at": "2021-07-07 14:40:42",
      "driver": "",
      "receiver": ""
    }
  ]
}
```

--------------------------------

### return_finished_packages (Deprecated)

Source: https://developer.kiriminaja.com/docs/webhook/event

This is a deprecated event. Use `returned_packages` instead.

```json
{
  "method": "return_finished_packages",
  "data": [
    {
      "order_id": "OID-40592020",
      "date": "2021-03-31 00:00:00"
    },
    {
      "order_id": "OID-40592021",
      "date": "2021-03-31 00:00:00"
    }
  ]
}
```

--------------------------------

### Request Body

Source: https://developer.kiriminaja.com/docs/order/void

Example JSON object for the request body to cancel a package.

```json
{
  "awb": "DEVEL-000000004",
  "reason": "Package data is incorrect"
}
```

--------------------------------

### Set Preference (Express) Response

Source: https://developer.kiriminaja.com/docs/others/set-preference

Example response body for setting express delivery preferences.

```json
{
  "status": true,
  "text": "Success to set",
  "method": "set_whitelist_services"
}
```

--------------------------------

### Response Sample

Source: https://developer.kiriminaja.com/docs/others/courier-group-list

Sample JSON response for the courier group list endpoint.

```json
{
  "status": true,
  "method": "get_courier_groups",
  "text": "Data Loaded",
  "datas": [
    {
      "code": "regular",
      "name": "Regular"
    },
    {
      "code": "one_day",
      "name": "One Day"
    },
    {
      "code": "next_day",
      "name": "Next Day"
    },
    {
      "code": "economy",
      "name": "Ekonomi"
    },
    {
      "code": "cargo",
      "name": "Cargo"
    },
    {
      "code": "same_day",
      "name": "Same Day"
    }
  ]
}
```