This is a beta release of documentation for Magento 2.4, published for previewing soon-to-be-released functionality. Content in this version is subject to change. Links to the v2.4 code base may not properly resolve until the code is officially released.

customerOrders query

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
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

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.