Courier Rates V1
Calculate shipping costs between Indonesian villages.
Base URL
https://use.api.co.id
Send the origin & destination village codes and the package weight with the x-api-co-id header. The response contains the available courier options with pricing and delivery time estimates.
A new version is available: Courier Rates V2 uses district codes and returns a
quote_id. Use V2 for new integrations.
Features
- Calculate shipping costs between villages.
- Multiple courier options (JNE, SiCepat, SAP, etc.).
- Automatic caching for faster responses.
- Weight-based pricing.
- Delivery time estimation.
- Zero-price couriers are filtered out.
Village codes
Village codes (10 digits) can be found using the Api Regional Wilayah Indonesia. Use the /regional/indonesia/villages endpoint to search for villages and get their codes.
Requirements
- Weight must be greater than 0.
Get Shipping Cost
Calculate shipping cost from origin village to destination village.
### Query Parameters
- origin_village_code (required): Origin village code (10 digits)
- destination_village_code (required): Destination village code (10 digits)
- weight (required): Package weight in kilograms (must be greater than 0)
### Finding Village Codes
Village codes can be found using the Api Regional Wilayah Indonesia. Use the /regional/indonesia/villages endpoint to search for villages and get their 10-digit codes.
### Response Returns available courier options with: - Courier code and name - Shipping price - Weight - Delivery time estimation - Only couriers with price > 0 are returned
### Notes - Zero-price couriers are automatically filtered out
| Name | Type | Description |
|---|---|---|
origin_village_codeRequired | string | Origin village code - Pademangan, Jakarta (10 digits). Find village codes at https://api.co.id/indonesia-regional-api/ Example: 3172051003 |
destination_village_codeRequired | string | Destination village code - Bojongloa, Rancaecek, Bandung (10 digits). Find village codes at https://api.co.id/indonesia-regional-api/ Example: 3204282004 |
weightRequired | number | Package weight in kilograms (must be > 0) Example: 1 |
| Name | Type | Description |
|---|---|---|
statusOptional | string | Example: success |
timestampOptional | string | Example: 2026-02-13 15:49:20 |
resultOptional | object[] | |
result[].courier_codeOptional | string | Example: JNE |
result[].courier_nameOptional | string | Example: JNE Express |
result[].priceOptional | number | Example: 12000 |
result[].weightOptional | number | Example: 1 |
result[].estimationOptional | string | Example: 1 - 2 days |
curl -X GET "https://use.api.co.id/expedition/shipping-cost?origin_village_code=3172051003&destination_village_code=3204282004&weight=1" \ -H "x-api-co-id: $API_CO_ID_KEY"{ "status": "success", "timestamp": "2026-02-13 15:49:20", "result": [ { "courier_code": "JNE", "courier_name": "JNE Express", "price": 12000, "weight": 1, "estimation": "1 - 2 days" }, { "courier_code": "JNECargo", "courier_name": "JNE Cargo", "price": 45000, "weight": 1, "estimation": "1 - 2 days" }, { "courier_code": "SiCepat", "courier_name": "SiCepat Express", "price": 11000, "weight": 1, "estimation": "2 - 3 Days" }, { "courier_code": "SiCepatCargo", "courier_name": "SiCepat Cargo", "price": 40000, "weight": 1, "estimation": "2 - 3 Days" }, { "courier_code": "SAP", "courier_name": "SAP Express", "price": 10500, "weight": 1, "estimation": "2 - 4 days" }, { "courier_code": "SAPLite", "courier_name": "SAP Lite", "price": 11500, "weight": 1, "estimation": "2 - 4 days" }, { "courier_code": "SapCargo", "courier_name": "SAP Cargo", "price": 35000, "weight": 1, "estimation": "2 - 4 days" }, { "courier_code": "iDexpress", "courier_name": "iDexpress", "price": 9000, "weight": 1, "estimation": null }, { "courier_code": "iDlite", "courier_name": "iDlite", "price": 9000, "weight": 1, "estimation": null }, { "courier_code": "JT", "courier_name": "J&T Express", "price": 11000, "weight": 1, "estimation": null }, { "courier_code": "lion", "courier_name": "Lion Parcel", "price": 13020, "weight": 1, "estimation": "2 - 3 Hari" }, { "courier_code": "iDexpressCargo", "courier_name": "iDexpress Cargo", "price": 35000, "weight": 1, "estimation": null }, { "courier_code": "anteraja", "courier_name": "AnterAja", "price": 14200, "weight": 1, "estimation": "1-2 Day" }, { "courier_code": "paxel", "courier_name": "Paxel", "price": 0, "weight": 1, "estimation": null }, { "courier_code": "Ninja", "courier_name": "Ninja Express", "price": 11000, "weight": 1, "estimation": null } ]}