Stripe - Get Invoices

Description

This module allows you to query invoices generated in Stripe. You can get a specific invoice or list multiple with filters by customer, subscription, status, and dates.

Configuration

Required Credentials

• Secret Key: Stripe secret key

Parameters

Parameter	Type	Required	Description
credentials_id	credential	Yes	Stripe credentials
invoice_id	string	No	Specific ID (in_xxx)
customer_id	string	No	Filter by customer
subscription_id	string	No	Filter by subscription
status	select	No	Filter by status
created_gte	string	No	Created after (Unix timestamp)
created_lte	string	No	Created before (Unix timestamp)
limit	number	No	Results limit (default: 10)
starting_after	string	No	Last object ID for pagination

Invoice Statuses

• draft: Draft
• open: Open (pending payment)
• paid: Paid
• uncollectible: Uncollectible
• void: Voided

Output

{
  "success": true,
  "invoices": [...],
  "count": 10,
  "has_more": true,
  "message": "10 facturas obtenidas"
}

Invoice Fields

• id: Invoice ID (in_xxx)
• number: Invoice number
• status: Status
• amount_due: Amount due
• amount_paid: Amount paid
• total: Invoice total
• currency: Currency
• customer_email: Customer email
• hosted_invoice_url: URL to pay online
• invoice_pdf: PDF URL
• due_date: Due date

Usage Example

Get by ID

{
  "invoice_id": "in_1MtHbELkdIwHu7ixl4OzzPMv"
}

Customer invoices

{
  "customer_id": "cus_NffrFeUfNV2Hib",
  "limit": 50
}

Pending invoices

{
  "status": "open"
}

Subscription invoices

{
  "subscription_id": "sub_1MowQVLkdIwHu7ixeRlqHVzs",
  "status": "paid"
}

API Used

• Endpoint: GET /v1/invoices
• Documentation: Stripe Invoices API

Notes

• hosted_invoice_url allows the customer to pay online
• invoice_pdf generates a downloadable PDF
• draft invoices are not visible to the customer
• Decimal amounts are added for convenience

Related Nodes

• StripeCreateInvoice - Create new invoices
• StripeGetCustomers - Get invoice customer data
• StripeGetSubscriptions - Get subscriptions that generate invoices