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_AjWKMcC9V8DGVDyZiiKxk5",
"label": "Rent"
},
"confidence": 123,
"model_version": "<string>"
},
"balance": 423,
"currency": "USD",
"data_source_account_heron_id": "dsa_EoNhoaajb7syqDDfMd8pFZ",
"data_source_heron_id": "dso_XHgqN4YivMkgnJoGbneUXY",
"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_VoSwyQUGG9rcQazeaWL7Cg",
"last_updated": "2025-06-19T18:49:43.634845",
"merchant": {
"categories": [
{
"code": "7311",
"description": "Advertising services",
"slug": "advertising_services"
}
],
"group_id": "Uber",
"heron_id": "mrc_Eajrnqvo7XUoiWkUrfcPRe",
"icon_url": "<string>",
"is_priority": true,
"logo_url": "<string>",
"name": "<string>",
"url": "<string>"
},
"reference_id": "my_favourite_transaction_231098",
"request_id": "req_8mfdnGzyyaWUqw7tzYioou",
"timestamp": "2021-11-12T10:38:05Z",
"transaction_code": "card"
}
]
}
Filter by the heron_id of the category that the transaction is annotated with
"ctg_YVEF7UQb878fFk6hQ8Zdwk"
Filter for transactions whose values were last updated in Heron systems after the specified input value, isoformat
"2025-06-19T18:49:44.807660"
Results page
x >= 1
Account ids to include. If not provided, all accounts are included
Desired results per page
1 <= x <= 50000
OK
The response is of type object
.
Was this page helpful?
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_AjWKMcC9V8DGVDyZiiKxk5",
"label": "Rent"
},
"confidence": 123,
"model_version": "<string>"
},
"balance": 423,
"currency": "USD",
"data_source_account_heron_id": "dsa_EoNhoaajb7syqDDfMd8pFZ",
"data_source_heron_id": "dso_XHgqN4YivMkgnJoGbneUXY",
"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_VoSwyQUGG9rcQazeaWL7Cg",
"last_updated": "2025-06-19T18:49:43.634845",
"merchant": {
"categories": [
{
"code": "7311",
"description": "Advertising services",
"slug": "advertising_services"
}
],
"group_id": "Uber",
"heron_id": "mrc_Eajrnqvo7XUoiWkUrfcPRe",
"icon_url": "<string>",
"is_priority": true,
"logo_url": "<string>",
"name": "<string>",
"url": "<string>"
},
"reference_id": "my_favourite_transaction_231098",
"request_id": "req_8mfdnGzyyaWUqw7tzYioou",
"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_AjWKMcC9V8DGVDyZiiKxk5",
"label": "Rent"
},
"confidence": 123,
"model_version": "<string>"
},
"balance": 423,
"currency": "USD",
"data_source_account_heron_id": "dsa_EoNhoaajb7syqDDfMd8pFZ",
"data_source_heron_id": "dso_XHgqN4YivMkgnJoGbneUXY",
"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_VoSwyQUGG9rcQazeaWL7Cg",
"last_updated": "2025-06-19T18:49:43.634845",
"merchant": {
"categories": [
{
"code": "7311",
"description": "Advertising services",
"slug": "advertising_services"
}
],
"group_id": "Uber",
"heron_id": "mrc_Eajrnqvo7XUoiWkUrfcPRe",
"icon_url": "<string>",
"is_priority": true,
"logo_url": "<string>",
"name": "<string>",
"url": "<string>"
},
"reference_id": "my_favourite_transaction_231098",
"request_id": "req_8mfdnGzyyaWUqw7tzYioou",
"timestamp": "2021-11-12T10:38:05Z",
"transaction_code": "card"
}
]
}
Filter by the heron_id of the category that the transaction is annotated with
"ctg_YVEF7UQb878fFk6hQ8Zdwk"
Filter for transactions whose values were last updated in Heron systems after the specified input value, isoformat
"2025-06-19T18:49:44.807660"
Results page
x >= 1
Account ids to include. If not provided, all accounts are included
Desired results per page
1 <= x <= 50000
OK
The response is of type object
.
Was this page helpful?
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_AjWKMcC9V8DGVDyZiiKxk5",
"label": "Rent"
},
"confidence": 123,
"model_version": "<string>"
},
"balance": 423,
"currency": "USD",
"data_source_account_heron_id": "dsa_EoNhoaajb7syqDDfMd8pFZ",
"data_source_heron_id": "dso_XHgqN4YivMkgnJoGbneUXY",
"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_VoSwyQUGG9rcQazeaWL7Cg",
"last_updated": "2025-06-19T18:49:43.634845",
"merchant": {
"categories": [
{
"code": "7311",
"description": "Advertising services",
"slug": "advertising_services"
}
],
"group_id": "Uber",
"heron_id": "mrc_Eajrnqvo7XUoiWkUrfcPRe",
"icon_url": "<string>",
"is_priority": true,
"logo_url": "<string>",
"name": "<string>",
"url": "<string>"
},
"reference_id": "my_favourite_transaction_231098",
"request_id": "req_8mfdnGzyyaWUqw7tzYioou",
"timestamp": "2021-11-12T10:38:05Z",
"transaction_code": "card"
}
]
}