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 (Express Delivery)

POST
/tariff/express
This API calculates and retrieves available courier services and shipping costs for Express deliveries based on the origin, destination, and item details. It now supports Cash on Delivery (COD) and insurance options.

Main Request Fields#

Property NameData TypeRequiredNotes
originNumberYesID of the origin region (subdistrict).
destinationNumberYesID of the destination region (subdistrict).
itemsArray<Object>YesList of items in the shipment. See items object structure below.
codStringNoIndicates if COD is requested. Allowed values: "0" (No) or "1" (Yes).
insuranceStringNoIndicates if insurance is requested. Allowed values: "0" (No) or "1" (Yes).
cod_amountNumberNoCustom COD amount. If provided, this value overrides the item value calculation.

items Object Fields#

Property NameData TypeRequiredNotes
nameStringYesName or description of the item.
weightNumberYesWeight of a single item in grams.
widthNumberYesWidth of a single item in centimeters.
heightNumberYesHeight of a single item in centimeters.
lengthNumberYesLength of a single item in centimeters.
quantityNumberYesNumber of items of this type.
valueNumberNoPrice of a single item. Required if cod or insurance is set to "1".

Response#

The API response provides a list of available courier services grouped by service type (e.g., nextday, regular, sameday).

Main Response Properties#

success: (Boolean) Indicates if the request was successful.
message: (String) Provides additional information or an error message.
data: (Object) Contains the shipping options.

data Object#

The data object contains the following properties, each an array of B2bCourierItem objects:
nextday
regular
sameday
cargo

B2bCourierItem Object#

Property NameData TypeDescription
courier_nameStringName of the courier (e.g., "AnterAja").
courier_codeStringUnique code for the courier (e.g., "anteraja").
dimensionStringThe final dimension of the package used for calculation.
serviceStringType of service (e.g., "Nextday").
code_serviceStringUnique code for the service (e.g., "ND").
mapping_serviceStringInternal service mapping (e.g., "nextday").
etdStringEstimated time of delivery (e.g., "1-1 Days").
base_tariffNumberBase shipping price.
discountNumberDiscount amount.
totalNumberFinal shipping price (base_tariff - discount + insurance_detail.insurance if insurance is enabled).
is_codBooleanIndicates if COD is available for this service.
is_pickupBooleanIndicates if pickup service is available.
is_dropoffBooleanIndicates if drop-off service is available.
weightNumberThe chargeable weight of the package in kilograms.
matrix_volume_weightNumberThe calculated volumetric weight.
actual_weightNumberThe actual weight of the package.
unit_weightStringUnit of weight ("kg" or "g").
cod_detailObjectDetails of the COD calculation. Only present if cod was requested and is available.
insurance_detailObjectDetails of the insurance calculation. Only present if insurance was requested.

CodDetail Object#

Property NameData TypeDescription
cod_feeNumberThe calculated COD fee.
cod_fee_percentNumberThe COD fee percentage used.
cod_billedNumberThe total amount billed for COD.
cod_disbursementNumberThe amount to be disbursed to the client.

InsuranceDetail Object#

Property NameData TypeDescription
insurance_percentNumberThe insurance premium percentage.
insurance_minimumNumberThe minimum insurance fee.
insuranceNumberThe calculated insurance fee.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/tariff/express' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic Og==' \
--data-raw '{ "origin": 3571020010,// id_region
    "destination": 3171020004,// id_region
    "cod": "1", //optional // 1 = Yes | 0 = No
    // "insurance":"1", //optional // 1 = Yes | 0 = No
    "items": [
      {
        "name": "Contoh Barang 1",
        "length": 10, //cm 
        "width": 10,  //cm
        "height": 10, //cm
        "weight": 5000, //gram
        "quantity": 1,
        "value":2000//optional
      },      {
        "name": "Contoh Barang 1",
        "length": 10, //cm 
        "width": 10,  //cm
        "height": 10, //cm
        "weight": 5000, //gram
        "quantity": 1,
        "value":2000//optional
      }
    ]
  }'
