### Example Response for Address Search

Source: https://github.com/kiriminaja/docs/blob/subm/docs/2.coverage-area/5.Subdistrict-by-name.md

This is an example of a successful response when searching for addresses. It includes status, a success message, and a list of matching addresses with their respective IDs and full address details.

```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"
}
```

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

### Pickup Schedule Response Example

Source: https://github.com/kiriminaja/docs/blob/subm/docs/5.pickup/1.schedule.md

This JSON object represents a successful response when scheduling a pickup. It includes status, method, a success message, and a list of scheduled pickup times with their details.

```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
    }
  ]
}
```

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

### Get Courier Service Details

Source: https://context7.com/kiriminaja/docs/llms.txt

Returns all services offered by a specific courier. Service `code` values are required for order creation.

```bash
curl --location 'https://tdev.kiriminaja.com/api/mitra/courier_services' \
  --header 'Authorization: Bearer {api_key}' \
  --header 'Content-Type: application/json' \
  --data '{ "courier_code": "jne" }'
```

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

### Instant Payment Response

Source: https://github.com/kiriminaja/docs/blob/subm/docs/7.payment/1.index.md

Example JSON response for an Instant payment inquiry. Includes payment ID, amount, status, and package details with origin and destination information.

```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
}
```

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

### Instant Delivery Pricing API Request Sample

Source: https://github.com/kiriminaja/docs/blob/subm/docs/3.pricing/1.instant.md

Use this cURL command to get pricing for instant delivery services. Ensure you replace `{token}` with your actual API token and adjust the request body parameters as needed.

```bash
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"
}'
```

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

### Order Packages Object Example

Source: https://github.com/kiriminaja/docs/blob/subm/docs/4.order/1.express.md

This JSON object represents the structure for package details when creating an order. It includes recipient information and package specifics like weight, dimensions, and item value.

```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"
}
```

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

### Get Instant Delivery Pricing

Source: https://github.com/kiriminaja/docs/blob/subm/docs/3.pricing/1.instant.md

This endpoint allows you to retrieve pricing information for instant delivery services. You can specify details such as the service type, item price, origin, destination, weight, vehicle type, and timezone to get accurate cost estimations.

```APIDOC
## POST /api/mitra/v4/instant/pricing

### Description
Retrieves pricing details for instant delivery services based on provided shipment parameters.

### Method
POST

### Endpoint
/api/mitra/v4/instant/pricing

### Parameters
#### Request Body
- **service** (array) - Optional - Values: gosend, borzo, grab_express. Product type.
- **item_price** (int) - Required - The value of the goods being shipped.
- **origin** (object) - Required - Origin details for the shipment.
  - **lat** (float) - Required - Latitude of the origin.
  - **long** (float) - Required - Longitude of the origin.
  - **address** (string) - Required - Complete address details for the origin.
- **destination** (object) - Required - Destination details for the shipment.
  - **lat** (float) - Required - Latitude of the destination.
  - **long** (float) - Required - Longitude of the destination.
  - **address** (string) - Required - Complete address details for the destination.
- **weight** (int) - Required - Weight of the parcels in grams. Maximum 40,000gr (40kg).
- **vehicle** (string) - Optional - Vehicle option for shipment. Values: motor (default), mobil.
- **timezone** (string) - Optional - Timezone for the request. Values: WIB (default), WIT, WITA.

### Request Example
```bash
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" 
}'
```

### Response
#### Success Response (200)
- **status** (boolean) - Indicates if the request was successful.
- **text** (string) - A message describing the outcome of the request.
- **method** (string) - The API method called.
- **result** (array) - An array of pricing details for each requested service.
  - **name** (string) - The name of the delivery service.
  - **costs** (array) - An array of cost details for different service types.
    - **service_type** (string) - The type of service (e.g., instant, sameday).
    - **estimation** (string) - Estimated delivery time.
    - **price** (object) - Pricing breakdown.
      - **admin_fee** (integer) - The administrative fee.
      - **shipping_costs** (integer) - The cost of shipping.
      - **total_price** (integer) - The total price for the service.
  - **insurances** (array) - Available insurance options.
    - **value** (integer) - The value of the insurance.
    - **type** (string) - The type of insurance (e.g., silver, gold).
- **code** (any) - Additional code, if applicable.

#### Response Example
```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
}
```
```

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

