Simba Logistic API v2 Documentation
Simba Logistic API v2 Documentation
Base URL: https://tracking.simbalogistic.co.tz/api/v2/
Disclaimer: This API currently has no authentication or security measures in place. Do not use in production
environments without proper authentication and encryption.
1. Create an Order
Endpoint: POST /CreateOrder
Description:
Creates a new customer order and pickup record. Generates a unique tracking code that can be used to check status.
Sample Request:
{
"CustomerRetails": {
"customer_uuid": "33412",
"name": "Moses muchomo ",
"phone": "+255712345678",
"email": "[email protected]",
"address": "123 Mikocheni Street, Dar es Salaam"
},
"pickupDetails": {
"collection_date": "2025-05-14",
"pickup_point": "Warehouse cd",
"fleet_type": "Truck"
},
"OrderDetails": [
{
"item_description": "Box",
"quantity": 2,
"dropping_point": "Customer Site 1"
},
{
"item_description": "Envelope",
"quantity": 2,
"dropping_point": "Customer Site 2"
}
]
}
Simba Logistic API v2 Documentation
Sample Success Response:
{
"status": "success",
"tracking_code": "TPRYEKFO1OJA",
"message": "Customer and order created successfully",
"status_code": 201
}
Error (Missing Fields):
{
"status": "error",
"message": "Missing CustomerRetails, pickupDetails, or OrderDetails",
"status_code": 400
}
2. Check Order Status
Endpoint: POST /CheckStatus?tracking_code={tracking_code}
Description:
Returns the current status of the consignment using the tracking code.
Sample Request:
curl --location --request POST 'https://tracking.simbalogistic.co.tz/api/v2/CheckStatus?tracking_code=TPRYEKFO1OJA'
Sample Success Response:
[
{
"item_description": "Box",
"quantity": 2,
"status": "Out for Delivery",
"status_description": "The consignment has reached the destination and is out for delivery."
},
{
"item_description": "Envelope",
"quantity": 2,
"status": "In Transit",
"status_description": "The consignment is currently in transit. Call +25578812333 for more details."
}
]
Simba Logistic API v2 Documentation
Error (Invalid Tracking Code):
{
"status": "error",
"message": "No consignment found for the provided tracking code",
"status_code": 404
}
Status Reference
Requested - The pickup arrangement is underway
Out for Pickup - The rider or driver is on the way to pick up the consignment
Picked - The consignment has been picked and is in the warehouse for sorting
In Warehouse - The consignment is currently in the warehouse
In Transit - The consignment is currently in transit. Call +25578812333 for more details
Out for Delivery - The consignment has reached the destination and is out for delivery
Delivered - Delivered in good condition
Security Disclaimer
This API currently does not have any authentication or authorization mechanisms in place.
- No API keys or tokens
- No rate limiting
- No encryption enforcement
Do not use this API in production or expose it to the public without implementing proper security measures.
