List all customer invoices

1 min

GET

https://app.amberflo.io/payments/billing/customer-product-invoice/all

Retrieves all invoices for a specific customer with detailed usage and billing information. Use this endpoint to access complete invoice history for billing analysis and payment tracking.

Use this endpoint to:

Get complete invoice history for a customer
Analyze billing patterns and usage trends
Check payment status via the paymentStatus field
Export invoice data for accounting purposes

customerIdstringUnique identifier of the customer whose invoices should be retrieved. This parameter is required to identify which customer's invoice history to access.

productIdstringUnique identifier for the specific product to filter invoices. If not provided, defaults to the account's default product ID ("1").

startTimeInSecondsinteger<int64>Unix timestamp (in seconds) to filter invoices from this start time. Only invoices at or after this time will be included in the results.

endTimeInSecondsinteger<int64>Unix timestamp (in seconds) to filter invoices up to this end time. Only invoices before or at this time will be included in the results.

fromCachebooleanWhether to return cached invoice data for faster response times. Set to false to force fresh data retrieval with latest payment status updates.

200Returns array of all customer invoices with detailed usage and payment information

400Invalid customer ID or query parameters provided

401Authentication required or invalid API key provided

403Insufficient permissions to access customer invoice data

404Customer not found or no invoices available

500Internal server error occurred while retrieving invoice data

curl --request GET \
     --url 'https://app.amberflo.io/payments/billing/customer-product-invoice/all?customerId=customer_123&productId=1&fromCache=true' \
     --header 'accept: application/json'