### Cancel Order Response

Source: https://github.com/kiriminaja/docs/blob/subm/docs/4.order/8.void.md

This is an example of a successful response after requesting a package cancellation. The 'text' field indicates the expected voiding time.

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

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

### Express Payment Response

Source: https://github.com/kiriminaja/docs/blob/subm/docs/7.payment/1.index.md

Example JSON response for an Express payment inquiry. Includes payment details like ID, QR content, status, and amounts.

```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"
  }
}
```

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

### Get Instant Delivery Rates

Source: https://context7.com/kiriminaja/docs/llms.txt

Returns pricing for on-demand instant couriers based on GPS coordinates. Supports motor and car vehicle types.

```APIDOC
## POST /api/mitra/v4/instant/pricing

### Description
Returns pricing for on-demand instant couriers (GoSend, Borzo, Grab Express) based on GPS coordinates. Supports motor and car vehicle types.

### Method
POST

### Endpoint
/api/mitra/v4/instant/pricing

#### Request Body
- **service** (array of strings) - Required - An array of instant courier services to get pricing for (e.g., `["gosend", "borzo", "grab_express"]`).
- **item_price** (integer) - Required - The declared value of the item.
- **origin** (object) - Required - The origin coordinates and address.
  - **lat** (float) - Required - The latitude of the origin.
  - **long** (float) - Required - The longitude of the origin.
  - **address** (string) - Required - The origin address string.
- **destination** (object) - Required - The destination coordinates and address.
  - **lat** (float) - Required - The latitude of the destination.
  - **long** (float) - Required - The longitude of the destination.
  - **address** (string) - Required - The destination address string.
- **weight** (integer) - Required - The weight of the package in kilograms.
- **vehicle** (string) - Required - The type of vehicle (e.g., "motor", "car").
- **timezone** (string) - Optional - The timezone of the location (e.g., "WIB").

### Request Example
```bash
curl --location 'https://tdev.kiriminaja.com/api/mitra/v4/instant/pricing' \
  --header 'Authorization: Bearer {api_key}' \
  --header 'Content-Type: application/json' \
  --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"
  }'
```

### Response
#### Success Response (200)
- **status** (boolean) - Indicates if the request was successful.
- **text** (string) - A message describing the result of the request.
- **method** (string) - The name of the method called.
- **result** (array) - An array of courier pricing objects.
  - **name** (string) - The name of the courier.
  - **costs** (array) - An array of cost options for the courier.
    - **service_type** (string) - The type of service (e.g., "instant", "sameday").
    - **estimation** (string) - The estimated delivery time.
    - **price** (object) - The pricing details.
      - **admin_fee** (integer) - The administrative fee.
      - **shipping_costs** (integer) - The base shipping cost.
      - **total_price** (integer) - The total price including fees.
  - **insurances** (array) - An array of available insurance options.
    - **value** (integer) - The value of the insurance.
    - **type** (string) - The type of insurance (e.g., "silver", "gold").

#### Response Example
```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 } }
      ]
    }
  ]
}
```
```

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

### Get Instant Delivery Rates

Source: https://context7.com/kiriminaja/docs/llms.txt

Obtain pricing for instant delivery couriers (GoSend, Borzo, Grab Express) using GPS coordinates. Supports both motor and car vehicle types. The response includes service details, estimated delivery times, and pricing.

```bash
curl --location 'https://tdev.kiriminaja.com/api/mitra/v4/instant/pricing' \
  --header 'Authorization: Bearer {api_key}' \
  --header 'Content-Type: application/json' \
  --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" 
  }'
```

```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 } }
      ]
    }
  ]
}
```

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

### Get Payment / QRIS API Request and Response

