curl --request GET \
--url https://app.herondata.io/api/end_users/{end_user_id_or_heron_id}/transactions \
--header 'x-api-key: <api-key>'{
"_meta": {
"next_url": "<string>",
"num_results": 123,
"page": 123,
"per_page": 123,
"prev_url": "<string>"
},
"transactions_enriched": [
{
"amount": -42.42,
"description": "GOOGLE *ADS12340929 [email protected] US",
"account_id": "checking_account_202348",
"account_number": "1234567890",
"annotation": {
"annotator": {
"context": "sync",
"priority_type": "gold_standard"
},
"category": {
"label": "Rent",
"heron_id": "ctg_APCVGT9SNofLxix94LeBPh"
},
"confidence": 123,
"model_version": "<string>"
},
"balance": 423,
"counterparty": "GOOGLE",
"currency": "USD",
"data_source_account_heron_id": "dsa_fbuF95zT2sTmqbP4ZeCZRX",
"data_source_heron_id": "dso_is39MKJXv6xHW6iqk8GA5y",
"end_user_id": "my_best_customer_203948",
"features": {
"description_clean": "GOOGLE ADS",
"duplicate_of_id": "txn_Fr5U34CvXFp5toXHt4Kkfn",
"has_matching_transaction": true,
"is_potential_duplicate": true,
"is_recurring": true
},
"heron_id": "txn_jPEzNLr8B8dqji7wc3Kpzh",
"last_updated": "2026-01-22T15:29:57.341448",
"merchant": {
"name": "<string>",
"url": "<string>",
"categories": [
{
"code": "7311",
"description": "Advertising services",
"slug": "advertising_services"
}
],
"group_id": "Uber",
"heron_id": "mrc_hxWgSHmwGxzGcHsxUzxfYS",
"icon_url": "<string>",
"is_priority": true,
"logo_url": "<string>"
},
"reference_id": "my_favourite_transaction_231098",
"request_id": "req_6mQPtQsRfmDSeGS5vvAg8z",
"timestamp": "2021-11-12T10:38:05Z",
"transaction_code": "card"
}
]
}Get all unique transactions for a single end user. Set end user status to “ready” to initiate transaction enrichment, otherwise may contain both enriched and unenriched transactions
curl --request GET \
--url https://app.herondata.io/api/end_users/{end_user_id_or_heron_id}/transactions \
--header 'x-api-key: <api-key>'{
"_meta": {
"next_url": "<string>",
"num_results": 123,
"page": 123,
"per_page": 123,
"prev_url": "<string>"
},
"transactions_enriched": [
{
"amount": -42.42,
"description": "GOOGLE *ADS12340929 [email protected] US",
"account_id": "checking_account_202348",
"account_number": "1234567890",
"annotation": {
"annotator": {
"context": "sync",
"priority_type": "gold_standard"
},
"category": {
"label": "Rent",
"heron_id": "ctg_APCVGT9SNofLxix94LeBPh"
},
"confidence": 123,
"model_version": "<string>"
},
"balance": 423,
"counterparty": "GOOGLE",
"currency": "USD",
"data_source_account_heron_id": "dsa_fbuF95zT2sTmqbP4ZeCZRX",
"data_source_heron_id": "dso_is39MKJXv6xHW6iqk8GA5y",
"end_user_id": "my_best_customer_203948",
"features": {
"description_clean": "GOOGLE ADS",
"duplicate_of_id": "txn_Fr5U34CvXFp5toXHt4Kkfn",
"has_matching_transaction": true,
"is_potential_duplicate": true,
"is_recurring": true
},
"heron_id": "txn_jPEzNLr8B8dqji7wc3Kpzh",
"last_updated": "2026-01-22T15:29:57.341448",
"merchant": {
"name": "<string>",
"url": "<string>",
"categories": [
{
"code": "7311",
"description": "Advertising services",
"slug": "advertising_services"
}
],
"group_id": "Uber",
"heron_id": "mrc_hxWgSHmwGxzGcHsxUzxfYS",
"icon_url": "<string>",
"is_priority": true,
"logo_url": "<string>"
},
"reference_id": "my_favourite_transaction_231098",
"request_id": "req_6mQPtQsRfmDSeGS5vvAg8z",
"timestamp": "2021-11-12T10:38:05Z",
"transaction_code": "card"
}
]
}Account ids to include. If not provided, all accounts are included
Desired results per page
1 <= x <= 50000What to order transactions by
amount_asc, amount_desc, abs_amount_asc, abs_amount_desc, description_asc, description_desc, timestamp_asc, timestamp_desc, id_asc, id_desc, confidence_asc, confidence_desc, created_asc, created_desc Filter for transactions whose values were last updated in Heron systems after the specified input value, isoformat
"2026-01-22T15:29:58.219986"
Results page
x >= 1Filter by the heron_id of the category that the transaction is annotated with
"ctg_HJRj7G7SPG5yRNwaY4Tur2"
Was this page helpful?