Skip to content
Developers

API reference / Merchants

POST/v1/merchants/resolve

Resolve merchants

Requires merchants:resolve. Resource restrictions also apply. Resolve 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/resolve' \
  -H "Authorization: Bearer $BANKING_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{}'
TypeScript
const response = await fetch('https://api.bankmcp.app/v1/merchants/resolve', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.BANKING_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
});
if (!response.ok) throw new Error(`Banking returned ${response.status}`);
const data = await response.json();

Request body

Content-Type: application/json

object

Response

200 · application/json

status"started" | "already_running" | "nothing_to_do"required
pendingintegerrequired

Range: 0 – unbounded

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
502INVALID_RESPONSE
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.