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

List sub-districts

List shipments