Response Response Example
200 - 200 - Works fine. (COD)
{
    "success": true,
    "message": "success",
    "data": {
        "nextday": [
            {
                "courier_name": "Paxel",
                "courier_code": "paxel",
                "dimension": "20x10x10",
                "service": "Nextday",
                "code_service": "NEXTDAY",
                "mapping_service": "nextday",
                "etd": "1 - 2 Days",
                "base_tariff": 27000,
                "discount": 540,
                "total": 27660,
                "is_cod": false,
                "is_pickup": true,
                "is_dropoff": false,
                "weight": 4,
                "matrix_volume_weight": 0.5,
                "actual_weight": 4,
                "unit_weight": "kg",
                "insurance_detail": {
                    "insurance_percent": 0.3,
                    "insurance_minimum": 0,
                    "insurance": 1200
                }
            }
        ],
        "regular": [
            {
                "courier_name": "JNT",
                "courier_code": "jnt",
                "dimension": "20x10x10",
                "service": "EZ",
                "code_service": "EZ",
                "mapping_service": "reguler",
                "etd": "2 - 3 Days",
                "base_tariff": 52000,
                "discount": 7800,
                "total": 45400,
                "is_cod": true,
                "is_pickup": true,
                "is_dropoff": false,
                "weight": 4,
                "matrix_volume_weight": 0.33,
                "actual_weight": 4,
                "unit_weight": "kg",
                "cod_detail": {
                    "cod_billed": 461511,
                    "cod_disbursement": 400000,
                    "cod_fee": 16111,
                    "cod_fee_percent": 3.5,
                    "cod_custom": 0,
                    "is_cod": true
                },
                "insurance_detail": {
                    "insurance_percent": 0.3,
                    "insurance_minimum": 0,
                    "insurance": 1200
                }
            },
            {
                "courier_name": "ID Express",
                "courier_code": "idx",
                "dimension": "20x10x10",
                "service": "Standard",
                "code_service": "STD",
                "mapping_service": "regular",
                "etd": "1 - 3 Days",
                "base_tariff": 58000,
                "discount": 11600,
                "total": 47600,
                "is_cod": true,
                "is_pickup": true,
                "is_dropoff": true,
                "weight": 4,
                "matrix_volume_weight": 0.33,
                "actual_weight": 4,
                "unit_weight": "kg",
                "cod_detail": {
                    "cod_billed": 463791,
                    "cod_disbursement": 400000,
                    "cod_fee": 16191,
                    "cod_fee_percent": 3.5,
                    "cod_custom": 0,
                    "is_cod": true
                },
                "insurance_detail": {
                    "insurance_percent": 0.3,
                    "insurance_minimum": 0,
                    "insurance": 1200
                }
            },
            {
                "courier_name": "AnterAja",
                "courier_code": "anteraja",
                "dimension": "20x10x10",
                "service": "Regular",
                "code_service": "REG",
                "mapping_service": "regular",
                "etd": "2-4 Day",
                "base_tariff": 70800,
                "discount": 3540,
                "total": 68460,
                "is_cod": false,
                "is_pickup": true,
                "is_dropoff": true,
                "weight": 4,
                "matrix_volume_weight": 0.33,
                "actual_weight": 4,
                "unit_weight": "kg",
                "insurance_detail": {
                    "insurance_percent": 0.3,
                    "insurance_minimum": 0,
                    "insurance": 1200
                }
            },
            {
                "courier_name": "Ninja",
                "courier_code": "ninja",
                "dimension": "20x10x10",
                "service": "Standard",
                "code_service": "Standard",
                "mapping_service": "regular",
                "etd": "1-3 Days",
                "base_tariff": 48000,
                "discount": 9600,
                "total": 41400,
                "is_cod": true,
                "is_pickup": false,
                "is_dropoff": false,
                "weight": 4,
                "matrix_volume_weight": 0.33,
                "actual_weight": 4,
                "unit_weight": "kg",
                "cod_detail": {
                    "cod_billed": 454959,
                    "cod_disbursement": 400000,
                    "cod_fee": 13559,
                    "cod_fee_percent": 3,
                    "cod_custom": 0,
                    "is_cod": true
                },
                "insurance_detail": {
                    "insurance_percent": 0.3,
                    "insurance_minimum": 3000,
                    "insurance": 3000
                }
            }
        ],
        "sameday": [],
        "cargo": [
            {
                "courier_name": "ID Express",
                "courier_code": "idx",
                "dimension": "20x10x10",
                "service": "Kargo",
                "code_service": "iDtruck",
                "mapping_service": "kargo",
                "etd": "3 - 5 Days",
                "base_tariff": 50000,
                "discount": 5000,
                "total": 46200,
                "is_cod": true,
                "is_pickup": false,
                "is_dropoff": false,
                "weight": 4,
                "matrix_volume_weight": 0.33,
                "actual_weight": 4,
                "unit_weight": "kg",
                "cod_detail": {
                    "cod_billed": 462340,
                    "cod_disbursement": 400000,
                    "cod_fee": 16140,
                    "cod_fee_percent": 3.5,
                    "cod_custom": 0,
                    "is_cod": true
                },
                "insurance_detail": {
                    "insurance_percent": 0.3,
                    "insurance_minimum": 0,
                    "insurance": 1200
                }
            },
            {
                "courier_name": "Ninja",
                "courier_code": "ninja",
                "dimension": "20x10x10",
                "service": "Cargo",
                "code_service": "Cargo",
                "mapping_service": "cargo",
                "etd": "1-3 Days",
                "base_tariff": 58300,
                "discount": 11660,
                "total": 49640,
                "is_cod": true,
                "is_pickup": false,
                "is_dropoff": false,
                "weight": 4,
                "matrix_volume_weight": 0.33,
                "actual_weight": 4,
                "unit_weight": "kg",
                "cod_detail": {
                    "cod_billed": 463454,
                    "cod_disbursement": 400000,
                    "cod_fee": 13814,
                    "cod_fee_percent": 3,
                    "cod_custom": 0,
                    "is_cod": true
                },
                "insurance_detail": {
                    "insurance_percent": 0.3,
                    "insurance_minimum": 3000,
                    "insurance": 3000
                }
            }
        ]
    },
    "timestamp": "2025-08-28T08:45:13.381Z"
}

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

🟢200200 - Works fine. (COD)
application/json
Body

🟠400400 - Bad request. Missing required parameters or parameters are not correct
🟠404404 - Not Found
🔴500500 - Internal Server Error
Modified at 2025-08-28 10:26:03
Previous
Check Tariff API
Next
Check Tariff (Instant Delivery)
Built with