Skip to main content
POST
/
orders
Create Order
curl --request POST \
  --url https://api.mtn.express.ci/client/orders \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "referenceNumber": "ORD0001",
  "total": 98150,
  "deliveryFee": 1500,
  "deliveryInstructions": "Livrer à midi",
  "deliveryDeadline": "2025-06-05",
  "recipient": {
    "name": "John Doe",
    "phone": "+2250702029254",
    "address": {
      "name": "45 Avenue de la Paix",
      "landmark": "Terminus 81/82",
      "city": "Cocody",
      "latitude": 5.403871,
      "longitude": -3.9881079
    }
  },
  "items": [
    {
      "referenceNumber": "ITEM001",
      "itemName": "Samsung Galaxy A05 64Go",
      "quantity": 1,
      "total": 77900,
      "size": "S",
      "weight": 0.5,
      "itemUrl": "https://market.momo.africa/Portal/product/121731/1?tenantId=4&lang=fr",
      "sender": {
        "referenceNumber": "0596086680",
        "name": "Samsung Store Abidjan",
        "phone": "+2250700000001",
        "address": {
          "name": "123 Rue Principale",
          "landmark": "Angré pétro ivoire",
          "city": "Cocody",
          "latitude": 5.359951,
          "longitude": -4.008256
        }
      }
    },
    {
      "referenceNumber": "ITEM002",
      "itemName": "Riz vietnamien La Rizière long grains parfumé 5kg",
      "quantity": 5,
      "total": 18750,
      "size": "S",
      "weight": 5.5,
      "itemUrl": "https://market.momo.africa/Portal/product/107465/1?tenantId=4&lang=fr",
      "sender": {
        "referenceNumber": "0555306590",
        "name": "Tech Shop",
        "phone": "+2250700000002",
        "address": {
          "name": "456 Avenue Tech",
          "landmark": "Liberté",
          "city": "Adjamé",
          "latitude": 5.40387101,
          "longitude": -4.009
        }
      }
    }
  ]
}
'
{
  "referenceNumber": "ORD0001",
  "total": 98150,
  "deliveryFee": 1500,
  "deliveryInstructions": "Livrer à midi",
  "deliveryDeadline": "2025-06-05",
  "status": "pending",
  "statusComment": null,
  "createdAt": "2025-06-05T07:05:21.000Z",
  "updatedAt": "2025-06-05T07:05:21.000Z",
  "recipient": {
    "referenceNumber": null,
    "name": "John Doe",
    "phone": "0702029254",
    "address": {
      "name": "45 Avenue de la Paix",
      "landmark": "Terminus 81/82",
      "city": "Cocody",
      "latitude": 5.403871,
      "longitude": -3.9881079
    }
  },
  "items": [
    {
      "referenceNumber": "ITEM001",
      "orderId": 14,
      "itemName": "Samsung Galaxy A05 64Go",
      "quantity": 1,
      "total": 77900,
      "size": "S",
      "weight": 0.5,
      "itemUrl": "https://market.momo.africa/Portal/product/121731/1?tenantId=4&lang=fr",
      "status": "pending",
      "statusComment": null,
      "createdAt": "2025-06-05T07:05:21.000Z",
      "updatedAt": "2025-06-05T07:05:21.000Z",
      "sender": {
        "referenceNumber": "0596086680",
        "name": "Samsung Store Abidjan",
        "phone": "0700000001",
        "address": {
          "name": "123 Rue Principale",
          "landmark": "Angré pétro ivoire",
          "city": "Cocody",
          "latitude": 5.359951,
          "longitude": -4.008256
        }
      }
    },
    {
      "referenceNumber": "ITEM002",
      "orderId": 14,
      "itemName": "Riz vietnamien La Rizière long grains parfumé 5kg",
      "quantity": 5,
      "total": 18750,
      "size": "S",
      "weight": 5.5,
      "itemUrl": "https://market.momo.africa/Portal/product/107465/1?tenantId=4&lang=fr",
      "status": "pending",
      "statusComment": null,
      "createdAt": "2025-06-05T07:05:21.000Z",
      "updatedAt": "2025-06-05T07:05:21.000Z",
      "sender": {
        "referenceNumber": "0555306590",
        "name": "Tech Shop",
        "phone": "0700000002",
        "address": {
          "name": "456 Avenue Tech",
          "landmark": "Liberté",
          "city": "Adjamé",
          "latitude": 5.40387101,
          "longitude": -4.009
        }
      }
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Represents the order request payload when creating a new order.

​
recipient
object
required

Details of the recipient receiving the order.

​
items
object[]
required

List of items included in the order.

Minimum array length: 1
​
referenceNumber
string | null

Unique order reference in your system. If not provided, Express will generate it automatically.

Example:

"ORD0001"

​
total
number<float> | null

Total amount of the order including delivery fees.

Required range: x >= 0
Example:

98150

​
deliveryFee
number<float> | null

Fee for delivering the order.

Required range: x >= 0
Example:

1500

​
deliveryInstructions
string | null

Special instructions for the delivery process.

Example:

"Livrer à midi"

​
deliveryDeadline
string<date> | null

The latest date by which the delivery should be completed.

Example:

"2025-06-05"

Response

201 - application/json

Delivery order created

Represents the response payload for an order after it has been created, retrieved, or canceled.

​
referenceNumber
string
required

Unique order reference in your system.

Example:

"ORD0001"

​
total
number<float>
required

Total amount of the order including delivery fees.

Example:

98150

​
deliveryFee
number<float>
required

Fee for delivering the order.

Example:

1500

​
status
string
required

Current status of the order.

Example:

"pending"

​
createdAt
string<date-time>
required

Timestamp when the order was created.

Example:

"2025-06-05T07:05:21.000Z"

​
updatedAt
string<date-time>
required

Timestamp when the order was last updated.

Example:

"2025-06-05T07:05:21.000Z"

​
recipient
object
required

Details of the recipient receiving the order.

​
items
object[]
required

List of items included in the order.

​
deliveryInstructions
string | null

Special instructions for the delivery process.

Example:

"Livrer à midi"

​
deliveryDeadline
string<date-time> | null

The latest date by which the delivery should be completed.

Example:

"2025-06-05"

​
statusComment
string | null

Optional comments related to the order status.

Example:

null