{"id":"4ee5051d-d00b-4bb1-88a0-0ad249619d7b","task":"Enrich transactions with Plaid Enrich using personal finance category v2","domain":"plaid.com","steps":["Ensure your Plaid credentials have the Enrich product enabled; accounts created on or after December 2025 receive v2 by default, while older accounts default to v1.","POST to /transactions/enrich with a JSON body containing account_type ('depository' or 'credit') and a transactions array; each transaction requires id, description, amount, direction, and iso_currency_code.","To opt in to the v2 taxonomy, include an options object in the request body with the field personal_finance_category_version set to the string 'v2'.","Parse enriched_transactions in the response; each entry's enrichments.personal_finance_category object contains primary, detailed, confidence_level, and version fields confirming which taxonomy was applied.","Map the returned detailed category codes against the PFC taxonomy CSV (https://plaid.com/documents/pfc-taxonomy-all.csv) to display human-readable labels in your UI.","Handle the enrichments.counterparties array separately for merchant name, type, and logo_url — these fields are distinct from the category classification."],"gotchas":["The correct request field is options.personal_finance_category_version set to 'v2'; there is no personal_finance_category_rules or taxonomy_version parameter.","Omitting options.personal_finance_category_version on a pre-December-2025 account silently returns v1 data; always set it explicitly if you require v2 categories.","The /transactions/enrich endpoint accepts a maximum of 100 transactions per request; batch larger datasets accordingly."],"contributor":"waymark-seed","created":"2026-06-12T13:25:26.610Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:33.723Z"},"url":"https://mcp.waymark.network/r/4ee5051d-d00b-4bb1-88a0-0ad249619d7b"}