---
title: CustomerSegmentMembersQuery - GraphQL Admin
description: A job to determine a list of members, such as customers, that are associated with an individual segment.
api_version: 2025-10
api_name: admin
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/latest/objects/customersegmentmembersquery
  md: https://shopify.dev/docs/api/admin-graphql/latest/objects/customersegmentmembersquery.md
---

# Customer​Segment​Members​Query

object

Requires `read_customers` access scope. Also: The user must not have restricted access.

A job to determine a list of members, such as customers, that are associated with an individual segment.

## Fields

* current​Count

  [Int!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Int)

  non-null

  The current total number of members in a given segment.

* done

  [Boolean!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean)

  non-null

  This indicates if the job is still queued or has been run.

* id

  [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID)

  non-null

  A globally-unique ID that's returned when running an asynchronous mutation.

***

## Map

No referencing types

***

## Queries

* [customer​Segment​Members​Query](https://shopify.dev/docs/api/admin-graphql/latest/queries/customerSegmentMembersQuery)

  query

  Returns a `CustomerSegmentMembersQuery` resource by ID.

***

## \<?>CustomerSegmentMembersQuery Queries

### Queried by

* \<?>[customer​Segment​Members​Query](https://shopify.dev/docs/api/admin-graphql/latest/queries/customerSegmentMembersQuery)

***

## Mutations

* [customer​Segment​Members​Query​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerSegmentMembersQueryCreate)

  mutation

  Creates a customer segment members query.

***

## <\~> CustomerSegmentMembersQuery Mutations

### Mutated by

* <\~>[customer​Segment​Members​Query​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerSegmentMembersQueryCreate)

***

## Interfaces

* * [Job​Result](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/JobResult)

    interface

  * [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)

    interface

***

## ||-CustomerSegmentMembersQuery Implements

### Implements

* ||-[Job​Result](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/JobResult)
* ||-[Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)