> ## Documentation Index
> Fetch the complete documentation index at: https://www.plain.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# customerCardInstances

> Returns the current customer card instances for a customer, triggering a fresh load for any cards that are expired or in an error state.

Cards that are cached and within their TTL are returned immediately as `CustomerCardInstanceLoaded`. Cards that need
to be fetched are returned as `CustomerCardInstanceLoading`; subscribe to `customerCardInstanceChanges` to receive
the result when loading completes. Pass `threadId` to provide thread context to your card API endpoint.

A maximum of 25 card instances will be returned, due to only allowing 25 customer card configs.