GET
/
api
/
end_users
/
forecast
curl --request GET \
  --url https://app.herondata.io/api/end_users/forecast \
  --header 'x-api-key: <api-key>'
[
  {
    "currency": "USD",
    "date": "2025-04-30",
    "predicted": 42.42,
    "predicted_lower": 4.24,
    "predicted_upper": 420.42
  }
]

Authorizations

x-api-key
string
header
required

Query Parameters

to_currency
enum<string> | null

ISO 4217 currency code to convert to

Available options:
GBP,
USD,
EUR
Example:

"USD"

category_label
string

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

Example:

"Revenue"

to_date
string | null

The latest transaction timestamp date to use in forecasting

Example:

"2022-01-31"

date_granularity
enum<string>
default:month

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

Available options:
week,
month
Example:

"month"

from_date
string | null

The earliest transaction timestamp date to use in forecasting

Example:

"2022-01-01"

category_heron_id
string

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

Example:

"ctg_i9BespZffxRxXbYEmKDraX"

end_user_id
string | null

end_user_id for statistics; either end_user_id or end_user_heron_id is required

Example:

"your_end_user_id"

end_user_heron_id
string | null

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

Example:

"eus_FcjtxALUX8mtznFYBAbH7n"

Response

200 - application/json
OK

The response is of type object[].