customerOrders query

The customerOrders query has been deprecated. Specify the orders object in the customer query instead.

The Sales module performs a wide variety of functions, including order, invoice, and shipment management. However, most of these functions are performed on the backend, and the customer does not have access to this information. By returning a list of customer orders, the customerOrders query allows a customer to retrieve their order histories.

Magento recommends you use customer tokens in the header of your GraphQL calls. However, you also can use session authentication.

Syntax

{customerOrders {CustomerOrders}}

Example usage

The following query returns the order history of the logged in customer.

Request:

1
2
3
4
5
6
7
8
9
10
11
{
  customerOrders {
    items {
      order_number
      id
      created_at
      grand_total
      status
    }
  }
}

Response:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
{
  "data": {
    "customerOrders": {
      "items": [
        {
          "order_number": "000000001",
          "id": 1,
          "created_at": "2019-02-21 00:24:34",
          "grand_total": 36.39,
          "status": "processing"
        },
        {
          "order_number": "000000002",
          "id": 2,
          "created_at": "2019-02-21 00:24:35",
          "grand_total": 39.64,
          "status": "closed"
        }
      ]
    }
  }
}

Output attributes

The CustomerOrders object contains the items attribute.

Attribute Data type Description
items [CustomerOrder] An array of customer orders

Customer order items attributes

The CustomerOrder object defines details about each order the customer has placed.

Attribute Data type Description
created_at String A timestamp indicating when the order was placed
gift_message GiftMessage The entered gift message for the order
grand_total Float The total of the order
id Int The ID assigned to the customer’s order
increment_id String Deprecated. Use order_number instead. An ID that indicates the sequence of the order in the customer’s order history
order_number String! The order number assigned to the order
status String The status of the order, such as open, processing, or closed

GiftMessage object

The GiftMessage object contains the following required attributes.

Attribute Data Type Description
to String! Recipient name
from String! Sender name
message String! Gift message text

Errors

Error Description
The current customer isn't authorized. The current customer is not currently logged in, or the customer’s token does not exist in the oauth_token table.