> This page is for Developer.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.bigcommerce.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.bigcommerce.com/_mcp/server.

# customerOrders

GraphQL QUERY

Get a list of orders for a BC customer.  
Requires a BC Token.

Reference: https://docs.bigcommerce.com/developer/api-reference/graphql/b2b/b2b-graphql/queries/customer-orders

## GraphQL Schema

```graphql
query ExampleQuery($channelId: Int, $offset: Int, $before: String, $after: String, $first: Int, $last: Int, $q: String, $companyId: Decimal, $bcOrderId: Decimal, $poNumber: String, $extraInt1: Decimal, $extraInt2: Decimal, $extraInt3: Decimal, $extraInt4: Decimal, $extraInt5: Decimal, $extraStr1: String, $extraStr2: String, $extraStr3: String, $extraStr4: String, $extraStr5: String, $beginDateAt: Date, $endDateAt: Date, $companyName: String, $search: String, $status: String, $email: String, $orderBy: String, $extraStr1_In: String, $isShowMy: String, $createdBy: String) {
  customerOrders(channelId: $channelId, offset: $offset, before: $before, after: $after, first: $first, last: $last, q: $q, companyId: $companyId, bcOrderId: $bcOrderId, poNumber: $poNumber, extraInt1: $extraInt1, extraInt2: $extraInt2, extraInt3: $extraInt3, extraInt4: $extraInt4, extraInt5: $extraInt5, extraStr1: $extraStr1, extraStr2: $extraStr2, extraStr3: $extraStr3, extraStr4: $extraStr4, extraStr5: $extraStr5, beginDateAt: $beginDateAt, endDateAt: $endDateAt, companyName: $companyName, search: $search, status: $status, email: $email, orderBy: $orderBy, extraStr1_In: $extraStr1_In, isShowMy: $isShowMy, createdBy: $createdBy) {
    pageInfo {
      hasNextPage
      hasPreviousPage
      startCursor
      endCursor
    }
    edges {
      node
      cursor
    }
    totalCount
  }
}
```

## Variables

```json
{
  "channelId": null,
  "offset": 0,
  "before": "example",
  "after": "example",
  "first": 0,
  "last": 0,
  "q": "example",
  "companyId": 0,
  "bcOrderId": 0,
  "poNumber": "example",
  "extraInt1": 0,
  "extraInt2": 0,
  "extraInt3": 0,
  "extraInt4": 0,
  "extraInt5": 0,
  "extraStr1": "example",
  "extraStr2": "example",
  "extraStr3": "example",
  "extraStr4": "example",
  "extraStr5": "example",
  "beginDateAt": "2026-10-23",
  "endDateAt": "2026-10-23",
  "companyName": "example",
  "search": "example",
  "status": "example",
  "email": "example",
  "orderBy": "example",
  "extraStr1_In": "example",
  "isShowMy": "example",
  "createdBy": "example"
}
```