EndUserCalculations

Get EndUser forecasts

Get forecast amounts for a given EndUser and category

get/api/end_users/forecast

Request

Base URL
https://app.herondata.io
URL
https://app.herondata.io/api/end_users/forecast
Auth
API key in header x-api-key

Query parameters

end_user_idstring nullable

Example:your_end_user_id

end_user_id for statistics; either end_user_id or end_user_heron_id is required

end_user_heron_idstring nullable

Example:eus_e3h52yUnj6tsJs4nXdPuU8

Heron-generated id for end user; either end_user_id or end_user_heron_id is required

to_currency'GBP' | 'USD' | 'EUR' | 'CAD' | 'AUD' | 'null' nullable

Example:USD

ISO 4217 currency code to convert to

date_granularity'week' | 'month'

Example:month

Aggregate results over time, i.e., aggregate by week or by month

category_heron_idstring

Example:ctg_nAsTsMCcCzwACB7X5vubsm

Heron ID of category to be forecasted; either category_heron_id or category_label must be present

category_labelstring

Example:Revenue

Label of category to be forecasted; either category_heron_id or category_label must be present

from_datestring date nullable

Example:2022-01-01

The earliest transaction timestamp date to use in forecasting

to_datestring date nullable

Example:2022-01-31

The latest transaction timestamp date to use in forecasting

Response

currencystring nullable

ISO 4217 currency code

datestring

Forecast date at specified date granularity

predictednumber

Predicted amount

predicted_lowernumber

Predict amount lower bound

predicted_uppernumber

Predicted amount upper bound

Example response

[
  {
    "currency": "USD",
    "date": "2026-11-02",
    "predicted": 42.42,
    "predicted_lower": 4.24,
    "predicted_upper": 420.42
  }
]

Changes

No recorded changes to this operation across all 2 revisions of this API.