GET
/
api
/
end_users
/
{end_user_id_or_heron_id}
/
heron_score
curl --request GET \
  --url https://app.herondata.io/api/end_users/{end_user_id_or_heron_id}/heron_score \
  --header 'Authorization: Basic <encoded-value>'
{
  "data_quality_issues": [
    "transactions_without_timestamps"
  ],
  "feature_groups_contributions": {},
  "predicted_at": "2023-11-07T05:31:56Z",
  "reference_timestamp": "2023-11-07T05:31:56Z",
  "status": "not_available",
  "value": 123
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
end_user_id_or_heron_id
string
required

Query Parameters

​
date
string | null

Cut-off date to consider transactions to for calculating heron score (inclusive)

Example:

"2023-01-19"

​
min_category_confidence
number | null

Minimum company categorisation confidence to calculate Heron Score

Example:

0.8

Response

200 - application/json
OK
​
data_quality_issues
enum<string>[]

A list of data quality issues that may have impacted the score

Available options:
transactions_without_timestamps,
date_range_too_low,
confidence_too_low,
ctg_coverage_too_low,
data_volume_too_low,
data_not_fresh
​
feature_groups_contributions
object
​
predicted_at
string

When the Heron Score was predicted

​
reference_timestamp
string

When the Heron Score was calculated for; by default the last transaction timestamp for the company

​
status
enum<string>
Available options:
not_available,
partially_available,
available
​
value
integer

The Heron Score value

Was this page helpful?

Get EndUser transactions grouped by counterparty or merchantGet EndUser industry