API reference
Order Assignment API
Route creator orders to your fleet, programmatically.
The Order Assignment API lets logistics partners receive, accept, and manage delivery jobs as they are created across the FOODS network. Pull available jobs, accept them for a rider, and keep order state in sync with your own dispatch system.
Capabilities
- Receive available delivery jobs in your zones
- Accept or decline jobs on behalf of a rider
- Reassign a job between riders
- Sync order lifecycle state with your dispatch system
Endpoints
GET
/v1/orders/availableList unassigned jobs in your territories
POST
/v1/orders/{order_id}/acceptAccept a job for a rider
POST
/v1/orders/{order_id}/reassignMove a job to another rider
GET
/v1/orders/{order_id}Retrieve a single order
Accept an order for a rider
Request
curl -X POST https://api.foodsbyme.com/v1/orders/ord_8Kd2/accept \
-H "Authorization: Bearer $FOODS_PARTNER_KEY" \
-H "Content-Type: application/json" \
-d '{ "rider_id": "rdr_19f3" }'Response · 200 OK
{
"order_id": "ord_8Kd2",
"status": "assigned",
"rider_id": "rdr_19f3",
"pickup": { "creator": "Mama Titi's Kitchen", "eta_mins": 7 },
"dropoff": { "area": "Lekki Phase 1" },
"payout_estimate": { "currency": "NGN", "amount": 850 }
}