Get Eligible Shipping Service

Use this API ( for US ) to query the list of available shipping services when specifying packages' size or weight. Use this API ( for JP ) to query the list of available shipping services when specifying packages' size or weight.The shipping fee and delivery time is an estimate only and is based on the package dimensions and weight you provided. Options listed may differ if you change the package attributes at the time of shipping.

---

For common parameters, refer to How to call TikTok Shop APIs - Common Parameters

• GRAM
• POUND | dimension |object |N | |The dimensions of the scheduled package. | ^length |string |Y |0.3 |The length of the package. The length, width, height must be passed together. | ^width |string |Y |0.2 |The width of the package. The length, width, height must be passed together. | ^height |string |Y |CM |The height of the package. The length, width, height must be passed together. | ^unit |string |Y |INCH |The unit of measurement is used to measure the length.
• CM
• INCH | order_line_list |[]object |N | |This new parameter is completely backward compatible with the previous oder_line_items_ids field and in addition this supports bundle order splitting, use the sub items accordingly | ^order_line_id |string |N |57632132124331234 |The corresponding order line ID. | ^sub_item_id |string |N |57632132124331234 |The sub-order-line ID inside a bundle product.
• Required for bundle products.
• Not required for non-bundle products. |

Query

https://open-api.tiktokglobalshop.com/fulfillment/202309/orders/32132124331234/shipping_services/query?app_key=123abc&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c&timestamp=1625484268&shop_cipher=ROW_RHkDDABBAAB8tKAVoAqsMTjsQZFLyNfY

Body

{"order_line_item_ids":["32132124331234"],"weight":{"value":"0.4","unit":"GRAM"},"dimension":{"length":"0.3","width":"0.2","height":"CM","unit":"INCH"},"order_line_list":[{"order_line_id":"57632132124331234","sub_item_id":"57632132124331234"}]}

• GRAM
• POUND | ^shipping_services |[]object | |Shipping services info. | ^^id |string |288233559123860015 |Shipping service ID | ^^name |string |UPS-first class |Shipping service Name | ^^price |string |5 |Estimated total price for this Shipping services | ^^currency |string |USD |Currency of the price | ^^earliest_delivery_days |int |3 |The minimum estimated duration required for parcel delivery.US only. | ^^latest_delivery_days |int |5 |The maximum estimated duration required for parcel delivery.US only. | ^^is_default |bool |false |Whether it is the default shipping service | ^^shipping_provider_name |string |UPS |The name of shipping provider.US only. | ^^shipping_provider_id |string |288233559123860012 |The ID of shipping provider.US only. | ^^shipping_fee |string |3 |Shipping fee | ^^shipping_app_service_fee |string |1 |Shipping surcharge paid to the ERPs | ^^signature_fee |string |1 |Signature service fee | ^dimension |object | |The dimension of the scheduled package. | ^^length |string |0.3 |The length of the package. The length, width, height must be passed together. | ^^width |string |0.2 |The width of the package. The length, width, height must be passed together. | ^^height |string |0.04 |The height of the package. The length, width, height must be passed together. | ^^unit |string |INCH |The unit of measurement is used to measure the length.
• CM
• INCH |

{"code":0,"data":{"order_id":"28823355942588","order_line_id":["32132124331234"],"weight":{"value":"1.2","unit":"GRAM"},"shipping_services":[{"id":"288233559123860015","name":"UPS-first class","price":"5","currency":"USD","earliest_delivery_days":3,"latest_delivery_days":5,"is_default":false,"shipping_provider_name":"UPS","shipping_provider_id":"288233559123860012","shipping_fee":"3","shipping_app_service_fee":"1","signature_fee":"1"}],"dimension":{"length":"0.3","width":"0.2","height":"0.04","unit":"INCH"}},"message":"Success","request_id":"202203070749000101890810281E8C70B7"}

For common error codes, refer to How to call TikTok Shop APIs - Common Error Code