## List

**get** `/v1/express`

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

### Query Parameters

- `cursor: optional string`

  Base64 encoded cursor from previous response

- `limit: optional number`

  Number of results to return (1-100)

### Returns

- `expressCustomers: array of object { createdAt, expressCustomerId, expressCustomerName, 6 more }`

  - `createdAt: string`

    Timestamp when the Express customer was created

  - `expressCustomerId: string`

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

  - `expressCustomerName: string`

    Name of the Express customer

  - `isActive: boolean`

    Whether the Express customer is currently active

  - `updatedAt: string`

    Timestamp when the Express customer was last updated

  - `userCount: number`

    Number of users currently in this Express customer

  - `createdByApiKeyId: optional string`

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

  - `createdByUserId: optional string`

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

  - `metadata: optional map[string]`

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

- `hasMore: boolean`

- `cursor: optional string`

### Example

```http
curl https://api.avarasoftware.com/v1/express \
    -H "Authorization: Bearer $AVARA_API_KEY"
```