Twendex Platform API
Build logistics into your application. The same engine that powers Twendex — shipments, quotes, tracking, webhooks — available through a REST API.
What You Can Build
The Twendex Platform API gives your application programmatic access to the same logistics engine used by thousands of businesses across Africa. Create shipments, get real-time quotes, assign carriers, track deliveries, and receive webhook events — all through a single, versioned REST API.
Create & Manage Shipments
Programmatically create shipments, request quotes, accept bids, and assign carriers — identical workflow to the Twendex UI.
Real-Time Webhooks
Receive signed, retried webhook events for every shipment lifecycle change: created, quoted, assigned, in-transit, delivered.
Scope-Secured Access
API keys are scoped to your resources. Cross-account access is blocked. Rate limits enforce fair usage per tier.
Self-Serve Management
Issue, rotate, and revoke API keys from your dashboard. Register webhook endpoints. Monitor usage — no manual approval needed.
Authentication
# All API requests require an API key
curl -H "X-API-Key: twx_live_xxxxxxxxxxxx" \
https://api.twendex.com/api/v1/platform/shipments
# Or use Bearer token
curl -H "Authorization: Bearer twx_live_xxxxxxxxxxxx" \
https://api.twendex.com/api/v1/platform/shipmentsBase URL: https://api.twendex.com/api/v1
Quickstart
Get an API key
Sign in to your Twendex account, go to the Developer Dashboard, and create a sandbox API key. The key secret is shown once — copy it immediately.
Create your first shipment
Make a POST request to /api/v1/platform/shipments with your API key in the X-API-Key header. Include pickup, delivery, and package details in the request body.
Get quotes and assign a carrier
Poll GET /api/v1/platform/shipments/{id}/quotes to see carrier bids. Accept a bid by posting to the carrier-assignment endpoint.
Track and receive webhooks
Use GET /api/v1/platform/tracking/{shipmentId} for real-time location. Register a webhook endpoint to receive automatic push events for every status change through to POD delivery.
Sandbox / Test Mode
Sandbox keys let you test the full API workflow without touching real carriers, money, or dispatch. Test-mode shipments are isolated from live data.
- Create a sandbox key from your Developer Dashboard (set environment to 'sandbox' when creating).
- All sandbox shipments stay in test mode — no real carriers are dispatched, no real payments are processed.
- Use the same endpoints and workflow as production. Switch to a live key when you are ready to go live.
Interactive API Documentation
Explore every endpoint, see request/response schemas, and test calls directly from your browser with our live Swagger documentation.
Open API DocsAlready have an account? Manage your keys and webhooks from the dashboard.
Go to Developer Dashboard