curl --request GET \
--url https://app.herondata.io/api/transactions/{reference_id_or_heron_id} \
--header 'x-api-key: <api-key>'
{
"transaction_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 enriched transaction
curl --request GET \
--url https://app.herondata.io/api/transactions/{reference_id_or_heron_id} \
--header 'x-api-key: <api-key>'
{
"transaction_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"
}
}
OK
The response is of type object
.
Was this page helpful?