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

# customerAddresses

GraphQL QUERY

The list of addresses registered to the user.  
Requires a BC Token.

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

## GraphQL Schema

```graphql
query ExampleQuery($offset: Int, $before: String, $after: String, $first: Int, $last: Int, $search: String, $firstName: String, $lastName: String, $country: String, $stateOrProvince: String, $city: String, $company: String) {
  customerAddresses(offset: $offset, before: $before, after: $after, first: $first, last: $last, search: $search, firstName: $firstName, lastName: $lastName, country: $country, stateOrProvince: $stateOrProvince, city: $city, company: $company) {
    pageInfo {
      hasNextPage
      hasPreviousPage
      startCursor
      endCursor
    }
    edges {
      node
      cursor
    }
    totalCount
  }
}
```

## Variables

```json
{
  "offset": 0,
  "before": "example",
  "after": "example",
  "first": 0,
  "last": 0,
  "search": "example",
  "firstName": "example",
  "lastName": "example",
  "country": "example",
  "stateOrProvince": "example",
  "city": "example",
  "company": "example"
}
```