## List

`v1.customers.list(CustomerListParams**kwargs)  -> SyncCursorPage[CustomerDetail]`

**get** `/v1/customers`

List all customers.

### Parameters

- **customer\_ids:** `List[str]`

  Filter the customer list by customer_id.  Up to 100 ids can be provided.

- **ingest\_alias:** `str`

  Filter the customer list by ingest_alias

- **limit:** `int`

  Max number of results that should be returned

- **next\_page:** `str`

  Cursor that indicates where the next page of results should start.

- **only\_archived:** `bool`

  Filter the customer list to only return archived customers. By default, only active customers are returned.

- **salesforce\_account\_ids:** `List[str]`

  Filter the customer list by salesforce_account_id.  Up to 100 ids can be provided.

### Returns

- `CustomerDetail`

### Example

```python
from metronome import Metronome

client = Metronome(
    bearer_token="My Bearer Token",
)
page = client.v1.customers.list()
page = page.data[0]
print(page.id)
```