Skip to content
Developers

API reference / Merchants

POST/v1/merchants/corrections

Correct 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.

Shell
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"}'
TypeScript
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

namestringrequired

Exact merchant name (counterparty) as it appears on transactions.

querystringrequired

logo.dev search, ideally the brand's website domain, e.g. "railway.app".

brandstring | null

Display 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" | null

Omit 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

namestringrequired
brandstringrequired
domainstringrequired
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"required

Errors

Errors contain error, code and an optional action. Read the error and retry guide.

StatusCode
400INVALID_INPUT
401INVALID_API_KEY
403INSUFFICIENT_PERMISSION
404NOT_FOUND
409CONFLICT
413REQUEST_TOO_LARGE
429rate_limit.feature
500REQUEST_FAILED
502UPSTREAM_FAILURE
503UNAVAILABLE

Try this request

Sent directly to https://api.bankmcp.app. Your key stays in this page’s memory and is never saved.

This sends a real action with your key’s permissions. Review the request before sending.