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": [
{
"account_id": "checking_account_202348",
"account_number": "1234567890",
"amount": -42.42,
"annotation": {
"annotator": {
"context": "sync",
"priority_type": "gold_standard"
},
"category": {
"heron_id": "ctg_B6c6W6DszkN6aFQiBuciRw",
"label": "Rent"
},
"confidence": 123,
"model_version": "<string>"
},
"balance": 423,
"currency": "USD",
"data_source_account_heron_id": "dsa_TZoN7PnbDjN3eVuZjLHC6d",
"data_source_heron_id": "dso_KVyuM3qjk9SPgExhU5Jio7",
"description": "GOOGLE *ADS12340929 [email protected] US",
"end_user_id": "my_best_customer_203948",
"features": {
"description_clean": "GOOGLE ADS",
"duplicate_of_id": "<any>",
"has_matching_transaction": true,
"is_potential_duplicate": true,
"is_recurring": true
},
"heron_id": "txn_TH3Bt95AfxaFs9DHyuS8E3",
"last_updated": "2025-07-21T21:52:57.799435",
"merchant": {
"categories": [
{
"code": "7311",
"description": "Advertising services",
"slug": "advertising_services"
}
],
"group_id": "Uber",
"heron_id": "mrc_PezcquvDMiJMbLix2hFJVi",
"icon_url": "<string>",
"is_priority": true,
"logo_url": "<string>",
"name": "<string>",
"url": "<string>"
},
"reference_id": "my_favourite_transaction_231098",
"request_id": "req_jZDqcYrhi47QzAs8YQsemm",
"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": [
{
"account_id": "checking_account_202348",
"account_number": "1234567890",
"amount": -42.42,
"annotation": {
"annotator": {
"context": "sync",
"priority_type": "gold_standard"
},
"category": {
"heron_id": "ctg_B6c6W6DszkN6aFQiBuciRw",
"label": "Rent"
},
"confidence": 123,
"model_version": "<string>"
},
"balance": 423,
"currency": "USD",
"data_source_account_heron_id": "dsa_TZoN7PnbDjN3eVuZjLHC6d",
"data_source_heron_id": "dso_KVyuM3qjk9SPgExhU5Jio7",
"description": "GOOGLE *ADS12340929 [email protected] US",
"end_user_id": "my_best_customer_203948",
"features": {
"description_clean": "GOOGLE ADS",
"duplicate_of_id": "<any>",
"has_matching_transaction": true,
"is_potential_duplicate": true,
"is_recurring": true
},
"heron_id": "txn_TH3Bt95AfxaFs9DHyuS8E3",
"last_updated": "2025-07-21T21:52:57.799435",
"merchant": {
"categories": [
{
"code": "7311",
"description": "Advertising services",
"slug": "advertising_services"
}
],
"group_id": "Uber",
"heron_id": "mrc_PezcquvDMiJMbLix2hFJVi",
"icon_url": "<string>",
"is_priority": true,
"logo_url": "<string>",
"name": "<string>",
"url": "<string>"
},
"reference_id": "my_favourite_transaction_231098",
"request_id": "req_jZDqcYrhi47QzAs8YQsemm",
"timestamp": "2021-11-12T10:38:05Z",
"transaction_code": "card"
}
]
}
Filter for transactions whose values were last updated in Heron systems after the specified input value, isoformat
"2025-07-21T21:52:58.635975"
Account ids to include. If not provided, all accounts are included
Results page
x >= 1
What 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
Desired results per page
1 <= x <= 50000
Filter by the heron_id of the category that the transaction is annotated with
"ctg_63NdEZiniN8Pb2aM9UuagH"
OK
The response is of type object
.
Was this page helpful?