Tracking
Track shipment status and delivery updates.
Updated
On this page
Overview
Track shipments in real-time using tracking numbers from carriers.
SDK Usage
import dash from "@/lib/dash"
const tracking = await dash.shipping.track("1Z999AA10123456784", "ups")
// tracking = {
// tracking_number: "1Z999AA10123456784",
// carrier_code: "ups",
// tracking_url: "https://www.ups.com/track?tracknum=1Z999AA10123456784"
// }
Address Validation
Validate and normalize shipping addresses before checkout:
const result = await dash.shipping.validateAddress({
address_line1: "123 Main St",
city: "Austin",
state: "TX",
postal_code: "78701",
country_code: "US",
})
// result = {
// status: "verified", // "verified" | "unverified" | "warning"
// original_address: { ... },
// matched_address: { ... }, // Standardized version
// messages: [] // Any warnings
// }
Tracking on Order Page
export function TrackingInfo({ order }) {
if (!order.tracking_number) return null
return (
<div className="border rounded p-4">
<h3>Shipping Tracking</h3>
<p>Carrier: {order.carrier_code?.toUpperCase()}</p>
<p>Tracking #: {order.tracking_number}</p>
<a href={order.tracking_url} target="_blank" rel="noopener"
className="text-blue-400 underline">
Track Package →
</a>
</div>
)
}
REST API
GET /storefront/shipping/track/1Z999AA10123456784
X-API-Key: pk_live_your_key
POST /storefront/shipping/validate-address
Content-Type: application/json
{ "address_line1": "123 Main St", "city": "Austin", "state": "TX", "postal_code": "78701" }
Next Steps
- Shipping Locations — Available destinations
- Fulfillment — The fulfillment process