API reference / Merchants
/v1/merchants/correctionsCorrect a merchant
Requires merchants:correct. Resource restrictions also apply. Correct merchants.
Requires unrestricted account access and enabled merchant enrichment.
Request examples
These examples use HTTP directly. Keep API keys on your server.
curl -X POST 'https://api.bankmcp.app/v1/merchants/corrections' \
-H "Authorization: Bearer $BANKING_API_KEY" \
-H 'Content-Type: application/json' \
--data '{"name":"EXAMPLE COFFEE","query":"example.com","brand":"Example Coffee","category":"coffee"}'
const response = await fetch('https://api.bankmcp.app/v1/merchants/corrections', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.BANKING_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"name": "EXAMPLE COFFEE",
"query": "example.com",
"brand": "Example Coffee",
"category": "coffee"
}),
});
if (!response.ok) throw new Error(`Banking returned ${response.status}`);
const data = await response.json();
Request body
Content-Type: application/json
namestringrequiredExact merchant name (counterparty) as it appears on transactions.
querystringrequiredlogo.dev search, ideally the brand's website domain, e.g. "railway.app".
brandstring | nullDisplay name. Omit to keep the current one; null resets it to logo.dev's name.
Show brand schema
Option 1: string
string
Option 2: null
null
category"groceries" | "restaurant" | "coffee" | "fast_food" | "food_delivery" | "bar" | "bakery" | "pharmacy" | "health" | "beauty" | "fashion" | "electronics" | "home" | "shopping" | "software" | "subscription" | "music" | "streaming" | "entertainment" | "events" | "sports" | "fitness" | "travel" | "hotel" | "transport" | "taxi" | "fuel" | "parking" | "utilities" | "telecom" | "housing" | "insurance" | "education" | "books" | "pets" | "gifts" | "charity" | "government" | "other" | nullOmit to keep the current category; null resets it to "other".
Show category schema
Option 1: "groceries" | "restaurant" | "coffee" | "fast_food" | "food_delivery" | "bar" | "bakery" | "pharmacy" | "health" | "beauty" | "fashion" | "electronics" | "home" | "shopping" | "software" | "subscription" | "music" | "streaming" | "entertainment" | "events" | "sports" | "fitness" | "travel" | "hotel" | "transport" | "taxi" | "fuel" | "parking" | "utilities" | "telecom" | "housing" | "insurance" | "education" | "books" | "pets" | "gifts" | "charity" | "government" | "other"
"groceries" | "restaurant" | "coffee" | "fast_food" | "food_delivery" | "bar" | "bakery" | "pharmacy" | "health" | "beauty" | "fashion" | "electronics" | "home" | "shopping" | "software" | "subscription" | "music" | "streaming" | "entertainment" | "events" | "sports" | "fitness" | "travel" | "hotel" | "transport" | "taxi" | "fuel" | "parking" | "utilities" | "telecom" | "housing" | "insurance" | "education" | "books" | "pets" | "gifts" | "charity" | "government" | "other"
Option 2: null
null
Response
200 · application/json
namestringrequiredbrandstringrequireddomainstringrequiredcategory"groceries" | "restaurant" | "coffee" | "fast_food" | "food_delivery" | "bar" | "bakery" | "pharmacy" | "health" | "beauty" | "fashion" | "electronics" | "home" | "shopping" | "software" | "subscription" | "music" | "streaming" | "entertainment" | "events" | "sports" | "fitness" | "travel" | "hotel" | "transport" | "taxi" | "fuel" | "parking" | "utilities" | "telecom" | "housing" | "insurance" | "education" | "books" | "pets" | "gifts" | "charity" | "government" | "other"requiredErrors
Errors contain error, code and an optional action. Read the error and retry guide.
| Status | Code |
|---|---|
| 400 | INVALID_INPUT |
| 401 | INVALID_API_KEY |
| 403 | INSUFFICIENT_PERMISSION |
| 404 | NOT_FOUND |
| 409 | CONFLICT |
| 413 | REQUEST_TOO_LARGE |
| 429 | rate_limit.feature |
| 500 | REQUEST_FAILED |
| 502 | UPSTREAM_FAILURE |
| 503 | UNAVAILABLE |
Try this request
Sent directly to https://api.bankmcp.app. Your key stays in this page’s memory and is never saved.