Hotmart icon

Hotmart

Consume the Hotmart API

Sale → Get History

AI-generated

Summary

Retrieve sales history records filtered by various criteria such as buyer email, product ID, transaction status, and date range.

Inputs

  • Return All — Boolean to decide whether to return all results or limit the number of results.
  • Limit — Maximum number of results to return if Return All is false.
  • Filters — Optional collection of filters to narrow down sales history by buyer email, product ID, sales source, transaction code, transaction status, and a start/end date range (Unix timestamps in milliseconds).

Output shape

a list of sales history records matching the specified filters

Supports pagination internally; will return all items if 'Return All' is true, otherwise limits to the specified 'Limit'. The operation filters results to exclude empty or zero values for filter parameters. Errors may be returned in the output JSON if 'Continue On Fail' is enabled.

Examples

Example 1: Get up to 100 recent sales with transaction status 'APPROVED' for product ID 12345

Set Return All to false, Limit to 100, and in Filters set product_id to 12345 and transaction_status to 'APPROVED'.

Links

Discussion