Wayzi Open Transport & Carrier API

Integrate live European parcel tracking, route schedules, carrier TMS automation, and HMAC-signed webhooks into any website or logistics system.

Manage Carrier API Keys Open Public Shipment Tracker

Free · No Key Needed

1. Public Open API

Free CORS-enabled endpoints for live 6-digit / reference parcel tracking, European route availability, coverage catalog, and verified carrier badges.

Bearer wzk_live_...

2. Carrier REST API & Webhooks

Scoped API keys (wzk_live_...) for approved carriers to sync trips, manifests, status transitions, live GPS telemetry, fleet, and invoices.

Bearer wzm_live_...

3. Merchant & E-Commerce Blueprint

Partner specification (wzm_live_...) for Shopify, WooCommerce, and ERP checkouts to quote European shipping and issue Wayzi labels.

Interactive Free Public API Explorer

Test the no-key Public Open API endpoints live in your browser (sandbox code 904821 preloaded).

CORS: * · No API Key Required

curl -X GET "https://wayzi.app/api/v1/public/track?code=904821" \
  -H "Accept: application/json"

Authenticated Carrier TMS Endpoints

Authenticate with Authorization: Bearer wzk_live_<secret>. Every endpoint enforces granular read/write scopes and approved carrier verification.

GET /api/v1/carrier/me
trips:read
GET · POST · PATCH /api/v1/carrier/trips
trips:write
GET · POST /api/v1/carrier/bookings
bookings:write
GET · POST /api/v1/carrier/tracking
tracking:write
GET · POST · PATCH /api/v1/carrier/fleet
fleet:write
GET /api/v1/carrier/invoices
finance:read

Real-Time Outbound Webhooks (HMAC-SHA256)

Receive instant push notifications when bookings are requested, accepted, scanned, or invoiced. Verify authenticity with X-Wayzi-Signature.

// Verify X-Wayzi-Signature in Node.js
import crypto from "node:crypto";

export function verifyWayziWebhook(rawBody, signatureHeader, secret) {
  const parts = Object.fromEntries(
    signatureHeader.split(",").map((p) => p.split("="))
  );
  const expected = crypto
    .createHmac("sha256", secret)
    .update(`${parts.t}.${rawBody}`)
    .digest("hex");
  return crypto.timingSafeEqual(
    Buffer.from(parts.v1 || ""),
    Buffer.from(expected)
  );
}

HMAC-SHA256 · Replay timestamp protectionManage Carrier API Keys

Merchant & E-Commerce Partner API Blueprint (Shopify / WooCommerce)

Partner Blueprint · wzm_live_...

Architectural specification for online stores, Shopify CarrierService apps, and WooCommerce plugins to quote cross-border European parcel/cargo rates, book shipments at checkout, and print 6-digit + QR labels.

POST /api/v1/merchant/quotes

Instant Checkout Rate Quotes

Pass origin/destination postal codes and package dimensions/weight to receive matching verified carrier departures and rates.

POST /api/v1/merchant/shipments

Automated Checkout Shipment Creation

Convert a checkout quote into a confirmed Wayzi parcel booking with automated Stripe Connect payment splitting.

GET /api/v1/merchant/labels/:ref

Thermal Label & 6-Digit Code Generation

Retrieve printable A6/4x6 PDF/ZPL labels, QR payload, and the 6-digit handwritten fallback code.