Get shipping cost quotes

get

https://api.orderonline.id/v1/shipping/cost

Quotes shipping cost per courier and service for a given origin, destination and package weight.

couriers must be a JSON-encoded array string of courier codes, e.g. ["jne","jnt"]. An empty array falls back to the platform default priority list (oexpress, jne, jnt, ninja, sap, idexpress, spx).
weight is in grams.
With payment_method=cod only COD-capable services are returned and COD fees apply.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

origin_id

integer

required

Origin subdistrict ID (see /v1/subdistricts).

destination_id

integer

required

Destination subdistrict ID.

couriers

json

required

JSON-encoded array of courier codes. Known codes: oexpress, jne, jnt, ninja, sap, idexpress, spx, sicepat.

weight

integer

required

≥ 1

Package weight in grams.

payment_method

string

enum

Defaults to bank_transfer

Payment method of the order being quoted. Affects COD fees and which services are offered.

Allowed:

volume

json

JSON-encoded volumetric dimensions in cm, used for volumetric weight by couriers that support it.

with_fallback

boolean

Defaults to true

Fall back to cached rates when a courier API is unreachable.

mode

string

Defaults to normal

Quote mode. Leave at the default unless instructed otherwise.

exclude_couriers

array of strings

Courier codes to exclude from couriers. Send as repeated exclude_couriers[]=jne query params.

exclude_couriers

origin_coordinate

string

lat,lng of the origin. Only used by distance-based couriers.

destination_coordinate

string

lat,lng of the destination. Only used by distance-based couriers.

ref

string

Free-text marker of who requested the quote. Logged only.

use_cache_header

boolean

Defaults to false

When true the response carries Cache-Control: max-age=300, must-revalidate and a Cache-Tag header.

Responses

200Quotes retrieved. data is an array of courier objects (may be empty if no courier serves the route).

400No courier could quote the route (e.g. subdistrict not covered). data is an empty string and message explains why.

401Unauthorized. Missing, invalid or expired JWT token.

422Validation failed. Body is a map of field name to list of messages (Lumen default), not the standard envelope.