---
title: "Create order"
method: POST
path: "/orders"
tags: ["Order API", "publicly-accessible"]
---

# Create order

`POST /orders`

Create order

## Headers

- `x-je-api-version` number

## Request body

- OrderRequestV2
  - `Customer` CustomerV2, required
    - `Address` AddressV2, required
      - `City` string, required
      - `GeoLocation` LocationV2
        - `Latitude` number, double, required
        - `Longitude` number, double, required
      - `Lines` string[], required
      - `PostalCode` string, required
    - `DisplayPhoneNumber` string — If you implement phone masking provide a masked number here
    - `Email` string
    - `Name` string, required
    - `PhoneNumber` string, required — The customer's real phone number
  - `CustomerNotes` object
    - `NoteForDelivery` string
    - `NoteForRestaurant` string
  - `FriendlyOrderReference` string
  - `Fulfilment` FulfilmentV2, required
    - `DueAsap` boolean — If food should be delivered ASAP
    - `DueDate` string, date-time, required — The time the customer expects the food. Time must be in the future
    - `Method` 'Delivery' | 'Collection', required
  - `IsTest` boolean
  - `Items` ItemsV2[], required
    - `Items` ItemV2[]
      - `Items` ItemV2[]
      - `Name` string
      - `Quantity` integer
      - `Reference` string
      - `UnitPrice` integer
    - `Name` string, required
    - `Quantity` integer, required
    - `Reference` string, required — The item's ID that you hold
    - `TotalPrice` number, required — Price of this item x quantity and all sub items
    - `UnitPrice` integer
  - `OrderReference` string, required
  - `Payment` PaymentV2, required
    - `Fees` Fee[]
      - `Type` string
      - `Value` number
    - `Lines` LinesV2[], required
      - `LastCardDigits` string
      - `Paid` boolean
      - `ServiceFee` number, double
      - `Type` 'Cash' | 'Card' | 'AccountCredit' | 'Voucher', required
      - `Value` number
    - `PaidDate` string, date-time
    - `Taxes` TaxV2[]
      - `Percentage` number, double, required
      - `Type` string, required
      - `Value` number, required
    - `Tips` Fee[]
      - `Type` string
      - `Value` number
  - `Restaurant` union, required
    - object
      - `Id` integer — Our restaurant ID
    - object
      - `Reference` string — If we hold a mapping for your restaurant IDs to ours - use your ID here
  - `TotalPrice` number, double, required

## Response `201`

Created

- object
  - `OrderId` string

## Other responses

- `400` — Bad Request - Request is for deprecated API version or has failed validation in some way - see response body for details
- `409` — Conflict - you've already told us about an order with this `OrderReference`

---

[API](https://skmtc.net/justeat/apis/just-eat.md) · [All operations](https://skmtc.net/justeat/apis/just-eat/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/justeat/just-eat/revisions/49ff8eb806d9/schema)