Categorize Transactions
Overview
The Categorize Transactions insight is a schedule-trigger insight that reminds users to categorize all the uncategorized transactions across all the aggregated bank and card accounts.
Following are the additional details for the insight:
| Insight Name | CATEGORIZE_TRANSACTIONS |
|---|---|
| Insight Type | AGGREGATE |
| Trigger Type | SCHEDULE |
| Supported Containers | BANK, CARD |
| Frequency | MONTHLY |
| Duration | LAST_THREE_MONTHS |
| Run Date | 10th day of the calendar month |
Use Cases
- Customer:
- Cleaner user data - Build a better financial picture of the user
- User:
- Better user experience
Suggested Action
Provide the user an option to edit the transaction and update the category using the following Yodlee API v1.1:
PUT /transactions/{transactionId}
Peer Benchmarking Data
This insight does not provide peer benchmarking data.
Sample UI
Insight Feed
Insight Widget and Details
GET Insight Feeds
The GET insights feed API retrieves all or a subset of the valid insight notifications generated for a particular user. However, using the insightName filter, the Categorize Transactions insight can be specifically requested.
The entityId filter does not apply to this insight.
Method and URL:
GET /insights/feed
Header Parameters:
| Key | Value | |
|---|---|---|
Authorization | Client credentials-based authorization | Bearer {{Access Token}} |
| API key-based authentication | Bearer {{JWT Token_Customer}} | |
| Deprecated cobrand and user credential-based authentication | cobSession={cobSession received in the cobrand login service}, userSession={userSession received in the user login service} | |
Content-Type | application/json | |
Api-Version | 3.0 | |
2.1 | ||
2 | ||
Cobrand-Name | {Name of the Customer} | |
Sample Request:
GET /insights/feed?insightName=CATEGORIZE_TRANSACTIONS
Sample Response:
For more information about the attributes that are returned in the API response, refer to the Insights Data Model page.
{
"feed":[
{
"id":"60d43dbed59fdb46b0c91207",
"insightName":"CATEGORIZE_TRANSACTIONS",
"insightTitle":"Categorize Transactions",
"insightType":"AGGREGATE",
"triggerType":"SCHEDULE",
"createdDate":"2025-06-10T08:09:31Z",
"subscription":[
{
"entityType":"ACCOUNT",
"frequency":"MONTHLY",
"duration":"LAST_THREE_MONTHS",
"threshold":[
{
"name":"BASETYPE",
"value":"CREDIT,DEBIT",
"type":"STRING"
}
]
}
],
"basicAccount":[
{
"id":13709572,
"providerName":"Dag Site",
"accountName":"PDV Test Data- All Category",
"accountType":"OTHER",
"isAsset":true,
"container":"bank",
"link":{
"entityName":"account",
"url":"/accounts?accountId=13709572"
},
"basicTransaction":[
{
"id":47307072,
"amount":{
"amount":180.75,
"currency":"USD"
},
"date":"2025-05-21",
"link":{
"entityName":"transaction",
"url":"/derived/transactions?transactionId=47307072"
},
"categoryId":19,
"category":"Other Expenses",
"categoryType":"EXPENSE",
"baseType":"DEBIT",
"description":{
"original":"fd29383d payment",
"simple":"fd29383d"
},
"sourceType":"AGGREGATED",
"merchantType":"OTHERS"
},
{
"id":47307071,
"amount":{
"amount":1344.75,
"currency":"USD"
},
"date":"2025-05-15",
"link":{
"entityName":"transaction",
"url":"/derived/transactions?transactionId=47307071"
},
"categoryId":32,
"category":"Other Income",
"categoryType":"INCOME",
"baseType":"CREDIT",
"description":{
"original":"May Income",
"simple":"May Income"
},
"sourceType":"AGGREGATED",
"merchantType":"OTHERS"
},
{
"id":47307070,
"amount":{
"amount":99.99,
"currency":"USD"
},
"date":"2025-04-28",
"link":{
"entityName":"transaction",
"url":"/derived/transactions?transactionId=47307070"
},
"categoryId":19,
"category":"Other Expenses",
"categoryType":"EXPENSE",
"baseType":"DEBIT",
"description":{
"original":"Uncategorized Transaction Description",
"simple":"Uncategorized"
},
"sourceType":"AGGREGATED",
"merchantType":"OTHERS"
},
{
"id":47307056,
"amount":{
"amount":1308.75,
"currency":"USD"
},
"date":"2025-04-15",
"link":{
"entityName":"transaction",
"url":"/derived/transactions?transactionId=47307056"
},
"categoryId":32,
"category":"Other Income",
"categoryType":"INCOME",
"baseType":"CREDIT",
"description":{
"original":"Payment to J",
"simple":"Payment to J"
},
"sourceType":"AGGREGATED",
"merchantType":"OTHERS"
},
{
"id":47307040,
"amount":{
"amount":77.77,
"currency":"USD"
},
"date":"2025-04-05",
"link":{
"entityName":"transaction",
"url":"/derived/transactions?transactionId=47307040"
},
"categoryId":32,
"category":"Other Income",
"categoryType":"INCOME",
"baseType":"CREDIT",
"description":{
"original":"Income on 04052025",
"simple":"Income on 04052025"
},
"sourceType":"AGGREGATED",
"merchantType":"OTHERS"
},
{
"id":47307039,
"amount":{
"amount":1308.75,
"currency":"USD"
},
"date":"2025-04-01",
"link":{
"entityName":"transaction",
"url":"/derived/transactions?transactionId=47307039"
},
"categoryId":19,
"category":"Other Expenses",
"categoryType":"EXPENSE",
"baseType":"DEBIT",
"description":{
"original":"Personal",
"simple":"Personal"
},
"sourceType":"AGGREGATED",
"merchantType":"OTHERS"
},
{
"id":47307038,
"amount":{
"amount":25.99,
"currency":"USD"
},
"date":"2025-03-25",
"link":{
"entityName":"transaction",
"url":"/derived/transactions?transactionId=47307038"
},
"categoryId":19,
"category":"Other Expenses",
"categoryType":"EXPENSE",
"baseType":"DEBIT",
"description":{
"original":"fdsjhkjfdd",
"simple":"fdsjhkjfdd"
},
"sourceType":"AGGREGATED",
"merchantType":"OTHERS"
}
]
}
]
}
]
}