Source: https://context7.com/kiriminaja/docs/llms.txt

This cURL command demonstrates how to request a QRIS payment token using a payment ID. The response includes payment details, status, and the QR content.

```bash
curl --location 'https://tdev.kiriminaja.com/api/mitra/v2/get_payment' \
  --header 'Authorization: Bearer {api_key}' \
  --header 'Content-Type: application/json' \
  --data '{ "payment_id": "EPR-123456789" }'
```

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

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

### Get Express Shipping Rates

Source: https://context7.com/kiriminaja/docs/llms.txt

Retrieve available courier rates for a specified origin and destination pair, along with package dimensions. Weight is in grams, and volumetric weight is calculated automatically. Save the 'cost' and 'service_type' for order creation.

```bash
curl --location 'https://tdev.kiriminaja.com/api/mitra/v6.1/shipping_price' \
  --header 'Authorization: Bearer {api_key}' \
  --header 'Content-Type: application/json' \
  --data '{ 
    "origin": 5783, 
    "subdistrict_origin": 31532, 
    "destination": 5507, 
    "subdistrict_destination": 65005, 
    "weight": 322, 
    "length": 10, 
    "width": 10, 
    "height": 10, 
    "item_value": "149990", 
    "insurance": 1, 
    "courier": ["jne"] 
  }'
```

```json
{
  "status": true,
  "method": "shipping_price",
  "text": "Success",
  "results": [
    {
      "service": "jne",
      "service_name": "JNE Express Reguler",
      "service_type": "REG23",
      "cost": "12000",
      "etd": "2-3",
      "cod": true,
      "group": "regular",
      "drop": true,
      "setting": {
        "cod_fee": "0.03",
        "minimum_cod_fee": "2500",
        "insurance_fee": "0.002",
        "cod_fee_amount": 5466
      },
      "insurance": 2500,
      "discount_amount": 360
    }
  ]
}
```

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

### Create Instant Order

Source: https://context7.com/kiriminaja/docs/llms.txt

Create an on-demand instant delivery order using services like GoSend, Borzo, or Grab Express. This endpoint requires GPS coordinates for origin and destination and returns the AWB and a live polyline for route rendering.

```bash
curl --location 'https://tdev.kiriminaja.com/api/mitra/v4/instant/pickup/request' \
  --header 'Authorization: Bearer {api_key}' \
  --header 'Content-Type: application/json' \
  --data '{ 
    "service": "gosend",
    "service_type": "instant",
    "vehicle": "motor",
    "order_prefix": "BDI",
    "packages": [
      {
        "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": "Dekat Kantor",
        "destination_name": "Okka Syahputra",
        "destination_phone": "081280045616",
        "destination_lat": -7.776192418965594,
        "destination_long": 110.32505379554323,
        "destination_address": "Godean, Sidoarum, Sleman",
        "destination_address_note": "Ring road utara",
        "shipping_price": 34000,
        "item": {
          "name": "Barang 1",
          "description": "Barang 1 Description",
          "price": 20000,
          "weight": 1000
        }
      }
    ]
  }'
```

```json
{
  "status": true,
  "text": "success",
  "result": {
    "payment": { "payment_id": "PID-1736406074", "amount": 34000, "status_code": "Pembayaran berhasil" },
    "packages": [
      {
        "awb": "GK-11-3177494",
        "order_id": "BDI-1736406073777",
        "service": "gosend",
        "service_type": "instant",
        "status": 105,
        "live_track_url": null,
        "origin": { "name": "Rizky Syahputra", "phone": "081280045616", "lat_long": "-7.8545847964179,110.3311544443" },
        "destination": { "name": "Okka Syahputra", "phone": "081280045616", "lat_long": "-7.7761924189656,110.32505379554" }
      }
    ]
  }
}
```

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

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

### Get Courier Services

Source: https://github.com/kiriminaja/docs/blob/subm/docs/8.others/2.courier-detail.md

This endpoint retrieves a list of services offered by a specific courier. You need to provide the `courier_code` in the request body.

