v1
latestOpenAPI 3.1.02026-07-22802,2441.7 MBcart
Orders
Create Cart Order Shipment
Get the required, optional, and integration specific fields by calling the integrations endpoint.
post/cart/orders/{order_id}/shipments
Path parameters
order_idstring required
Headers
x-trackstar-api-keystring required
Example:<x-trackstar-api-key>
Your organization-level Trackstar API key.
x-trackstar-access-tokenstring required
Example:<x-trackstar-access-token>
Your user's access token for a specific integration (ShipHero, Extensiv, etc).
Request body
Example request
{
"tracking_url": "https://www.example.com/tracking",
"carrier_name": "Carrier Name",
"shipping_method_name": "Standard Shipping"
}Response
Successful response
Example response
{
"data": {
"id": "order_id",
"order_number": "order_number",
"created_date": "2022-01-01T00:00:00Z",
"updated_date": "2022-01-02T05:05:05Z",
"status": "fulfilled",
"raw_status": "raw_status",
"requested_shipping_method": "Standard",
"shipping_method_id": "shipping_method_id",
"shipping_method_name": "Standard Shipping",
"carrier_id": "carrier_id",
"carrier_name": "Carrier Name",
"invoice_currency_code": "USD",
"total_price": 13.49,
"total_tax": 1.5,
"total_discount": 2.5,
"total_shipping": 3.5,
"ship_to_address": {
"full_name": "John Doe",
"company": "Company",
"address1": "123 Main St",
"address2": "Apt 2",
"address3": "Floor 3",
"city": "New York",
"state": "NY",
"postal_code": "10001",
"country": "United States",
"phone_number": "123-456-7890",
"email_address": "johndoe@example.com"
},
"bill_to_address": {
"full_name": "John Doe",
"address1": "123 Main St",
"address2": "Apt 2",
"address3": "Floor 3",
"city": "New York",
"state": "NY",
"postal_code": "10001",
"country": "United States"
},
"earliest_ship_date": "2022-10-10T01:02:03Z",
"latest_ship_date": "2022-10-10T01:02:03Z",
"line_items": [
{
"line_item_id": "line_item_id",
"product_id": null,
"product_sku": null,
"parent_product_id": null,
"parent_product_sku": null,
"quantity": 1,
"unit_price": 10.99,
"discount": 1.5,
"tax": 0.5,
"warehouse_id": "warehouse_id"
}
],
"shipping_groups": [
{
"shipping_group_id": "shipping_group_id",
"created_date": "2022-01-01T00:00:00Z",
"updated_date": "2022-01-02T05:05:05Z",
"raw_status": "raw_status",
"status": "shipped",
"warehouse_id": "warehouse_id",
"line_items": [
{
"line_item_id": "shipping_group_line_item_id"
}
]
}
],
"shipments": [
{
"shipment_id": "shipment_id",
"raw_status": "raw_status",
"status": "shipped",
"warehouse_id": "warehouse_id",
"shipping_method_id": "shipment_shipping_method_id",
"shipping_method_name": "shipment_shipping_method_name",
"carrier_id": "carrier_id",
"carrier_name": "carrier_name",
"tracking_url": "https://www.example.com/tracking",
"shipping_groups": [
"sg_id_1",
"sg_id_2"
],
"ship_from_address": {
"address1": "123 Main St",
"address2": "Apt 2",
"address3": "Floor 3",
"city": "New York",
"state": "NY",
"postal_code": "10001",
"country": "United States"
},
"created_date": "2022-01-01T00:00:00Z",
"updated_date": "2022-01-02T05:05:05Z"
}
],
"tags": [
"tag_0"
],
"external_system_url": "https://example.com/order/123",
"trackstar_tags": [
"tag1",
"tag2",
{
"tag3": "value3"
}
],
"additional_fields": {
"key": "value"
}
},
"id": "id"
}