## List

`ExpressListPage express().list(ExpressListParamsparams = ExpressListParams.none(), RequestOptionsrequestOptions = RequestOptions.none())`

**get** `/v1/express`

Retrieves a paginated list of customers with optional filtering by name. Returns up to 100 customers per request.

### Parameters

- `ExpressListParams params`

  - `Optional<String> cursor`

    Base64 encoded cursor from previous response

  - `Optional<Double> limit`

    Number of results to return (1-100)

### Returns

- `class ExpressListResponse:`

  An Express customer entity that groups users and studies

  - `Optional<LocalDateTime> createdAt`

    Timestamp when the Express customer was created

  - `String expressCustomerId`

    Unique Express customer identifier. Format: cus_{32-hex-chars}

  - `String expressCustomerName`

    Name of the Express customer

  - `boolean isActive`

    Whether the Express customer is currently active

  - `Optional<LocalDateTime> updatedAt`

    Timestamp when the Express customer was last updated

  - `long userCount`

    Number of users currently in this Express customer

  - `Optional<String> createdByApiKeyId`

    UUID of the API key used to create this Express customer, for audit tracking

  - `Optional<String> createdByUserId`

    User ID who created this Express customer via dashboard, null if created via API key

  - `Optional<Metadata> metadata`

    Custom key-value metadata for the Express customer. Maximum 50 pairs, keys up to 100 chars, values up to 1000 chars

### Example

```java
package com.avara.example;

import com.avara.client.AvaraClient;
import com.avara.client.okhttp.AvaraOkHttpClient;
import com.avara.models.express.ExpressListPage;
import com.avara.models.express.ExpressListParams;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        AvaraClient client = AvaraOkHttpClient.fromEnv();

        ExpressListPage page = client.express().list();
    }
}
```