# Place a new order

Place a new order for one or more tickets. A single order can include multiple
ticket types of a single event, or from multiple events. When a new order is created
tickets are reserved for a fixed period of time until the order is settled, cancelled
or times out.

If the tickets being ordered are free (i.e. the order total is $0.00), the order is
fuliflled immediately and tickets delivered to the customer's account.

Endpoint: POST /orders
Version: 3.0.0
Security: SessionKey

## Request fields (application/json):

  - `customer` (string)
    Unique identifier of the account placing this order

  - `items` (object)
    Sections for which to order tickets. The object's keys are the URI of the event section for which tickets are being ordered, while its values are the number of tickets to order for the section.

## Response 201 fields (application/json):

  - `self` (string)
    URI of the order resource

  - `number` (string)
    Unique identifier of the order

  - `status` (string)
    Current status of the order

  - `placed` (string)
    The date and time at which the order was placed

  - `subtotal` (number)
    Total cost of the ordered items, before convenience fees are applied

  - `fees` (number)
    Total applicable convenience fees for this order

  - `total` (number)
    Total to be paid for this order inclusive of item costs (subtotal) and fees

  - `items` (array)
    List of items that were ordered

  - `items.number` (string)
    Unique identifier of the ordered item

  - `items.name` (string)
    Short name of the ordered item

  - `items.description` (string)
    Detailed description of the ordered item

  - `items.price` (number)
    Unit price of the ordered item

  - `items.quantity` (number)
    Number of instances of this item that were ordered

  - `customer` (object)
    Details of the user account that placed the order

  - `customer.self` (string)
    URI of the account resource

  - `customer.number` (string)
    Immutable identifier attached to the account

  - `customer.username` (string)
    Unique username attached to the account

  - `customer.email` (string)
    Unique email address attached to the account

  - `customer.role` (string)
    User role assigned to the account
    Enum: "customer", "support", "host", "administrator"

  - `customer.verified` (boolean)
    True if the account email address has been verified, false otherwise

  - `customer.activated` (boolean)
    True if the account is active, false if it has been deactivated

  - `customer.firstName` (string)
    The account holder's forename

  - `customer.lastName` (string)
    The account holder's surname

  - `customer.title` (string)
    The account holder's formal title
    Enum: "Mr", "Mrs", "Ms", "Mx"

  - `customer.dateOfBirth` (string)
    The account holder's date of birth

  - `customer.phone` (string)
    The account holder's primary contact number

  - `customer.country` (string)
    The country associated with the account (used for regionalisation)

  - `customer.firstAddressLine` (string)
    The first line of the account holder's address

  - `customer.secondAddressLine` (string)
    The second line of the account holder's address

  - `customer.city` (string)
    The city portion of the account holder's address

  - `customer.state` (string)
    The state, parish or district portion of the account holder's address

  - `customer.preferences` (string)
    URI of the account's user preferences resource

  - `payments` (string)
    URI of the collection of payments that settle this order

## Response 400 fields (application/json):

  - `message` (string)
    Reason for the given response.

## Response 403 fields (application/json):

  - `message` (string)
    Reason for the given response.