{"info":{"_postman_id":"447b846f-e0a6-4494-b2a7-dc63af4881d2","name":"Expedition API","description":"

Complete API collection for shipping cost calculation between Indonesian villages.

Features

Calculate shipping costs between villages
\n
Multiple courier options (JNE, SiCepat, SAP, etc.)
\n
Automatic caching for faster responses
\n
Weight-based pricing
\n
Delivery time estimation
\n
Zero-price courier filtering
\n

Authentication

All requests require an API key in the x-api-co-id header.

Base URL

https://use.api.co.id/expedition\n\n

Village Codes

Village codes can be found using the Indonesia Regional API. Use the /regional/indonesia/villages endpoint to search for villages and get their 10-digit codes.

Requirements

Weight must be greater than 0

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"50289783","collectionId":"447b846f-e0a6-4494-b2a7-dc63af4881d2","publishedId":"2sBXVZpuek","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-12-26T13:15:08.000Z"},"item":[{"name":"Shipping Cost","item":[{"name":"Get Shipping Cost - Pademangan Jakarta to Rancaekek Bandung","id":"fa6d93c1-4f36-443b-ba47-85778b736813","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","description":"

Your API key for authentication

\n","type":"text"}],"url":"https://use.api.co.id/expedition/shipping-cost?origin_village_code=3172051003&destination_village_code=3204282004&weight=1","description":"

Calculate shipping cost from Pademangan, Jakarta to Rancabali, Bandung.

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 Indonesia Regional API. 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

Both villages must have courier_id set
Response is cached for faster subsequent requests
Zero-price couriers are automatically filtered out

\n","urlObject":{"path":["expedition","shipping-cost"],"host":["https://use.api.co.id"],"query":[{"description":{"content":"

Origin village code - Pademangan, Jakarta (10 digits). Find village codes at https://api.co.id/indonesia-regional-api/

\n","type":"text/plain"},"key":"origin_village_code","value":"3172051003"},{"description":{"content":"

Destination village code - Rancabali, Bandung (10 digits). Find village codes at https://api.co.id/indonesia-regional-api/

\n","type":"text/plain"},"key":"destination_village_code","value":"3204282004"},{"description":{"content":"

Package weight in kilograms (must be > 0)

\n","type":"text/plain"},"key":"weight","value":"1"}],"variable":[]}},"response":[{"id":"a513bc4c-2852-4b4d-82a4-bfbbc5604ad0","name":"Success - Pademangan Jakarta to Rancabali Bandung","originalRequest":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"url":{"raw":"https://use.api.co.id/expedition/shipping-cost?origin_village_code=3172051003&destination_village_code=3204402005&weight=1","host":["https://use.api.co.id"],"path":["expedition","shipping-cost"],"query":[{"key":"origin_village_code","value":"3172051003"},{"key":"destination_village_code","value":"3204402005"},{"key":"weight","value":"1"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": true,\n \"message\": \"Success\",\n \"data\": {\n \"origin_village_code\": \"3172051003\",\n \"destination_village_code\": \"3204402005\",\n \"weight\": 1,\n \"couriers\": [\n {\n \"courier_code\": \"JNE\",\n \"courier_name\": \"JNE Express\",\n \"price\": 8000,\n \"weight\": 1,\n \"estimation\": \"2 - 3 days\"\n },\n {\n \"courier_code\": \"JNECargo\",\n \"courier_name\": \"JNE Cargo\",\n \"price\": 55000,\n \"weight\": 1,\n \"estimation\": \"2 - 3 days\"\n },\n {\n \"courier_code\": \"SAP\",\n \"courier_name\": \"SAP Express\",\n \"price\": 12000,\n \"weight\": 1,\n \"estimation\": \"3 - 5 days\"\n },\n {\n \"courier_code\": \"SAPLite\",\n \"courier_name\": \"SAP Lite\",\n \"price\": 12000,\n \"weight\": 1,\n \"estimation\": \"3 - 5 days\"\n },\n {\n \"courier_code\": \"SapCargo\",\n \"courier_name\": \"SAP Cargo\",\n \"price\": 45000,\n \"weight\": 1,\n \"estimation\": \"3 - 5 days\"\n },\n {\n \"courier_code\": \"JT\",\n \"courier_name\": \"J&T Express\",\n \"price\": 13000,\n \"weight\": 1,\n \"estimation\": null\n },\n {\n \"courier_code\": \"lion\",\n \"courier_name\": \"Lion Parcel\",\n \"price\": 62330,\n \"weight\": 1,\n \"estimation\": \"4 - 6 Hari\"\n },\n {\n \"courier_code\": \"Ninja\",\n \"courier_name\": \"Ninja Express\",\n \"price\": 23000,\n \"weight\": 1,\n \"estimation\": null\n }\n ]\n }\n}"}],"_postman_id":"fa6d93c1-4f36-443b-ba47-85778b736813"},{"name":"Error - Missing Parameters","id":"d2b9ac1f-b634-46fb-865a-96c8eaa88935","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"url":"https://use.api.co.id/expedition/shipping-cost","description":"

Example error response when required parameters are missing.

\n","urlObject":{"path":["expedition","shipping-cost"],"host":["https://use.api.co.id"],"query":[],"variable":[]}},"response":[{"id":"5616bd88-9a7a-44c9-94fc-0122df8ca86d","name":"Error - Missing Parameters","originalRequest":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"url":"https://use.api.co.id/expedition/shipping-cost"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": false,\n \"message\": \"origin_village_code is required\"\n}"}],"_postman_id":"d2b9ac1f-b634-46fb-865a-96c8eaa88935"},{"name":"Error - Invalid Weight","id":"5d2edf86-b478-4f4e-8718-c231ed2177de","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"url":"https://use.api.co.id/expedition/shipping-cost?origin_village_code=3172051003&destination_village_code=3204402005&weight=0","description":"

Example error response when weight is invalid (must be greater than 0).

\n","urlObject":{"path":["expedition","shipping-cost"],"host":["https://use.api.co.id"],"query":[{"key":"origin_village_code","value":"3172051003"},{"key":"destination_village_code","value":"3204402005"},{"description":{"content":"

Invalid weight (must be > 0)

\n","type":"text/plain"},"key":"weight","value":"0"}],"variable":[]}},"response":[{"id":"c30ad47e-e24f-4fbb-b79c-fe96fd00142d","name":"Error - Invalid Weight","originalRequest":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"url":{"raw":"https://use.api.co.id/expedition/shipping-cost?origin_village_code=3172051003&destination_village_code=3204402005&weight=0","host":["https://use.api.co.id"],"path":["expedition","shipping-cost"],"query":[{"key":"origin_village_code","value":"3172051003"},{"key":"destination_village_code","value":"3204402005"},{"key":"weight","value":"0"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": false,\n \"message\": \"weight must be greater than 0\"\n}"}],"_postman_id":"5d2edf86-b478-4f4e-8718-c231ed2177de"},{"name":"Error - Village Not Found","id":"b07ef8a7-ce46-4a1e-a8fe-4f928b625727","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"url":"https://use.api.co.id/expedition/shipping-cost?origin_village_code=9999999999&destination_village_code=3204402005&weight=1","description":"

Example error response when village code is not found in the database. Find valid village codes at https://api.co.id/indonesia-regional-api/

\n","urlObject":{"path":["expedition","shipping-cost"],"host":["https://use.api.co.id"],"query":[{"description":{"content":"

Invalid village code. Find valid village codes at https://api.co.id/indonesia-regional-api/

\n","type":"text/plain"},"key":"origin_village_code","value":"9999999999"},{"key":"destination_village_code","value":"3204402005"},{"key":"weight","value":"1"}],"variable":[]}},"response":[{"id":"8d1ad65d-d3c7-4c49-8b6b-3443e47488a9","name":"Error - Village Not Found","originalRequest":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"url":{"raw":"https://use.api.co.id/expedition/shipping-cost?origin_village_code=9999999999&destination_village_code=3204402005&weight=1","host":["https://use.api.co.id"],"path":["expedition","shipping-cost"],"query":[{"key":"origin_village_code","value":"9999999999"},{"key":"destination_village_code","value":"3204402005"},{"key":"weight","value":"1"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": false,\n \"message\": \"From village not found\"\n}"}],"_postman_id":"b07ef8a7-ce46-4a1e-a8fe-4f928b625727"},{"name":"Error - Village Not Supported","id":"636b9866-fabb-45de-b128-f44df7c6101a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"url":"https://use.api.co.id/expedition/shipping-cost?origin_village_code=1101010001&destination_village_code=3204402005&weight=1","description":"

Example error response when village doesn't have courier_id set (village not supported yet).

\n","urlObject":{"path":["expedition","shipping-cost"],"host":["https://use.api.co.id"],"query":[{"description":{"content":"

Village code without courier_id. Find village codes at https://api.co.id/indonesia-regional-api/

\n","type":"text/plain"},"key":"origin_village_code","value":"1101010001"},{"key":"destination_village_code","value":"3204402005"},{"key":"weight","value":"1"}],"variable":[]}},"response":[{"id":"0d5f1f9e-be88-4936-a3ed-f9e89ea0738f","name":"Error - Village Not Supported","originalRequest":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"url":{"raw":"https://use.api.co.id/expedition/shipping-cost?origin_village_code=1101010001&destination_village_code=3204402005&weight=1","host":["https://use.api.co.id"],"path":["expedition","shipping-cost"],"query":[{"key":"origin_village_code","value":"1101010001"},{"key":"destination_village_code","value":"3204402005"},{"key":"weight","value":"1"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": false,\n \"message\": \"This village was not supported yet, please open ticket to activate this village\"\n}"}],"_postman_id":"636b9866-fabb-45de-b128-f44df7c6101a"}],"id":"3e29b0a3-1c3d-4c2e-b177-e702886bbec3","description":"

Shipping cost calculation endpoints for expedition services.

\n","_postman_id":"3e29b0a3-1c3d-4c2e-b177-e702886bbec3"},{"name":"New Request","id":"8c0486d2-594d-40a2-a381-00e88f0561b9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"urlObject":{"query":[],"variable":[]},"url":""},"response":[],"_postman_id":"8c0486d2-594d-40a2-a381-00e88f0561b9"}],"variable":[{"key":"base_url","value":"https://use.api.co.id","type":"string"},{"key":"api_key","value":"YOUR_API_KEY_HERE","type":"string"}]}