---
title: "GET /api/transactions/{reference_id_or_heron_id}"
method: GET
path: "/api/transactions/{reference_id_or_heron_id}"
tags: ["EnrichedTransactions"]
---

# GET /api/transactions/{reference_id_or_heron_id}

`GET /api/transactions/{reference_id_or_heron_id}`

Get enriched transaction

## Path parameters

- `reference_id_or_heron_id` string, required

## Response `200`

OK

- object
  - `transaction_enriched` TransactionEnriched
    - `account_id` string, nullable — Your unique ID for account associated with transaction
    - `account_number` string, nullable — The account number of the data source account associated with the transaction
    - `amount` number, required — Amount. Inflows to an account should be positive, and outflows from an account should be negative. If using Plaid, please flip the amount sign for all transactions.
    - `annotation` Annotation
      - `annotator` AnnotatorPublic
        - `context` 'sync' | 'async_' | 'manual' | 'undetermined', required
        - `priority_type` 'gold_standard' | 'client_feedback' | 'tagging_ui' | 'reconcile' | 'heuristic' | 'classifier' | 'undetermined' | 'positions_detection', required
      - `category` Category1
        - `heron_id` string — Unique ID of the category generated by Heron Data
        - `label` string, required — The label of the category
      - `confidence` number
      - `model_version` string
    - `balance` number, nullable — The running balance of the account after transaction ocurred
    - `categories_default` string, nullable — Category of transaction that you may have received from other sources
    - `counterparty` string, nullable — The counterparty associated with the transaction, if available
    - `currency` string, nullable — ISO 4217 currency code
    - `data_source_account_heron_id` string, nullable — The heron ID of the data source account associated with the transaction
    - `data_source_heron_id` string, nullable — The heron ID of the data source associated with the transaction
    - `date` string, date, nullable — The date of the transaction; 'timestamp' field takes priority over 'date'
    - `description` string, required — The text description for the transaction
    - `end_user_id` string, nullable — Your unique ID for end user associated with transaction
    - `features` TransactionFeatures
      - `description_clean` string — The cleaned description of the transaction
      - `duplicate_of_id` string — Indicates that the transaction is a duplicate and gives the heron_id of the original
      - `has_matching_transaction` boolean — Whether the transaction is a transfer; requires end_user_id and timestamp to be present
      - `is_potential_duplicate` boolean — Indicates whether the transaction has another transaction similar to it
      - `is_recurring` boolean — Whether the transaction is recurring or not; requires end_user_id and timestamp to be present
    - `heron_id` string — Unique ID of transaction; generated by Heron Data
    - `last_updated` string, date-time — When the transaction was last updated, either by updating its enrichments or the values of the transaction itself
    - `mcc_code` string, nullable — Merchant category code associated with transaction that you may have received from other sources
    - `merchant` Merchant
      - `categories` MerchantCategory[]
        - `code` string, required
        - `description` string, nullable
        - `slug` string, nullable
      - `group_id` 'Uber' | 'Google' | 'Intuit' | 'debt.mca_or_rbf' | 'debt.non_bank_business' | 'debt.equipment_and_auto_leasing' | 'debt.mortgage' | 'debt.personal_non_mortgage' | 'debt.collections' | 'debt.bank' | 'invoice_factoring' | 'fuel_provider' | 'gambling_and_betting' | 'null', nullable
      - `heron_id` string
      - `icon_url` string, url, nullable
      - `is_priority` boolean
      - `logo_url` string, url, nullable
      - `name` string, required
      - `url` string, url, required
    - `order` integer, nullable — If sending a batch of transactions, the order in which the transaction occurs, where a higher value is equivalent to a more recent transaction
    - `reference_id` string, nullable — Your unique ID for transaction
    - `request_id` string, nullable — ID associated with request, e.g., all transactions in same POST request will have same request_id
    - `timestamp` string, date-time, nullable — The ISO 8601 timezone aware timestamp of the transaction; takes precedence over 'date'
    - `transaction_code` string, nullable — Code associated with transaction to indicate the type of transaction

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.dev/herondata/apis/heron-data-api.md) · [All operations](https://skmtc.dev/herondata/apis/heron-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/herondata/heron-data-api/revisions/f2e441edece2/schema)