Retrieves available shipping options for the specified order and address.
This Available Shipping Lines API endpoint will retrieves available shipping options for the specified order and address.
This API is especially useful for:
- calculate shipping costs
- get available delivery methods during checkout or order management.
Request Parameters
Public Request Parameters
Body Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
order_id | string | Yes | Unique identifier for the order | "123123123" |
country_code | string | Yes | ISO 3166-1 alpha-2 country code | "US" |
province_code | string | No | Province or state code | "CA" |
zip | string | No | ZIP or postal code | "90001" |
Response Explanation
Public Response Parameters
Successful Response
| Parameter | Type | Description | Example |
|---|---|---|---|
code | string | Error code | "success" |
message | string | Error message | "Operation successful" |
data | object | Response data container | - |
data.shipping_lines | array of objects | List of available shipping lines | - |
Shipping Line Object Structure
Parameter | Type | Description | Example |
|---|---|---|---|
| int32 | Delivery method type (1: express delivery, 2: local delivery) |
|
| string | Description of the shipping line |
|
| string | Unique identifier for the shipping line |
|
| string | Location identifier |
|
| string | Name of the shipping line |
|
| string | Plan code |
|
| string | Shipping price (as string to preserve precision) |
|
| int32 | Whether cash on delivery is supported (0 or 1) |
|
| array of strings | List of invalid product identifiers |
|
| string | Reason for third-party billing failure |
|
| string | Business state code: |
|
Error Response
| Field | Type | Example | Description |
|---|---|---|---|
code | string | InvalidParameter | Error http message |
message | string | `` | Error message |
