FASTRAC-DOC-API V2 (B2B API STAGING)
  1. Check Tariff API
FASTRAC-DOC-API V2 (B2B API STAGING)
  • Overview
  • Changelog V2
  • Region API
    • Province
      GET
    • City
      GET
    • District
      GET
    • Sub-District
      GET
    • Post Code
      GET
    • Search Region
      POST
  • Courier API
    • All Courier
      GET
    • Courier Service
      GET
  • Check Tariff API
    • Check Tariff (Express Delivery)
      POST
    • Check Tariff (Instant Delivery)
      POST
    • Calculate Multi Items
      POST
  • Order API
    • Order Express
      POST
    • Order Instant
      POST
    • Cancel Order
      POST
    • Tracking Order
      GET
    • Item Categories
      GET
  • Webhook API
    • Example Webhook payload
    • Set Webhook
      POST
    • Get Webhook
      GET
  • User API
    • Balance History
      POST
  • API-Tariff
  • API-Order
  1. Check Tariff API

Check Tariff (Instant Delivery)

POST
/tariff/instant
This API calculates and retrieves real-time courier tariffs for instant delivery services based on sender, receiver, and optional stop point details. It considers package information (value, dimensions, weight, and quantity) and returns available courier options. Each courier option includes a tariff_id, which is valid for 5 minutes. This tariff_id can be used in the Order Instant API to place an order, ensuring the pricing and courier data remain consistent with the results from the tariff check request.

Main Request Fields#

Property NameData TypeRequiredNotes
originObjectYesOrigin address details. See table below.
destinationObjectYesDestination address details. See table below.
stopObjectNoOptional stop/waypoint details. See table below.
packageObjectYesPackage details. See table below.
vehicle_typeStringYesType of vehicle used for delivery. Allowed values: bike, sedan, mpv, van, truck175, truck330, engkelbak, engkelbox, cddbak, cddbox, fusobak, fusobox.

origin Object#

Property NameData TypeRequiredNotes
idStringYesThe subdistrict_id (from Post Code API or Subistrict API) or the id (from Search Region API).
latStringYesLatitude. Must be between -90 and 90.
lngStringYesLongitude. Must be between -180 and 180.
alamat_lengkapStringYesFull address text.
alamat_googleStringYesGoogle formatted address.

destination Object#

Property NameData TypeRequiredNotes
idStringYesThe subdistrict_id (from Post Code API or Subistrict API) or the id (from Search Region API).
latStringYesLatitude. Must be between -90 and 90.
lngStringYesLongitude. Must be between -180 and 180.
alamat_lengkapStringYesFull destination address.
alamat_googleStringYesDestination Google formatted address.

stop Object (Optional)#

Property NameData TypeRequiredNotes
idStringNoThe subdistrict_id (from Post Code API or Subistrict API) or the id (from Search Region API) for stop/waypoint.
latStringNoLatitude. Must be between -90 and 90.
lngStringNoLongitude. Must be between -180 and 180.
alamat_lengkapStringNoFull stop point address.
alamat_googleStringNoStop point Google formatted address.

package Object#

Property NameData TypeRequiredNotes
package_valueNumberYesTotal value of the package.
package_itemsArray<Object>YesList of items in the package. Each follows the structure below.

package_items Object#

Property NameData TypeRequiredNotes
nameStringYesName/description of the item.
lengthNumberYesLength of a single item in centimeters.
widthNumberYesWidth of a single item in centimeters.
heightNumberYesHeight of a single item in centimeters.
weightNumberYesWeight of a single item in grams.
quantityNumberYesNumber of this item in the shipment.

Explanation#

origin: Contains the origin's geographical and address information.
destination: Contains the destination's geographical and address information.
vehicle_type: Specifies the type of vehicle to be used for the delivery.
package: Contains details about the items being shipped.
stop: Optional field for an additional stop.

Response#

API Response Explanation#

The response is an array of available courier options.
[
  {
    "tariff_id": "018f3b7c-b868-763b-99d5-26b4f714b152",
    "nama_kurir": "GO-SEND",
    "kode_kurir": "gosend",
    "layanan": "Instant",
    "kode_service": "instant",
    "estimasi": "1-2 jam",
    "harga": 25000,
    "diskon_persen": 0,
    "diskon": 0,
    "harga_diskon": 25000,
    "is_cod": false,
    "is_pickup": true,
    "is_dropoff": true,
    "logo": "https://api.fastrac.id/assets/images/kurir/gosend.png",
    "logo_kotak": "https://api.fastrac.id/assets/images/kurir/kotak/gosend.png",
    "bg_color": "#00AA13",
    "quotation_id": "some-quotation-id",
    "stop_id_pengirim": "some-stop-id",
    "stop_id_penerima": "some-stop-id",
    "request_at": "2024-05-15T08:00:00.000Z"
  }
]

