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

# invoices

GraphQL QUERY

Get the list of invoices.  
Requires IP authentication.

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

## GraphQL Schema

```graphql
query ExampleQuery($companyIds: [Int], $offset: Int, $before: String, $after: String, $first: Int, $last: Int, $search: String, $orderBy: String, $invoiceNumber: String, $type: String, $orderNumber: String, $purchaseOrderNumber: String, $externalCustomerId: String, $storeHash: String, $externalId: String, $status: [String], $beginDateAt: Decimal, $endDateAt: Decimal, $idIn: String, $beginDueDateAt: Decimal, $endDueDateAt: Decimal) {
  invoices(companyIds: $companyIds, offset: $offset, before: $before, after: $after, first: $first, last: $last, search: $search, orderBy: $orderBy, invoiceNumber: $invoiceNumber, type: $type, orderNumber: $orderNumber, purchaseOrderNumber: $purchaseOrderNumber, externalCustomerId: $externalCustomerId, storeHash: $storeHash, externalId: $externalId, status: $status, beginDateAt: $beginDateAt, endDateAt: $endDateAt, idIn: $idIn, beginDueDateAt: $beginDueDateAt, endDueDateAt: $endDueDateAt) {
    pageInfo {
      hasNextPage
      hasPreviousPage
      startCursor
      endCursor
    }
    edges {
      node
      cursor
    }
    totalCount
  }
}
```

## Variables

```json
{
  "companyIds": [],
  "offset": 0,
  "before": "example",
  "after": "example",
  "first": 0,
  "last": 0,
  "search": "example",
  "orderBy": "example",
  "invoiceNumber": "example",
  "type": "example",
  "orderNumber": "example",
  "purchaseOrderNumber": "example",
  "externalCustomerId": "example",
  "storeHash": "example",
  "externalId": "example",
  "status": [
    "example"
  ],
  "beginDateAt": 0,
  "endDateAt": 0,
  "idIn": "example",
  "beginDueDateAt": 0,
  "endDueDateAt": 0
}
```