```APIDOC
## POST /api/mitra/courier_services

### Description
Retrieves a list of services offered by a specific courier.

### Method
POST

### Endpoint
/api/mitra/courier_services

### Parameters
#### Request Body
- **courier_code** (string) - Required - The code of the courier for which to retrieve services.

### Request Example
```json
{
  "courier_code": "jne"
}
```

### Response
#### Success Response (200)
- **status** (boolean) - Indicates if the request was successful.
- **method** (string) - The method called.
- **text** (string) - A message indicating the status of the data loading.
- **datas** (array) - An array of courier service objects.
  - **name** (string) - The name of the service.
  - **code** (string) - The unique code for the service.
  - **cut_off_time** (string) - The cut-off time for the service, or null if not applicable.
  - **volumetrik** (string) - The volumetric weight factor.
  - **rounded** (number) - Rounded value, possibly related to pricing or dimensions.
  - **courier_group** (string) - The group the courier service belongs to (e.g., regular, economy, cargo).

### Response Example
```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"
    }
  ]
}
```
```

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

### Create Instant Order

Source: https://context7.com/kiriminaja/docs/llms.txt

Creates an on-demand instant delivery order via GoSend, Borzo, or Grab Express using GPS coordinates. Returns AWB and live polyline for route rendering.

```APIDOC
## POST /api/mitra/v4/instant/pickup/request

### Description
Creates an on-demand instant delivery order using specified courier services and GPS coordinates.

### Method
POST

### Endpoint
https://tdev.kiriminaja.com/api/mitra/v4/instant/pickup/request

### Parameters
#### Request Body
- **service** (string) - Required - The courier service to use (e.g., 'gosend', 'borzo', 'grab').
- **service_type** (string) - Required - The type of service (e.g., 'instant').
- **vehicle** (string) - Required - The vehicle type (e.g., 'motor').
- **order_prefix** (string) - Required - A prefix for the order ID.
- **packages** (array) - Required - An array of package details.
  - **origin_name** (string) - Required - The sender's name.
  - **origin_phone** (string) - Required - The sender's phone number.
  - **origin_lat** (number) - Required - The sender's latitude.
  - **origin_long** (number) - Required - The sender's longitude.
  - **origin_address** (string) - Required - The sender's address.
  - **origin_address_note** (string) - Optional - Additional notes for the origin address.
  - **destination_name** (string) - Required - The recipient's name.
  - **destination_phone** (string) - Required - The recipient's phone number.
  - **destination_lat** (number) - Required - The recipient's latitude.
  - **destination_long** (number) - Required - The recipient's longitude.
  - **destination_address** (string) - Required - The recipient's address.
  - **destination_address_note** (string) - Optional - Additional notes for the destination address.
  - **shipping_price** (integer) - Required - The shipping price.
  - **item** (object) - Required - Details about the item being shipped.
    - **name** (string) - Required - The item name.
    - **description** (string) - Required - The item description.
    - **price** (integer) - Required - The item price.
    - **weight** (integer) - Required - The item weight in grams.

### Request Example
```json
{
  "service": "gosend",
  "service_type": "instant",
  "vehicle": "motor",
  "order_prefix": "BDI",
  "packages": [
    {
      "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": "Dekat Kantor",
      "destination_name": "Okka Syahputra",
      "destination_phone": "081280045616",
      "destination_lat": -7.776192418965594,
      "destination_long": 110.32505379554323,
      "destination_address": "Godean, Sidoarum, Sleman",
      "destination_address_note": "Ring road utara",
      "shipping_price": 34000,
      "item": {
        "name": "Barang 1",
        "description": "Barang 1 Description",
        "price": 20000,
        "weight": 1000
      }
    }
  ]
}
```

### Response
#### Success Response (200)
- **status** (boolean) - Indicates if the request was successful.
- **text** (string) - A message describing the result of the request.
- **result** (object) - Contains the details of the instant order.
  - **payment** (object) - Payment details.
    - **payment_id** (string) - The payment ID.
    - **amount** (integer) - The payment amount.
    - **status_code** (string) - The payment status code.
  - **packages** (array) - An array of package details.
    - **awb** (string) - The Air Waybill number.
    - **order_id** (string) - The order ID.
    - **service** (string) - The shipping service used.
    - **service_type** (string) - The shipping service type.
    - **status** (integer) - The status code for the package.
    - **live_track_url** (string|null) - The live tracking URL, if available.
    - **origin** (object) - Origin details.
      - **name** (string) - Sender's name.
      - **phone** (string) - Sender's phone number.
      - **lat_long** (string) - Sender's latitude and longitude.
    - **destination** (object) - Destination details.
      - **name** (string) - Recipient's name.
      - **phone** (string) - Recipient's phone number.
      - **lat_long** (string) - Recipient's latitude and longitude.

#### Response Example
```json
{
  "status": true,
  "text": "success",
  "result": {
    "payment": { "payment_id": "PID-1736406074", "amount": 34000, "status_code": "Pembayaran berhasil" },
    "packages": [
      {
        "awb": "GK-11-3177494",
        "order_id": "BDI-1736406073777",
        "service": "gosend",
        "service_type": "instant",
        "status": 105,
        "live_track_url": null,
        "origin": { "name": "Rizky Syahputra", "phone": "081280045616", "lat_long": "-7.8545847964179,110.3311544443" },
        "destination": { "name": "Okka Syahputra", "phone": "081280045616", "lat_long": "-7.7761924189656,110.32505379554" }
      }
    ]
  }
}
```

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

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

### Get Courier Groups

Source: https://github.com/kiriminaja/docs/blob/subm/docs/8.others/1.courier-group-list.md

This endpoint allows you to retrieve a list of all available courier groups. The response includes details such as the code and name for each group.

```APIDOC
## POST /api/mitra/couriers_group

