Create Order
POST
/outlets/{outlet_id}/channels/{channel_id}/orders
Request
Authorization
Add parameter in header
X-Api-Key
Example:
X-Api-Key: ********************
Path Params
outlet_id
string
required
channel_id
string
required
Header Params
X-Merchant-Id
string
required
Body Params application/json
brand_id
integer
optional
fulfilment_type
enum<string>
required
Allowed values:
dine_inpickupdelivery
serving_date
string <date>
required
YYYY-MM-DD
timeslot_start
integer
required
timeslot_end
integer
required
timeslot_type
enum<string> | enum<null>
optional
Allowed values:
asapavailable_timeslots
order_items
array[object (OrderItemRequest) {5}]
required
item_id
integer
required
quantity
integer
required
>= 1
price_cents
integer
required
notes
string
optional
sub_items
array [object {4}]
required
contact_name
string
optional
contact_email
string
optional
contact_number
string
optional
external_order_id
string
optional
external_order_short_code
string
optional
address_line1
string
optional
address_line2
string
optional
postal_code
string
optional
address_latitude
number
optional
address_longitude
number
optional
is_cutlery_required
boolean
optional
Default:
false
is_contactless
boolean
optional
Default:
false
notes
string
optional
is_gift
boolean
optional
Default:
false
recipient_name
string
optional
recipient_contact_number
string
optional
gift_message
string
optional
is_paid
boolean
optional
order_payments
.Default:
false
promo_code
string
optional
subtotal
integer
optional
delivery_fee
integer
optional
surcharge
integer
optional
discount
integer
optional
total
integer
optional
tax
integer
optional
tax_rate
string
optional
total_including_tax
integer
optional
admin_discount
integer
optional
order_payments
array[object (OrderPayment) {4}]
optional
amount
integer
required
capture_id
string
required
capture_type
string
required
payment_type_id
integer
optional
Example
{
"fulfilment_type": "delivery",
"serving_date": "2025-04-03",
"timeslot_start": 54000,
"timeslot_end": 55800,
"timeslot_type": "asap",
"contact_name": "{{$person.firstName}}",
"contact_email": "{{$internet.email}}",
"contact_number": "80000001",
"postal_code": "038988",
"address_line1": "8 Temasek Boulevard",
"address_line2": "Suntec Tower 3",
"external_order_id": "{{$string.alphanumeric(length=16,casing='upper')}}",
"external_order_short_code": "OR{{$string.numeric(length=3)}}",
"address_latitude": 1.3201834070900638,
"address_longitude": 103.85793397422587,
"order_items": [
{
"item_id": 380,
"quantity": 1,
"price_cents": 1500,
"sub_items": [
{
"item_id": 496,
"quantity": 1,
"price_cents": 0
}
]
},
{
"item_id": 480,
"quantity": 2,
"price_cents": 1000
}
]
}
Request samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api-stg.atlas.kitchen/outlets//channels//orders' \
--header 'X-Merchant-Id;' \
--header 'Content-Type: application/json' \
--data-raw '{
"fulfilment_type": "delivery",
"serving_date": "2025-04-03",
"timeslot_start": 54000,
"timeslot_end": 55800,
"timeslot_type": "asap",
"contact_name": "{{$person.firstName}}",
"contact_email": "{{$internet.email}}",
"contact_number": "80000001",
"postal_code": "038988",
"address_line1": "8 Temasek Boulevard",
"address_line2": "Suntec Tower 3",
"external_order_id": "{{$string.alphanumeric(length=16,casing='\''upper'\'')}}",
"external_order_short_code": "OR{{$string.numeric(length=3)}}",
"address_latitude": 1.3201834070900638,
"address_longitude": 103.85793397422587,
"order_items": [
{
"item_id": 380,
"quantity": 1,
"price_cents": 1500,
"sub_items": [{
"item_id": 496,
"quantity": 1,
"price_cents": 0
}]
},
{ "item_id": 480, "quantity": 2, "price_cents": 1000 }
]
}'
Responses
🟢200Success
application/json
Body
id
integer
required
user_id
integer
required
channel_id
integer
required
outlet_id
integer
required
brand_id
integer | null
required
identifier
string | null
required
state
string
required
fulfilment_type
enum<string>
required
Allowed values:
dine_inpickupdelivery
serving_date
string <date>
required
YYYY-MM-DD
timeslot_start
integer
required
timeslot_end
integer
required
timeslot_type
enum<string>
required
Allowed value:
asap
timeslot_range
string
read-onlyrequired
order_items
array[object (OrderItemResponse) {12}]
required
id
integer
required
item_id
integer
required
name
string
required
quantity
integer
required
>= 1
price_cents
integer
required
currency
string
required
discount
integer
required
Default:
0
notes
string | null
required
calculated_subtotal
integer | null
required
per_unit_quantity
integer | null
required
unit_label
string | null
required
sub_items
array [object {11}]
required
contact_name
string | null
required
contact_email
string | null
required
contact_number
string | null
required
address_line1
string | null
required
address_line2
string | null
required
external_order_id
string | null
required
external_order_short_code
string | null
required
call_number
string
required
postal_code
string | null
required
address_latitude
number | null
required
address_longitude
number | null
required
is_cutlery_required
boolean
required
Default:
false
is_contactless
boolean
required
Default:
false
notes
string | null
required
is_gift
boolean
required
Default:
false
recipient_name
string | null
required
recipient_contact_number
string | null
required
gift_message
string | null
required
is_paid
boolean
required
Default:
false
promo_code
string | null
required
created_at
integer
required
unix time
updated_at
integer
required
unix time
cancelled_at
integer | null
required
unix time
completed_at
integer | null
required
unix time
donation_amount
integer
required
>= 0
Default:
0
confirmation_custom_message
string | null
required
Example
{
"id": 85,
"identifier": null,
"user_id": 17,
"channel_id": 1,
"outlet_id": 3,
"brand_id": null,
"fulfilment_type": "delivery",
"state": "unpaid",
"notes": null,
"serving_date": "2024-10-01",
"timeslot_start": 54000,
"timeslot_end": 55800,
"timeslot_range": "3:00PM–3:30PM",
"contact_name": "John",
"contact_email": "john@example.com",
"contact_number": "80000001",
"address_line1": "8 Temasek Boulevard",
"address_line2": "Suntec Tower 3",
"address_latitude": null,
"address_longitude": null,
"postal_code": "038988",
"is_gift": false,
"recipient_name": null,
"recipient_contact_number": null,
"gift_message": null,
"is_paid": false,
"promo_code": null,
"delivery_fee": 0,
"surcharge": 0,
"admin_discount": 0,
"discount": 0,
"tax": 0,
"tax_rate": "0.0",
"tax_inclusive_prices": false,
"subtotal": 0,
"total": 0,
"total_including_tax": 0,
"is_cutlery_required": false,
"is_contactless": false,
"created_at": 1727423000,
"updated_at": 1727423000,
"cancelled_at": 1727423000,
"completed_at": 1727423000,
"order_items": [
{
"id": 214,
"item_id": 380,
"name": "Coffee",
"quantity": 1,
"currency": "SGD",
"calculated_subtotal": 400,
"per_unit_quantity": 1,
"unit_label": null,
"notes": null,
"discount": 0,
"price_cents": 400,
"sub_items": [
{
"id": 215,
"item_id": 496,
"name": "Iced",
"quantity": 1,
"currency": "SGD",
"calculated_subtotal": 0,
"per_unit_quantity": 1,
"unit_label": null,
"notes": null,
"discount": 0,
"price_cents": 0
}
]
},
{
"id": 216,
"item_id": 480,
"name": "Eggs Benedict",
"quantity": 2,
"currency": "SGD",
"calculated_subtotal": 1600,
"per_unit_quantity": 1,
"unit_label": null,
"notes": null,
"discount": 0,
"price_cents": 1600,
"sub_items": []
}
]
}
🔴500Server Error
🟠401Unauthorized
🟠422Invalid Parameter
🟠422Configuration Required
Modified at 2025-04-02 05:44:27