Changelog V2

Search Region API

Renamed search field inside the JSON body to keyword.

Order Instant API

Updated field cod and cod_amount to be optional.

Order Express API

Removed field email on shipper and reciever object.

Updated max weight for different courier (documented on Order Express).

Check Tariff Instant API

Changed item field to be package field.

Inside the origin or destination object, id, lat, and lng are updated to be String.

Balance API

Added balance API to check current balance, pending balance, and balance history.

Global change (All APIs)

Added field timestamp into both successful and failed API responses.

Authentication now uses HTTP Basic Authentication.

Clients must set the Authorization header with a value of Basic <credentials>, where <credentials> is the Base64-encoded string of access_key:secret_key.

Updated All URL Path: https://docs.google.com/spreadsheets/d/1k5eUH2-KooVQ-TJY3rii6AVY4e0evv9ZKGeN6NHgSHI/

B2B Calculate Multi-Item API

Objective: Provides an endpoint for B2B clients to calculate volumetric and actual weight for multiple items in a single API call. This API returns the final dimensions of the optimized packing box and the chargeable weight based on rounding logic.

Endpoint: POST item/multi-items (under the B2B route prefix)

Authentication: HTTP Basic Authentication (same as other B2B APIs).

- Request Body :
    - `items`: Array of item objects, where each object contains:
      - `length` (number): Length of the item in cm.
      - `width` (number): Width of the item in cm.
      - `height` (number): Height of the item in cm.
      - `weight` (number): Weight of the item in grams.
      - `quantity` (number): Quantity of this item.
      - `name` (string): Name or description of the item.
    - `courier` (string): The courier to be used, which determines the volumetric division factor.

Note: length, width, height, and weight are provided for a single item. The system will calculate the total based on the quantity.

- Example Response:
        - {
        "success": true,
        "message": "success",
        "data": {
            "desc": "RMK-123- Qty: 1 | Washmachine Qty: 2", // description of the items
            "total_weight": 1400, // total weight of all items in grams
            "volumetric_weight": 20000, // volumetric weight of all items in grams
            "final_actual_weight": 25000, // final actual weight of all items in grams
            "suggested_optimal_volumetric": "100x50x30" // suggested optimal volumetric dimensions for the items
            }
        "timestamp": "2025-08-14T06:23:41.289Z"
    }

Note: final_actual_weight is used as the weight parameter in the tariff api
8. dimension item & order

Check Tariff Instant & Express: The 'items' field is now an array.

Check Tariff Response: Includes a 'dimension' field that must be passed in the Order payload.

Order Instant: Added an optional 'stop' object.

Order Express API: cod_amount is now optional. If cod_amount is set to 0, it will be treated the same as not using COD.

Order Express API: The response now includes a cod_detail object when using COD, which contains detailed information about the COD calculation.

Order Express API: For non-COD orders, the cod_detail object will not be included in the response.

Check Tariff API (Express)

Added optional cod and insurance fields to the request payload.

If cod is '1', the response will include a cod_detail object with the COD fee calculation.

If insurance is '1', the response will include an insurance_detail object with the insurance fee calculation.

Added optional value (number) field to each item in the items array. This is required if cod or insurance is true.

Added base_tariff (number) field which represents the base_tariff from courier.

Added discount (number) field which represents the discount provided by Fastrac.

Added total (number) field which represents the final price calculated from base_tariff minus discount plus insurance fee (if insurance is enabled).

Fastrac Status to Couriers Status Mapping#

Fastrac Status to Couriers Status Mapping