{"uid":"cap_b9dzQnNwDHKLFAKpBYHmv","slug":"brainiac-payment-intelligence-transaction-categorization-correction-58aaf8b2","name":"BRAINIAC Payment Intelligence — Transaction Categorization Correction","description":"Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.","url":"https://www.brainiac.software/api/v1/payment-intelligence/transaction-categorization-correct?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"csv":{"type":"string","maxLength":200000},"asOf":{"type":"string","maxLength":40},"file":{"type":"object","required":["mediaType","fileBase64"],"properties":{"filename":{"type":"string","maxLength":180,"minLength":1},"mediaType":{"enum":["text/plain","text/csv","application/json"],"type":"string"},"fileBase64":{"type":"string","maxLength":12000000,"minLength":1}},"additionalProperties":false},"json":{"type":"string","maxLength":200000},"text":{"type":"string","maxLength":200000},"accounts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":200},"type":{"type":"string","maxLength":80},"currency":{"type":"string","maxLength":12}},"additionalProperties":false},"maxItems":100},"merchants":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":200},"aliases":{"type":"array","items":{"type":"string","maxLength":200},"maxItems":20},"category":{"type":"string","maxLength":120}},"additionalProperties":false},"maxItems":400},"corrections":{"type":"array","items":{"type":"object","properties":{"to":{"type":"string","maxLength":120},"from":{"type":"string","maxLength":120},"merchant":{"type":"string","maxLength":200},"transactionId":{"type":"string","maxLength":80}},"additionalProperties":false},"maxItems":400},"transactions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"mcc":{"type":"string","maxLength":20},"date":{"type":"string","maxLength":40},"amount":{"type":"number","maximum":1000000000,"minimum":-1000000000},"status":{"type":"string","maxLength":80},"category":{"type":"string","maxLength":120},"currency":{"type":"string","maxLength":12},"merchant":{"type":"string","maxLength":200},"accountId":{"type":"string","maxLength":80},"direction":{"type":"string","maxLength":40},"reference":{"type":"string","maxLength":160},"description":{"type":"string","maxLength":500}},"additionalProperties":false},"maxItems":2000}}},"responseSchema":{"type":"json","example":{"items":[{"to":"subscription","from":"subscription","applied":true,"merchant":"Netflix","matchedBy":"transaction_id","bankConnected":false,"transactionId":"TX-1","openBankingConnected":false}],"status":"corrected","findings":[],"checkedAt":"2026-11-04T21:00:00.000Z","limitations":["Transactions, accounts, merchants, and category corrections are copied only from labeled fields supplied by the caller.","No bank account is connected and no Open Banking credentials are required or used.","Income, affordability, and merchant identity are derived only from supplied rows. Missing values are not invented.","Recurring and subscription detection use date spacing and description/merchant similarity from the supplied set only.","An affordability or credit decision is never produced."],"appliedCount":1,"bankConnected":false,"incomeInvented":false,"correctionCount":1,"credentialsRequired":false,"openBankingConnected":false,"affordabilityDecision":false}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_GTDsPS6Z9cin8DQyxA6fK","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Applies caller-supplied category corrections to a set of financial transactions and returns which corrections were matched and applied","exampleAgentPrompt":"I have a list of transactions exported from my bank and Netflix keeps getting categorized as 'entertainment' instead of 'subscription' — can you apply a correction so transaction TX-1001 gets reclassified from 'entertainment' to 'subscription' for merchant Netflix, and tell me which corrections were actually applied?","exampleUseCases":[{"title":"Fix miscategorized subscription transactions","prompt":"My expense export has several Netflix and Spotify charges labeled as 'entertainment' but they should be 'subscription' — apply corrections for those merchants and show me which transaction IDs were updated."},{"title":"Correct bulk CSV transaction categories","prompt":"I have a CSV of 500 bank transactions and a list of category corrections I want applied — things like reclassifying 'Whole Foods' from 'shopping' to 'groceries'. Can you run the corrections and tell me how many were applied?"},{"title":"Validate correction rules against transaction JSON","prompt":"Here's a JSON export of transactions from my accounting tool and a set of correction rules I've built up over time. Apply the corrections and tell me which ones matched by transaction ID and which matched by merchant name."}],"resultDescription":"Returns a JSON object with a list of applied corrections (each showing the from/to categories, matched merchant, matchedBy field, and whether it was applied), overall status, appliedCount, correctionCount, checkedAt timestamp, and a findings array. Also includes limitation disclosures confirming no bank connection, no invented data, and no affordability decisions were made.","failureModes":["Corrections not matched if transaction IDs or merchant names don't align with supplied data","Truncated input if CSV/JSON exceeds 200,000 character limit","Missing transactions if data is supplied in an unsupported format or field","No corrections applied if correction rules are ambiguous or empty","402 Payment Required if USDC payment via x402 is not completed before the call"],"whenToPreferThis":"Use this endpoint when you have a set of financial transactions and a known list of category corrections to apply — especially when correcting miscategorized merchants like subscriptions mislabeled as entertainment, or when you need an audit trail of which corrections were matched and applied. Prefer this over a general categorization endpoint when you already know the correct categories and just need them enforced against existing data. It is well-suited for fintech agents, personal finance tools, and accounting workflows that accumulate correction rules over time.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-12T12:36:52.312Z","isFirstParty":false,"canonicalSlug":"brainiac-payment-intelligence-transaction-categorization-correction-58aaf8b2"}