Seller Fulfillment

Assign rider

POST/api/v1/orders/:id/assign-rider

Assigns a delivery order to one of the seller's riders.

Requires Authorization

SELLER only

Session

Path parameters

idstringrequired

Must belong to one of the seller's shops.

Body parameters

riderIdstringrequired

Must be one of the seller's own riders.

Request

curl --request POST \
  --url https://api.swiftgoma.com/api/v1/orders/:id/assign-rider \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "riderId": "<riderId>"
}'

200Example response

{
  "success": true,
  "data": {
    "id": "ord_5e6f7a",
    "buyerId": "3f2a1c9e",
    "shopId": "shop_2b3c4d",
    "status": "RIDER_ASSIGNED",
    "fulfillmentMethod": "DELIVERY",
    "paymentMethod": "MOBILE_MONEY",
    "currency": "USD",
    "deliveryAddress": "12 Avenue du Lac, Goma",
    "deliveryFee": "2.00",
    "subtotal": "25.00",
    "total": "27.00",
    "items": [
      {
        "id": "oitem_1a2b3c",
        "productId": "prod_7c8d9e",
        "variantId": "var_4d5e6f",
        "name": "Riz parfumé 25kg",
        "quantity": 2,
        "unitPrice": "12.50",
        "lineTotal": "25.00"
      }
    ],
    "createdAt": "2026-02-15T09:00:00.000Z",
    "updatedAt": "2026-02-15T09:00:00.000Z"
  }
}