Sign in

v1

latestOpenAPI 3.0.02026-07-26224386470.0 KB
EnrichedTransactions

Get end user transactions

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

get/api/end_users/{end_user_id_or_heron_id}/transactions

Path parameters

end_user_id_or_heron_idstring required

Query parameters

last_updated_minstring date-time nullable
Example:2026-07-23T19:53:47.166832

Filter for transactions whose values were last updated in Heron systems after the specified input value, isoformat

pageinteger

Results page

per_pageinteger

Desired results per page

account_idsstring[] nullable

Account ids to include. If not provided, all accounts are included

[
  "1234"
]
category_heron_idstring[] nullable

Filter by the heron_id of the category that the transaction is annotated with

order_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'

What to order transactions by

Response

OK

Example response

{
  "transactions_enriched": [
    {
      "account_id": "checking_account_202348",
      "account_number": "1234567890",
      "amount": -42.42,
      "annotation": {
        "category": {
          "heron_id": "ctg_5YuNdaG2cyxnq4mZnxq8n9",
          "label": "Rent"
        }
      },
      "balance": 423,
      "categories_default": "shopping",
      "counterparty": "GOOGLE",
      "currency": "USD",
      "data_source_account_heron_id": "dsa_7qXzcpwgh3LWqqcTXGDXsR",
      "data_source_heron_id": "dso_DP4WaqdeRYBPM9z6Rb8r5y",
      "date": "2020-04-27",
      "description": "GOOGLE *ADS12340929 cc@google.com US",
      "end_user_id": "my_best_customer_203948",
      "features": {
        "description_clean": "GOOGLE ADS",
        "duplicate_of_id": "txn_B2AhGvaqL2rWHrUWsArPMp"
      },
      "heron_id": "txn_Yqsbw75xpkSRPK4Ap5Mrvi",
      "last_updated": "2026-07-23T19:53:52.983551+00:00",
      "merchant": {
        "categories": [
          {
            "code": "7311",
            "description": "Advertising services",
            "slug": "advertising_services"
          }
        ],
        "heron_id": "mrc_gkcx4tKTGc2T5v2QiJVuMV"
      },
      "reference_id": "my_favourite_transaction_231098",
      "request_id": "req_drEXA6Vv9ueRURxJXrbVR8",
      "timestamp": "2021-11-12T10:38:05Z",
      "transaction_code": "card"
    }
  ]
}