---
title: Query list subscriptions
slug: data-platform/docs/list-subscription-querying
docTags: 
createdAt: 2026-08-10T12:05:15.000Z
---

To query list subscriptions for a specific customer, use the `list_member` object to search for a specific `list_id`. For example, if you have a newsletter list with `list_id = newsletter_list`, you can run the following query to check if a customer is subscribed to that list.

```graphql
customer(email: "rachel.green@example.com") {
    list_member(list_id: "newsletter_list") {
      subscribed
    }
  }
```

You receive the following response:

```graphql
{
  "data": {
    "customer": {
      "list_member": {
        "subscribed": true
      }
    }
  }
}
```

You can also query list subscriptions for multiple lists by using aliases, shown below:

```graphql
customer(email: "rachel.green@example.com") {
    newsletter_list: list_member(list_id: "newsletter_list") {
      subscribed
    }
    tv_list: list_member(list_id: "tv_hot_prices_list") {
      subscribed
    }
  }
```

Which returns list subscription details in the response:

```graphql
{
  "data": {
    "customer": {
      "newsletter_list": {
        "subscribed": true
      },
      "tv_list": {
        "subscribed": true
      }
    }
  }
}
```

If a user is not subscribed to the list that you query, you receive a null value in response. For example, if the customer is not subscribed to the `list_without_subscribers` list and you make the following request:

```graphql
customer(email: "rachel.green@example.com") {
    list_member(list_id: "list_without_subscribers") {
      subscribed
    }
  }
```

The following result is returned:

```graphql
{
  "data": {
    "customer": {
      "list_member": null
    }
  }
}
```

:::hint{type="info"}
**Requried field**
`list_id` is required in the `list_member` object.
:::