Hotmart icon

Hotmart

Consume the Hotmart API

Subscription → Get Purchases

AI-generated

Summary

Retrieve subscriber purchase history from Hotmart with optional filters and pagination controls.

Inputs

  • Return All — Option to return all matching purchase records or limit to a specified number.
  • Limit — Maximum number of purchase records to return when not returning all.
  • Filters — Optional filters including End Date (Unix timestamp milliseconds), Product ID, Start Date (Unix timestamp milliseconds), and Subscriber Code to narrow the purchase history results.

Output shape

a list of purchase records matching the filter criteria and pagination settings

If 'Return All' is true, all matched purchases are returned; otherwise, results are limited to the specified 'Limit'. Filtering by date uses UNIX timestamps in milliseconds. Errors are thrown or returned based on node error handling settings.

Examples

Example 1: Get all purchases for a specific product within a date range

Set 'Return All' to true and apply 'Product ID', 'Start Date', and 'End Date' filters.

Example 2: Get up to 20 purchases for a subscriber by subscriber code

Set 'Return All' to false, 'Limit' to 20, and specify 'Subscriber Code' in filters.

Links

Discussion