Stripe - Get Customers

Description

This module allows you to query customers registered in Stripe. You can get a specific customer by ID or list customers with email and date filters.

Configuration

Required Credentials

• Secret Key: Stripe secret key (sk_live_… or sk_test_…)

Parameters

Parameter	Type	Required	Description
credentials_id	credential	Yes	Stripe credentials
customer_id	string	No	Customer ID (cus_xxx)
email	string	No	Filter by exact email
created_gte	string	No	Created after (Unix timestamp)
created_lte	string	No	Created before (Unix timestamp)
limit	number	No	Results limit (default: 10, max: 100)
starting_after	string	No	Last object ID for pagination

Output

{
  "success": true,
  "customers": [...],
  "count": 10,
  "has_more": true,
  "message": "10 clientes obtenidos"
}

Customer Fields

• id: Customer ID (cus_xxx)
• email: Email
• name: Name
• phone: Phone
• description: Description
• created: Creation date (timestamp)
• default_source: Default payment source
• invoice_settings: Invoice settings
• metadata: Custom metadata

Usage Example

Get customer by ID

{
  "customer_id": "cus_NffrFeUfNV2Hib"
}

Search by email

{
  "email": "cliente@email.com"
}

Customers from last month

{
  "created_gte": "1704067200",
  "limit": 50
}

API Used

• Endpoint: GET /v1/customers and GET /v1/customers/{id}
• Documentation: Stripe Customers API

Notes

• Timestamps must be in Unix format (seconds since epoch)
• Pagination uses cursor-based with starting_after
• Maximum limit per page is 100 customers

Related Nodes

• StripeCreateCustomer - Create new customers
• StripeUpdateCustomer - Update an existing customer’s data
• StripeCreateSubscription - Create subscriptions for the customer
• StripeCreatePaymentIntent - Create payments for the customer
• StripeGetInvoices - Get customer invoices