Referensi API

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.

Kemampuan

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

Endpoint

GET/v1/orders/available

List unassigned jobs in your territories

POST/v1/orders/{order_id}/accept

Accept a job for a rider

POST/v1/orders/{order_id}/reassign

Move a job to another rider

GET/v1/orders/{order_id}

Retrieve a single order

Accept an order for a rider

Permintaan

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" }'

Respons · 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 }
}

Order Assignment API

Endpoint

Accept an order for a rider

Siap berintegrasi?