
Stripe Customer List
CertifiedList Stripe customers
Stripe Customer List
List Stripe customers
Lists customers with optional email filter and limit. Uses the provided secret key; outputs raw customer maps for further filtering.
type: io.kestra.plugin.stripe.customer.ListExamples
List the first 10 customers
id: list_customers
namespace: company.team
tasks:
- id: list_customers
type: io.kestra.plugin.stripe.customer.List
apiKey: "{{ secret('STRIPE_API_KEY') }}"
limit: 10
Installation
Our standard Docker images already include this plugin. If you use a -slim image or another setup, install it with the following command:
kestractl plugins get io.kestra.plugin:plugin-stripe --compatible-for $KESTRA_VERSION For kestractl, use your Kestra version with --compatible-for, or specify an exact plugin version.
For Kestra CLI, replace LATEST with a specific version or version range to pin the plugin version.
Properties
apiKey *string
Stripe API Key
Secret key for authenticating with Stripe. Starts with 'sk_' for live/test keys.
assets
Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.
io.kestra.core.models.assets.AssetsDeclaration
IGNOREFAILWARNAsset failure behavior
Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.
Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.
The assets consumed as inputs.
io.kestra.core.models.assets.AssetIdentifier
1The assets produced as outputs.
io.kestra.plugin.ee.assets.Dataset
1150{}1150io.kestra.plugin.ee.assets.File
1150{}1150io.kestra.plugin.ee.assets.Table
1150{}1150io.kestra.plugin.ee.assets.VM
1150{}1150io.kestra.core.models.assets.External
1150{}1150io.kestra.core.models.assets.Custom
11501Custom asset type
{}1150email string
Email filter
If set, returns customers whose email matches the value
limit integerstring
10Maximum customers to return
Defaults to 10; Stripe caps apply
Outputs
customers array
Customer objects
Each entry is the raw Stripe customer converted to a map
totalCount integer
Returned count