South Africa Courier API & Tracking Reference 2026 — All 18 Couriers
A complete developer reference for South African courier APIs as of July 2026. Every courier we track on the DeliverAI platform — their tracking endpoints, rate-quote APIs, webhook support, authentication scheme, and known latency characteristics. Bookmark this page; it's refreshed quarterly.
API Capability Matrix — All 18 SA Couriers
The table below summarises which couriers offer which API capabilities as of 1 July 2026. Click any courier name for the full integration profile, rate cards and live latency.
The Three Patterns You'll Hit Building SA Courier Integrations
1. Tracking-status normalisation
Every courier uses its own status taxonomy. Bob Go says “Allocated to Driver”, Aramex says “Out for Delivery”, Paxi says “Ready for Collection” — all three mean roughly the same thing to your customer. Build a normalisation table early. Recommended 7-state model:
status_normalised = {
"created" : ["created","label_printed","pre_advised"],
"picked_up" : ["picked_up","collected","at_origin_hub"],
"in_transit" : ["in_transit","at_hub","at_destination_hub"],
"out_for_delivery" : ["out_for_delivery","allocated_to_driver"],
"delivered" : ["delivered","signed_for","collected_at_pup"],
"exception" : ["delay","customs_hold","address_issue"],
"returned" : ["returned_to_sender","return_in_transit"]
}2. Rate quote validation
Courier rate APIs return prices that don't always match what gets invoiced. Reasons: volumetric weight recalculation on actual scan, fuel-surcharge index changes between quote and shipment, residential vs business surcharges applied at pickup. Always store the original quote + the actual invoice line and reconcile weekly. For volume integrations, the DeliverAI rate-snapshot dataset gives you a daily independent rate vector you can compare against.
3. Webhook retry + idempotency
Of the 9 SA couriers offering webhooks, only 4 (Bob Go, DPD Laser, DHL Express, Uber Connect) implement proper retry-with-backoff and signed payloads. The others fire-and-forget. If your endpoint is down for 30 seconds you miss the event. Implement an hourly polling reconciliation pass against the tracking endpoint as a safety net for missed webhook events. Always make your webhook handler idempotent — duplicate deliveries are common.
Frequently Asked Questions
Do all SA couriers have a public API?
No. As of 2026, 14 of the 18 major SA couriers offer REST APIs with at least tracking + rate-quote endpoints. PostNet and Paxi have limited API access (tracking only, no rate API). The remaining 4 couriers rely on web-portal CSV upload or EDI for bulk operations. The DeliverAI platform abstracts all 18 behind one unified comparison API.
Which SA courier has the best developer API?
For modern REST + webhook support: Bob Go (best-documented, Shopify-native), DPD Laser (well-structured REST), Pargo (clean docs), and Uber Connect / Bolt Send (real-time pricing). For enterprise SOAP / legacy support: Aramex and DHL Express. The Courier Guy and Fastway have functional REST APIs but documentation is partner-portal-only.
How do I track a parcel from any SA courier programmatically?
Each courier has its own tracking endpoint, format and authentication. To unify across all 18, you need either an aggregator (DeliverAI rate-and-track API, available via Pro Data tier) or to implement each courier separately. Common patterns: REST GET with tracking number + API key, JSON response with status + scan history + last known location. Webhook support exists for Bob Go, DPD Laser, Pargo, PUDO, RAM, DHL, FedEx, Uber and Bolt.
What is the standard tracking-status format across SA couriers?
There is no industry standard. The most common statuses across SA couriers map to: created, picked-up, in-transit, out-for-delivery, delivered, exception, returned. Each courier names them differently — Aramex uses “Out for Delivery”, Bob Go uses “Allocated to Driver”, Paxi uses “Ready for Collection”. The DeliverAI tracking layer normalises all of these to a shared 7-status model.
Do SA couriers support webhooks for status updates?
Bob Go, DPD Laser, Pargo, PUDO, RAM, DHL Express, FedEx, Uber Connect and Bolt Send support webhooks for tracking events. Aramex and Fastway offer limited webhook support (event-batched, not real-time). Paxi, PostNet, The Courier Guy do not offer webhooks — you must poll their tracking endpoint at intervals (every 15-60 minutes is typical).
Is there a single API to quote rates across all SA couriers?
Yes — the DeliverAI Pro Data API (R 2,499/mo VAT incl) provides a single JSON endpoint that returns live rates across all 18 SA couriers for a given pickup, drop-off, weight and dimensions. It also returns 90-day historical rate trends. Free tier (no signup) is available via the public comparison page at deliverai.co.za/compare.
What authentication do SA courier APIs typically use?
Mostly API keys (header or query parameter) for The Courier Guy, Aramex, DPD Laser, Paxi, Pargo, Fastway, RAM. OAuth 2.0 client-credentials for Bob Go, PUDO, DHL Express, FedEx, Uber, Bolt. Tokens typically expire in 1-24 hours depending on the courier — production integrations need a token-refresh layer.
How fast are SA courier APIs?
P95 latency varies from 200ms (Bob Go, DPD Laser, Pargo, PUDO) to 2-4 seconds (Aramex, Fastway, PostNet). DeliverAI publishes live p95 latency for every courier API at deliverai.co.za/health — refreshed every 15 minutes.
Related Reading
- Courier rate spread by lane 2026 — live rates across all 18 SA couriers.
- All SA couriers directory — full profile per courier.
- Live courier API health — p95 latency dashboard, refreshed every 15 min.
- Data methodology — how DeliverAI captures and normalises courier rates.
- Pro Data API — unified JSON API across all 18 couriers, R 2,499/mo.
Sources
- DeliverAI courier integration logs and live latency data, July 2026 — deliverai.co.za/health
- Bob Go developer documentation — bobgo.co.za
- DPD Laser API reference — dpdlaser.co.za
- Uber Direct (SA) developer portal — uber.com/developer
- DeliverAI methodology — deliverai.co.za/methodology
One API. All 18 SA couriers.
Stop maintaining 18 integrations. DeliverAI Pro Data gives you a unified JSON API for rates, tracking and webhook events across every major SA courier — R 2,499/mo VAT incl.