Response Properties#

tariff_id: A unique identifier for the tariff.
nama_kurir: The name of the courier company.
kode_kurir: The code for the courier company.
layanan: The type of service offered.
kode_service: The code for the service.
estimasi: The estimated time of delivery.
harga: The original price of the service.
diskon_persen: The discount percentage.
diskon: The discount amount.
harga_diskon: The price after the discount.
is_cod: A boolean indicating if Cash on Delivery is available.
is_pickup: A boolean indicating if pickup is available.
is_dropoff: A boolean indicating if drop-off is available.
logo: The URL of the courier's logo.
logo_kotak: The URL of the courier's box logo.
bg_color: The background color associated with the courier.
quotation_id: The ID for the quotation.
stop_id_pengirim: The stop ID for the sender.
stop_id_penerima: The stop ID for the receiver.
request_at: The timestamp of the request.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/tariff/instant' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic Og==' \
--data-raw '{
    "origin": {
        "id": "3171090001", // id_region
        "lat": "-6.231144", // range between -90 and 90
        "lng": "106.839824", // range between -180 and 180
        "alamat_lengkap": "Full address here",
        "alamat_google": "Google formatted address"
    },
    "destination": {
        "id": "3172060001", // id_region
        "lat": "-6.230059", // range between -90 and 90
        "lng": "106.866389", // range between -180 and 180
        "alamat_lengkap": "Destination full address",
        "alamat_google": "Destination google formatted address"
    },
    "stop": { //optinal
        "id": "3171080002", // id_region
        "lat": "-6.258761",// range between -90 and 90
        "lng": "106.854823", // range between -180 and 180
        "alamat_lengkap": "Stop point full address",
        "alamat_google": "Stop point google formatted address"
    },
    "package": {
        "package_value": 100000, //total value package
        "package_items": [
      {
        "name": "Contoh Barang 1",
        "length": 50, //cm 
        "width": 15,  //cm
        "height": 10, //cm
        "weight": 720, //gram
        "quantity": 1
      },
      {
        "name": "Contoh Barang 2",
        "length": 30, //cm
        "width": 20, //cm
        "height": 15, //cm
        "weight": 150, //gram
        "quantity": 2
      }
    ]
    }
    // "vehicle_type": "bike"
}'
Response Response Example
201 - 200 - Works fine.
{
    "success": true,
    "message": "success",
    "data": [
        {
            "tariff_id": "0198c17d-61cc-7136-b782-cfc6c0aa2986",
            "logo": "https://apps.fastrac.id/assets/images/logo_kurir/logo_lalamove.png",
            "logo_kotak": "https://apps.fastrac.id/assets/images/logo_kurir/logokotak_lalamove.png",
            "bg_color": "ee5223",
            "dimension": "30x30x50",
            "kurir": "LalaMove",
            "kode_kurir": "lalamove",
            "kode_service": "MOTORCYCLE",
            "service": "LALAMOVE: MOTOR",
            "berat_max": "Maks.20 Kg",
            "estimasi": "Etd: 1-2 Jam",
            "harga": 24100,
            "diskon_persen": 2,
            "diskon": 482,
            "total": 23618,
            "is_cod": false,
            "mapping": "instant",
            "quotation_id": "3300849797472616621",
            "stop_id_pengirim": "3300891040692994144",
            "stop_id_penerima": "3300891040692994145",
            "stop_id_penerima_2": "3300891040692994146",
            "request_at": "2025-08-19 08:41:16"
        }
    ],
    "timestamp": "2025-08-19T08:41:16.532Z"
}

Request

Authorization
Send your HTTP requests with an
Authorization
header that contains the word Basic followed by a space and a base64-encoded string username:password
Example:
Authorization: Basic *****************
Body Params application/json

Examples

Responses

🟢201200 - Works fine.
application/json
Body

🟠400400 - Bad request. Missing required parameters or parameters are not correct
🟠404404 - Not Found
Modified at 2025-08-28 10:25:44
Previous
Check Tariff (Express Delivery)
Next
Calculate Multi Items
Built with