curl --request POST \
  --url https://api.bitbybit.studio/customer/api/open/v1/shipping/calculate-fee \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "provider": "gosend",
  "origin": {
    "lat": -6.2087,
    "lng": 106.8456
  },
  "destination": {
    "lat": -6.1751,
    "lng": 106.865
  },
  "package": {
    "weight": 1500
  }
}
'

{
  "data": {
    "provider": "gosend",
    "currency": "IDR",
    "options": [
      {
        "serviceCode": "Instant",
        "serviceName": "GoSend Instant",
        "serviceType": "INSTANT",
        "courierGroup": null,
        "price": 28000,
        "currency": "IDR",
        "estimatedDelivery": null,
        "raw": {}
      },
      {
        "serviceCode": "SameDay",
        "serviceName": "GoSend Same Day",
        "serviceType": "EXPRESS",
        "courierGroup": null,
        "price": 18000,
        "currency": "IDR",
        "estimatedDelivery": null,
        "raw": {}
      }
    ]
  }
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "origin.districtId is required for KiriminAja Express"
  }
}

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid API key"
  }
}

Shipping

Calculate shipping fee

Quote one or more service options for a given pickup → drop-off route, using a unified request shape regardless of provider.

Per-provider requirements

gosend — origin.{lat,lng} and destination.{lat,lng} only. options.paymentType defaults to 3 (GoPay corporate). Returns the four GoSend service tiers (Instant, SameDay, InstantCar, SameDayCar).
kirimin_aja — choose options.serviceType:
- EXPRESS (default): requires origin.districtId + destination.districtId (look them up with /shipping/coverage/districts). options.courier defaults to all 12 supported couriers; pass a subset to narrow the quote. options.insurance: true includes insurance pricing.
- INSTANT: requires geocoded coordinates plus addresses. options.instantServices defaults to ['gosend','borzo','grab_express']; options.vehicleType chooses TWO_WHEEL (motor) vs FOUR_WHEEL (mobil).
ride_blitz — options.pickupCity is required and must be one of the 46 allowed cities returned by GET /shipping/coverage/cities?provider=ride_blitz. options.rideBlitzServiceTypes defaults to all four tiers (instant_1_hour … instant_4_hours); each tier is quoted in parallel. options.bikeFuelType toggles regular vs green (electric).

Response shape is the same for every provider — an array of options with serviceCode, serviceName, price, currency, plus the raw provider payload under raw for advanced cases.

POST

shipping

calculate-fee

curl --request POST \
  --url https://api.bitbybit.studio/customer/api/open/v1/shipping/calculate-fee \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "provider": "gosend",
  "origin": {
    "lat": -6.2087,
    "lng": 106.8456
  },
  "destination": {
    "lat": -6.1751,
    "lng": 106.865
  },
  "package": {
    "weight": 1500
  }
}
'

{
  "data": {
    "provider": "gosend",
    "currency": "IDR",
    "options": [
      {
        "serviceCode": "Instant",
        "serviceName": "GoSend Instant",
        "serviceType": "INSTANT",
        "courierGroup": null,
        "price": 28000,
        "currency": "IDR",
        "estimatedDelivery": null,
        "raw": {}
      },
      {
        "serviceCode": "SameDay",
        "serviceName": "GoSend Same Day",
        "serviceType": "EXPRESS",
        "courierGroup": null,
        "price": 18000,
        "currency": "IDR",
        "estimatedDelivery": null,
        "raw": {}
      }
    ]
  }
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "origin.districtId is required for KiriminAja Express"
  }
}

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid API key"
  }
}

Authorizations

x-api-key

string

header

required

API key for authentication. Create one in Settings > Developer. The key must have the BITCRM product scope and an orders resource scope; required action depends on the endpoint (READ, WRITE, or DELETE).

Body

application/json

provider

enum<string>

required

Available options:

gosend,

kirimin_aja,

ride_blitz

origin

object

required

Show child attributes

destination

object

required

Show child attributes

package

object

required

Show child attributes

options

object

Per-provider tuning. See endpoint description for which fields apply to which provider.

Show child attributes

Response

Quote successful.

data

object

Show child attributes

Getting Started

Customers

Loyalty (bitLogin)

Loyalty (Customer)

Orders

Shipping

Products

Messaging

Analytics

Webhooks

Calculate shipping fee

Authorizations

Body

Response