---
id: customers
title: customers
---

Lists customers, including discards where supported. Requires contacts:read.

```graphql
customers(
  after: String
  filter: CustomerFilter
  first: Int = 100
  updatedSince: DateTime
): CustomerCollection!
```

### Arguments

#### [`customers.after`](#after) · [`String`](/docs/developers/api-reference/management/v1/types/scalars/string) **scalar** {#after}

Opaque cursor from the previous page of this collection and filter.

#### [`customers.filter`](#filter) · [`CustomerFilter`](/docs/developers/api-reference/management/v1/types/inputs/customer-filter) **input** {#filter}

Optional record and relationship filters.

#### [`customers.first`](#first) · [`Int`](/docs/developers/api-reference/management/v1/types/scalars/int) **scalar** {#first}

Page size, clamped to 1–100.

#### [`customers.updatedSince`](#updated-since) · [`DateTime`](/docs/developers/api-reference/management/v1/types/scalars/date-time) **scalar** {#updated-since}

Inclusive modification timestamp for synchronization.

### Type

#### [`CustomerCollection`](/docs/developers/api-reference/management/v1/types/objects/customer-collection) **object**

A page of customers with continuation information.