---
title: "Enrichment Data-Rich Webhook"
method: POST
path: "enrichmentData"
tags: ["Webhooks"]
---

# Enrichment Data-Rich Webhook

`POST enrichmentData` (webhook)

Data-rich Transaction Enrichment webhook. When transaction enrichment completes, you will receive a POST request containing the full enriched transaction data directly in the payload.

This webhook type (`ENRICHMENT_DATA`) sends the complete enrichment results, including all enriched transactions and any failed transactions.

Use this webhook type when you want to receive enrichment results directly without needing to fetch them from a separate endpoint.

## Headers

- `X-Webhook-Verification` string

## Payload

- object
  - `enrichedTransactions` WebhookConfigurationsTestPostENRICHMENTDATA
    - `enrichedTransactions` object[]
      - `accountid` string — The ID of the account associated with the transaction
      - `accountType` string — The type of account associated with the transaction (e.g., 'checking', 'savings')
      - `amountnum` number — The transaction's USD amount
      - `category` string — The most applicable categorization for the transaction
      - `categoryId` number — The numeric ID of the transaction's category
      - `categoryLabel` string[] — A cascading hierarchy of the transaction's categories, from high-level to detail-level categorization. This field is deprecated and not recommended for use, as it may not reflect more correct information available in other 'category' fields.
      - `address` string, nullable — The address associated with the transaction
      - `city` string, nullable — The city associated with the transaction
      - `client_id` string — Your FinGoal client ID
      - `container` string, nullable — A high-level categorization of the account type. Eg, 'bank'
      - `date` string, date-time — The date on which the transaction took place
      - `detailCategoryId` number — The numeric ID of the transaction's detail category
      - `guid` string — The transaction's globally unique FinSight API issued ID
      - `highLevelCategoryId` number — The numeric ID of the transaction's high level category
      - `isPhysical` boolean, nullable — Whether the transaction was made at a physical location, or online
      - `isRecurring` boolean, nullable — This field is deprecated. Denotes whether the transaction is set to recur on a fixed interval
      - `merchantAddress1` string, nullable — The street address of the merchant associated with the transaction
      - `merchantCity` string, nullable — The name of the city where the merchant is located
      - `merchantCountry` string, nullable — The name of the country where the merchant is located
      - `merchantLatitude` string, nullable — The latitude of the merchant
      - `merchantLogoURL` string — The URL resource for the merchant's logo
      - `merchantLongitude` string, nullable — The longitude of the merchant
      - `merchantName` string, nullable — The name of the merchant associated with the transaction
      - `merchantPhoneNumber` string, nullable — The phone number of the merchant associated with the transaction
      - `merchantState` string, nullable — The name of the state where the merchant is located
      - `merchantType` string, nullable — The merchant's type
      - `merchantZip` string, nullable — The ZIP code where the merchant is located
      - `original_description` string — The transaction description as received. This will not change
      - `receiptDate` string, date-time, nullable — The date on which FinSight API first received the transaction
      - `requestId` string, nullable — A unique ID for the request the transaction came in with, for debugging purposes
      - `simple_description` string — An easy-to-understand, plain-language transaction description
      - `simpleDescription` string — An easy-to-understand, plain-language transaction description
      - `settlement` string, nullable — The settlement type of the transaction (e.g., 'debit' or 'credit')
      - `sourceId` string, nullable — The source of the transaction
      - `state` string, nullable — The state associated with the transaction
      - `subtype` string, nullable — A more detailed classification of the transaction
      - `subType` string, nullable — A more detailed classification that provides further information on the type of transaction.
      - `tenant_id` string, nullable — The ID of the tenant associated with this transaction, if one was included.
      - `transactionid` string — The ID of the transaction as it was originally submitted
      - `transactionTags` string[] — The FinSight API issued tags for the transaction
      - `transactionTagsId` integer[] — The numeric IDs corresponding to the transaction tags
      - `type` string — An attribute describing the nature of the intent behind the transaction.
      - `uid` string — The ID of the user associated with the transaction, as originally submitted
      - `website` string, nullable — The merchant's website URL
      - `zip_code` string, nullable — The ZIP code associated with the transaction
    - `failedTransactions` object[]
      - `transactionid` string — The ID of the transaction as received.
      - `amountnum` number — The transaction's USD amount as received.
      - `original_description` string — The transaction description as received.
      - `uid` string — The ID of the user associated with the transaction, as received.
      - `date` string, date-time — The date on which the transaction took place as received.
      - `settlement` string — The transaction's settlement type as received.
      - `accountType` string — The type of account associated with the transaction as received.
  - `failedTransactions` WebhookConfigurationsTestPostENRICHMENTDATA
    - `enrichedTransactions` object[]
      - `accountid` string — The ID of the account associated with the transaction
      - `accountType` string — The type of account associated with the transaction (e.g., 'checking', 'savings')
      - `amountnum` number — The transaction's USD amount
      - `category` string — The most applicable categorization for the transaction
      - `categoryId` number — The numeric ID of the transaction's category
      - `categoryLabel` string[] — A cascading hierarchy of the transaction's categories, from high-level to detail-level categorization. This field is deprecated and not recommended for use, as it may not reflect more correct information available in other 'category' fields.
      - `address` string, nullable — The address associated with the transaction
      - `city` string, nullable — The city associated with the transaction
      - `client_id` string — Your FinGoal client ID
      - `container` string, nullable — A high-level categorization of the account type. Eg, 'bank'
      - `date` string, date-time — The date on which the transaction took place
      - `detailCategoryId` number — The numeric ID of the transaction's detail category
      - `guid` string — The transaction's globally unique FinSight API issued ID
      - `highLevelCategoryId` number — The numeric ID of the transaction's high level category
      - `isPhysical` boolean, nullable — Whether the transaction was made at a physical location, or online
      - `isRecurring` boolean, nullable — This field is deprecated. Denotes whether the transaction is set to recur on a fixed interval
      - `merchantAddress1` string, nullable — The street address of the merchant associated with the transaction
      - `merchantCity` string, nullable — The name of the city where the merchant is located
      - `merchantCountry` string, nullable — The name of the country where the merchant is located
      - `merchantLatitude` string, nullable — The latitude of the merchant
      - `merchantLogoURL` string — The URL resource for the merchant's logo
      - `merchantLongitude` string, nullable — The longitude of the merchant
      - `merchantName` string, nullable — The name of the merchant associated with the transaction
      - `merchantPhoneNumber` string, nullable — The phone number of the merchant associated with the transaction
      - `merchantState` string, nullable — The name of the state where the merchant is located
      - `merchantType` string, nullable — The merchant's type
      - `merchantZip` string, nullable — The ZIP code where the merchant is located
      - `original_description` string — The transaction description as received. This will not change
      - `receiptDate` string, date-time, nullable — The date on which FinSight API first received the transaction
      - `requestId` string, nullable — A unique ID for the request the transaction came in with, for debugging purposes
      - `simple_description` string — An easy-to-understand, plain-language transaction description
      - `simpleDescription` string — An easy-to-understand, plain-language transaction description
      - `settlement` string, nullable — The settlement type of the transaction (e.g., 'debit' or 'credit')
      - `sourceId` string, nullable — The source of the transaction
      - `state` string, nullable — The state associated with the transaction
      - `subtype` string, nullable — A more detailed classification of the transaction
      - `subType` string, nullable — A more detailed classification that provides further information on the type of transaction.
      - `tenant_id` string, nullable — The ID of the tenant associated with this transaction, if one was included.
      - `transactionid` string — The ID of the transaction as it was originally submitted
      - `transactionTags` string[] — The FinSight API issued tags for the transaction
      - `transactionTagsId` integer[] — The numeric IDs corresponding to the transaction tags
      - `type` string — An attribute describing the nature of the intent behind the transaction.
      - `uid` string — The ID of the user associated with the transaction, as originally submitted
      - `website` string, nullable — The merchant's website URL
      - `zip_code` string, nullable — The ZIP code associated with the transaction
    - `failedTransactions` object[]
      - `transactionid` string — The ID of the transaction as received.
      - `amountnum` number — The transaction's USD amount as received.
      - `original_description` string — The transaction description as received.
      - `uid` string — The ID of the user associated with the transaction, as received.
      - `date` string, date-time — The date on which the transaction took place as received.
      - `settlement` string — The transaction's settlement type as received.
      - `accountType` string — The type of account associated with the transaction as received.
  - `tenant_id` string — The ID of the tenant associated with this webhook, if from a tenant environment.

## Acknowledgement `200`

Success

## Other responses

- `201` — Success

---

[API](https://skmtc.dev/fingoal/apis/insights-api.md) · [All operations](https://skmtc.dev/fingoal/apis/insights-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fingoal/insights-api/revisions/00cf4dbd5441/schema)
