## List

`ExpressListPageResponse Express.List(ExpressListParams?parameters, CancellationTokencancellationToken = default)`

**get** `/v1/express`

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

### Parameters

- `ExpressListParams parameters`

  - `string cursor`

    Base64 encoded cursor from previous response

  - `Double limit`

    Number of results to return (1-100)

### Returns

- `class ExpressListPageResponse:`

  Paginated list of Express customers

  - `required IReadOnlyList<ExpressListResponse> ExpressCustomers`

    - `required DateTimeOffset? CreatedAt`

      Timestamp when the Express customer was created

    - `required string ExpressCustomerID`

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

    - `required string ExpressCustomerName`

      Name of the Express customer

    - `required Boolean IsActive`

      Whether the Express customer is currently active

    - `required DateTimeOffset? UpdatedAt`

      Timestamp when the Express customer was last updated

    - `required Long UserCount`

      Number of users currently in this Express customer

    - `string CreatedByApiKeyID`

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

    - `string CreatedByUserID`

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

    - `IReadOnlyDictionary<string, string> Metadata`

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

  - `required Boolean HasMore`

  - `string Cursor`

### Example

```csharp
ExpressListParams parameters = new();

var page = await client.Express.List(parameters);
await foreach (var item in page.Paginate())
{
    Console.WriteLine(item);
}
```