Skip to main content
GET
Get Public Tracking
Returns a public tracking view for a single order, keyed by its UUID. The order’s random UUID doubles as an unguessable share token, so this endpoint requires no authentication — it’s suitable for a customer-facing tracking page or a shareable link. The response includes the order status, destination address, per-package carrier checkpoints and ETAs, and the ordered items.
The order UUID is the only credential protecting this view. Treat the tracking link as sensitive and share it only with the recipient.
For privacy, the destination deliberately omits the recipient’s name and phone number. Every other part of the shipping address (street, city, state, ZIP, country) is included.

Authorizations

Authorization
string
header
required

Zinc API key (Bearer zn_...)

Path Parameters

order_id
string<uuid>
required

Response

Successful Response

Public, unauthenticated tracking view for an order.

Keyed by the order's random UUID (used as an unguessable share token). Shows the status, destination, per-package carrier checkpoints, and the ordered items — everything except the recipient's name and phone.

order_id
string<uuid>
required
current_status
enum<string>
required
Available options:
pending,
in_progress,
order_placed,
order_failed,
cancelled,
cancelled_by_retailer
destination
PublicTrackingDestination · object
required

Where an order is headed, for the public tracking page.

Deliberately omits the recipient's name and phone number — everything else on the shipping address (street, city, state, ZIP, country) is shown.

shipments
PublicTrackingShipment · object[]
required
items
PublicTrackingItem · object[]
required
estimated_delivery_date
string | null

Best-known order-level delivery estimate (destination-local calendar date); per-package estimates are on each shipment.