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

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Query Parameters

category_heron_id
string

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

Example:

"ctg_aoFa3HSXMTDoFNFVcfJ4dd"

category_label
string

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

Example:

"Revenue"

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"

to_currency
enum<string> | null

ISO 4217 currency code to convert to

Available options:
GBP,
USD,
EUR
Example:

"USD"

from_date
string | null

The earliest transaction timestamp date to use in forecasting

Example:

"2022-01-01"

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_B3LVx9kxzYLMJokv4wm8Dd"

date_granularity
enum<string>
default:month

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

Available options:
week,
month
Example:

"month"

to_date
string | null

The latest transaction timestamp date to use in forecasting

Example:

"2022-01-31"

Response

200 - application/json
OK
currency
string | null

ISO 4217 currency code

Required string length: 3
Example:

"USD"

date
string

Forecast date at specified date granularity

Example:

"2025-04-15"

predicted
number

Predicted amount

Example:

42.42

predicted_lower
number

Predict amount lower bound

Example:

4.24

predicted_upper
number

Predicted amount upper bound

Example:

420.42