One API for delivery, tracking, and proof
Logistics software built for developers. TumaBoda's REST API and webhooks let you create deliveries, track riders live, and receive digital proof of delivery — directly inside your storefront, app, or backend.
1Create
examplePOST /v1/deliveries Authorization: Bearer sk_test_•••• { "pickup": "Westlands", "dropoff": "Kilimani", "otp_required": true }
201 Createdid: TB-48213
tracking_url: tumaboda.co.ke/track/TB-48213
2Track
webhooks- delivery.dispatched14:05:40 · rider verified
- delivery.in_transit14:18:02 · -1.2921, 36.8219
- delivery.arrived14:39:15 · ETA met
3Proof
14:41:37delivery.completed
Build delivery directly into your product
REST API
JSON payloads & REST
Webhooks
Real-time push events
OTP Proof
Digital verification
Environments
Sandbox & Live keys
With TumaBoda's developer platform, businesses can programmatically manage deliveries, track riders live, and automate proof-of-delivery reconciliation. Whether embedding checkout options into Shopify or connecting custom ERPs, our REST APIs turn last-mile fulfillment into structured code.
Delivery API features for businesses in Kenya
TumaBoda's delivery API is a REST API with webhooks that lets online stores, apps and business systems book courier deliveries, track riders live, and receive OTP-verified proof of delivery.
Create Deliveries by API
Book on-demand or scheduled deliveries programmatically with full recipient and item specifications.REST EndpointsDocsHide
Create courier deliveries in Kenya straight from your own system. One REST call books an on-demand or scheduled delivery with the pickup, drop-off, recipient and parcel details, and returns a delivery ID and a live tracking link.
- On-demand or scheduled pickups
- Single or batch deliveries
- JSON requests and responses
ExamplePOST /v1/deliveries → 201 Created
Live GPS Tracking
Fetch real-time status updates and live rider coordinates for seamless display in your apps.Real-Time GPSDocsHide
Show customers exactly where their order is. Fetch each delivery's real-time status and the rider's live GPS location through the API, or share the tracking link, so buyers follow the rider on a map and see the ETA instead of calling to ask.
- Live rider location and ETA
- Status from dispatch to handover
- Tracking inside your own app or site
ExampleGET /v1/deliveries/TB-48213
Delivery Status Webhooks
Receive instant push events for dispatch, transit status, arrival, and completed handovers.Event DrivenDocsHide
Get every status change pushed to you instead of polling. TumaBoda sends a webhook event to your endpoint when a rider is dispatched, is in transit, arrives and completes the handover, so your orders and your support team stay up to date automatically.
- Dispatch, in transit, arrival, completed
- Update order status in your database
- Alert support to delays or exceptions
Exampleevent: delivery.completed
Digital Proof of Delivery
Access verified OTP events, recipient signatures, and digital proof-of-delivery payloads.OTP HandoverDocsHide
Prove every delivery. Each completed handover is confirmed with a one-time PIN and produces a digital proof-of-delivery record, with the recipient's confirmation and time, that you can fetch through the API for disputes, audits and customer support.
- OTP-verified handover
- Recipient signature and confirmation
- Timestamped records for audits
Example"otp_verified": true
Shopify & WooCommerce Delivery
Out-of-the-box support for Shopify, WooCommerce, and custom web store checkouts.Shopify & TurnkeyDocsHide
Add delivery to your online store's checkout without building it yourself. TumaBoda works with Shopify, WooCommerce and custom checkouts, so each new order becomes a delivery request automatically, with no manual dispatch.
- Shopify and WooCommerce
- Custom checkout plugins
- Automated dispatch rules
Exampleorder placed → delivery created
Secure Authentication
Bearer token authentication with environment separation (sandbox & production) and rate limiting.Bearer TokensDocsHide
Integrate safely. Every request is authenticated with a bearer token, separate sandbox and production keys keep your testing apart from live deliveries, and rate limiting protects your integration.
- Bearer token authentication
- Sandbox and production keys
- Rate limiting
ExampleAuthorization: Bearer sk_test_••••
What you can build with TumaBoda APIs
Connect TumaBoda to your storefronts, mobile apps, and enterprise backends to automate fulfillment.
Seamless integration into existing software stacks
Eliminate manual dispatch data entry. When an order is placed on your site, our API automatically creates a delivery job and pushes real-time status updates back to your database.
Webhooks inform your customer support teams instantly if delays or exception handovers occur.
Request API credentialsAutomated Dispatch
Trigger rider pickup immediately upon order confirmation in your e-commerce checkout.
In-App Live Tracking
Embed live rider map coordinates and real-time ETA widgets directly inside your app.
CRM Status Sync
Push automated delivery status transitions directly into your support and CRM tools.
Proof & Audit Sync
Automatically match recipient OTP validation tokens with payout and reconciliation records.
Frequently asked questions
Everything you need to know about TumaBoda's developer API.
The TumaBoda delivery API is a REST API with webhooks that lets e-commerce stores, apps and business systems in Kenya book courier deliveries, track riders live, and receive OTP-verified digital proof of delivery, without manual dispatch.
Join the TumaBoda API program to receive sandbox credentials, production API keys, and full technical documentation.
You can programmatically create single or batch deliveries, track live rider locations, receive status events via webhooks, and fetch digital proof-of-delivery payloads.
Yes. TumaBoda supports Shopify, WooCommerce, and custom checkout plugins with pre-built webhook handlers and automated dispatch rules.
Webhooks push an event to your endpoint for each status change: rider dispatched, in transit, arrived, and handover completed, including the OTP verification and proof of delivery.
Build on TumaBoda.
Request sandbox API credentials and access our developer documentation today.