### Description
Retrieves a list of courier groups available in the system.

### Method
POST

### Endpoint
/api/mitra/couriers_group

### Response
#### Success Response (200)
- **status** (boolean) - Indicates if the request was successful.
- **method** (string) - The name of the method called.
- **text** (string) - A message indicating the status of the data loading.
- **datas** (array) - An array of courier group objects.
  - **code** (string) - The unique code for the courier group.
  - **name** (string) - The display name of the courier group.

### Response Example
```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"
    }
  ]
}
```
```

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

### Get Districts

Source: https://github.com/kiriminaja/docs/blob/subm/docs/2.coverage-area/2.district.md

Retrieve a list of districts based on the provided City ID. This endpoint is used to fetch all available districts for a specific city.

```APIDOC
## POST /api/mitra/kecamatan

### Description
Retrieves a list of districts for a given city ID. This is useful for determining service availability and operational areas.

### Method
POST

### Endpoint
/api/mitra/kecamatan

### Parameters
#### Request Body
- **kabupaten_id** (int) - Required - The ID of the city for which to retrieve districts.

### Request Example
```json
{
  "kabupaten_id": 419
}
```

### Response
#### Success Response (200)
- **status** (boolean) - Indicates if the request was successful.
- **method** (string) - The name of the method called.
- **text** (string) - A message indicating the result of the operation.
- **datas** (array) - A list of district objects.
  - **id** (int) - The unique identifier for the district.
  - **kecamatan_name** (string) - The name of the district.
  - **kabupaten_id** (int) - The ID of the city this district belongs to.

#### Response Example
```json
{
  "status": true,
  "method": "kecamatans",
  "text": "Berhasil",
  "datas": [
    {
      "id": 5779,
      "kecamatan_name": "Berbah",
      "kabupaten_id": 419
    },
    {
      "id": 5780,
      "kecamatan_name": "Cangkringan",
      "kabupaten_id": 419
    }
  ]
}
```
```

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

### Track Instant Order with cURL

Source: https://context7.com/kiriminaja/docs/llms.txt

Use this cURL command to track instant delivery orders. It serves as a fallback for webhook notifications. Ensure you replace `{api_key}` with your actual API key.

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