Transaction Data Enrichment
Turn cryptic merchant codes into branded, recognizable transactions. Transaction data enrichment with logos, colors, and company details from a single API call.
From statement text to a recognizable merchant
Capture the descriptor
Take the transaction text from your existing billing data or bank feed. Include location context when available.
const transaction = {
descriptor: 'AMZN*MKTP US',
country: 'us',
} as const;Identify the merchant
Send the descriptor to Retrieve Brand using by_transaction. Handle not-found responses when a merchant cannot be identified.
const { brand } = await
client.brand.retrieve({
type: 'by_transaction',
transaction_info:
transaction.descriptor,
country_gl:
transaction.country,
});Enrich the display
Show the matched merchant name, domain, and available logo so people can recognize a transaction.
const merchant = {
name: brand.title,
domain: brand.domain,
logo: brand.logos?.[0]?.url,
};Before & after
See the difference in real time
Drag the slider to see how cryptic transaction codes become recognizable brands.
Transaction History
| Date | Merchant | Amount |
|---|---|---|
| 2024-10-08 | AMZN*MKTP US-XX1234 | $129.99 |
| 2024-10-07 | WALMART STORE#1234 | $64.32 |
| 2024-10-05 | TICKETMASTER*EVENT | $245.00 |
Transaction History
Amazon
Walmart
Ticketmaster
Who This Is For
Retrieve a brand from a transaction
Illustrative merchant match. Available Brand fields vary by company.
POST /v1/brand/retrieveRequest body
{
"type": "by_transaction",
"transaction_info": "SQ *BLUE BOTTLE OAK",
"country_gl": "us"
}Example response
{
"status": "ok",
"brand": {
"domain": "bluebottlecoffee.com",
"title": "Blue Bottle Coffee",
"description": "Coffee roaster and cafe company."
},
"code": 200
}Frequently asked questions
Using Brand for merchant identification.
How do I identify a merchant from transaction text?
Can I provide more context for matching?
What merchant data can I get?
Does this API connect to bank accounts?
How do I identify a merchant from transaction text?
What merchant data can I get?
Can I provide more context for matching?
Does this API connect to bank accounts?
Ship an agent that actually knows things.
Free tier, 10-minute integration, and the same API powering agents at Mintlify, daily.dev, and Propane. No credit card to start.













