List customers with pagination

ExpressListPage express().list(, )

GET/v1/express

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

ParametersExpand Collapse

ExpressListParams params

Optional<String> cursor

Base64 encoded cursor from previous response

Optional<Double> limit

Number of results to return (1-100)

minimum1

maximum100

ReturnsExpand Collapse

class ExpressListResponse:

An Express customer entity that groups users and studies

Optional<LocalDateTime> createdAt

Timestamp when the Express customer was created

formatdate-time

String expressCustomerId

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

String expressCustomerName

Name of the Express customer

minLength1

boolean isActive

Whether the Express customer is currently active

Optional<LocalDateTime> updatedAt

Timestamp when the Express customer was last updated

formatdate-time

long userCount

Number of users currently in this Express customer

minimum0

Optional<String> createdByApiKeyId

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

formatuuid

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

List customers with pagination

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();
    }
}

{
  "expressCustomers": [
    {
      "createdAt": "2024-01-15T09:00:00Z",
      "expressCustomerId": "cus_1234567890abcdef1234567890abcdef",
      "expressCustomerName": "City Medical Center - Radiology Department",
      "isActive": true,
      "updatedAt": "2024-03-15T14:20:00Z",
      "userCount": 15,
      "createdByApiKeyId": "550e8400-e29b-41d4-a716-446655440000",
      "createdByUserId": "usr_1234567890abcdef1234567890abcdef",
      "metadata": {
        "department": "radiology",
        "region": "northeast"
      }
    }
  ],
  "hasMore": true,
  "cursor": "cursor"
}

Returns Examples

{
  "expressCustomers": [
    {
      "createdAt": "2024-01-15T09:00:00Z",
      "expressCustomerId": "cus_1234567890abcdef1234567890abcdef",
      "expressCustomerName": "City Medical Center - Radiology Department",
      "isActive": true,
      "updatedAt": "2024-03-15T14:20:00Z",
      "userCount": 15,
      "createdByApiKeyId": "550e8400-e29b-41d4-a716-446655440000",
      "createdByUserId": "usr_1234567890abcdef1234567890abcdef",
      "metadata": {
        "department": "radiology",
        "region": "northeast"
      }
    }
  ],
  "hasMore": true,
  "cursor": "cursor"
}