# View order history

Retrieve the order history of the specified account.

Endpoint: GET /accounts/{number}/orders
Version: 3.0.0
Security: SessionKey

## Path parameters:

  - `number` (string, required)
    Alphanumeric identifier of the user account

## Query parameters:

  - `records` (integer)
    The number of records per page that should be returned

  - `page` (integer)
    The number of the results page to return

  - `status` (string)
    If set, only returns orders with the specified status
    Enum: "Placed", "Cancelled", "Timed Out", "Fulfilled", "Voided", "Returned"

## Response 200 fields (application/json):

  - `total` (integer)
    The total number of results available

  - `page` (integer)
    The number of the results page returned

  - `records` (integer)
    The maximum number of results returned per page

  - `entries` (array)
    List of orders matching the given criteria

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

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

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

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

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

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

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

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

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

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

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

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

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

## Response 404 fields (application/json):

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