---
title: "segmentFilters"
description: "Segmented recommendation list"
doc_type: graphql
doc_category: adminGraphQL
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/docs/admin-graph-ql-api/customers/queries/segment-filters'
  md: 'https://developer.shopline.com/docs/admin-graph-ql-api/customers/queries/segment-filters.md'
---
# segmentFilters

Segmented recommendation list

- **Required Scopes:** `read_customers`
- **API Version:** v20270301
- **API Type:** Admin
- **API Protocol:** GraphQL
- **Operation Type:** Query

## Type Signature

`SegmentFilterConnection`

## Required Permissions

* `read_customers`

An access token is required to call this API. Refer to [Authorization](https://developer.shopline.com/docs/apps/api-instructions-for-use/graph-ql-admin-api/overview.md) for more information about how to obtain the token.

## Arguments

* `after`

  [String](https://developer.shopline.com/docs/admin-graph-ql-api/common/scalars/string.md)

  Returns elements following the specified cursor. The `first` argument must also be specified when using this argument.

* `before`

  [String](https://developer.shopline.com/docs/admin-graph-ql-api/common/scalars/string.md)

  Returns elements preceding the specified cursor. The `last` argument must also be specified when using this argument.

* `first`

  [Int](https://developer.shopline.com/docs/admin-graph-ql-api/common/scalars/int.md)

  Returns the first n elements in the list. 

* `last`

  [Int](https://developer.shopline.com/docs/admin-graph-ql-api/common/scalars/int.md)

  Returns the last n elements in the list. 

* `reverse`

  [Boolean](https://developer.shopline.com/docs/admin-graph-ql-api/common/scalars/boolean.md)

  Whether to reverse the order of the list. 
  
  ● true: reverse
  
  ● false: do not reverse
  
  Default value: false

## Returns

* `edges`

  [[SegmentFilterEdge!]](https://developer.shopline.com/docs/admin-graph-ql-api/customers/objects/segment-filter-edge.md)

  edge list

* `nodes`

  [[SegmentFilter]](https://developer.shopline.com/docs/admin-graph-ql-api/customers/objects/segment-filter.md)

  node list

* `pageInfo`

  [PageInfo!](https://developer.shopline.com/docs/admin-graph-ql-api/common-objects/objects/page-info.md)

  Information to aid in pagination.

## Code Example

```graphql
 {
	segmentFilters(after, before, first, last, reverse ) 
		 {
			# SegmentFilterConnection fields
		}
}
```

## Examples

### Segmented recommendation list

Segmented recommendation list

**Request:**

```json
query {
  segmentFilters(first: 2, after:null,reverse:false) {
    edges {
      node {
        queryName
        queryValue
      }
    }
    nodes {
        queryName
        queryValue
    }
    pageInfo {
        endCursor
        hasNextPage
        hasPreviousPage
        startCursor
    }
  }
}

```

**Response:**

```json
{
  "data": {
    "data": {
      "segmentFilters": {
        "edges": [
          {
            "node": {
              "queryName": "emailDomain",
              "queryValue": "{\"key\":\"emailDomain\",\"type\":0,\"operator\":\"IN\",\"value\":[],\"extInfo\":{\"operatorType\":\"EQ\",\"componentType\":\"LIST_PAGE\",\"listSource\":\"emailDomain\"}}"
            }
          },
          {
            "node": {
              "queryValue": "{\"key\":\"language\",\"type\":0,\"operator\":\"IN\",\"value\":[],\"extInfo\":{\"operatorType\":\"EQ\",\"componentType\":\"LIST\",\"listSource\":\"language\"}}",
              "queryName": "language"
            }
          }
        ],
        "nodes": [
          {
            "queryName": "emailDomain",
            "queryValue": "{\"key\":\"emailDomain\",\"type\":0,\"operator\":\"IN\",\"value\":[],\"extInfo\":{\"operatorType\":\"EQ\",\"componentType\":\"LIST_PAGE\",\"listSource\":\"emailDomain\"}}"
          },
          {
            "queryName": "language",
            "queryValue": "{\"key\":\"language\",\"type\":0,\"operator\":\"IN\",\"value\":[],\"extInfo\":{\"operatorType\":\"EQ\",\"componentType\":\"LIST\",\"listSource\":\"language\"}}"
          }
        ],
        "pageInfo": {
          "hasPreviousPage": false,
          "startCursor": "39C77C6A85E202FDAAB6A0D829D4F007",
          "endCursor": "AF52536A1951B28A30AAE8825A2B69B9",
          "hasNextPage": true
        }
      }
    }
  }
}
```

## Error Handling

For detailed information about common codes, see [Status and error codes](https://developer.shopline.com/docs/apps/api-instructions-for-use/graph-ql-admin-api/overview.md#status-and-error-codes).