Create an account assessment

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://docs.api.memo.bank/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "Memo Bank API MCP server": {
    "url": "https://docs.api.memo.bank/mcp"
  }
}
Close
POST /v2/account_assessments

This endpoint allows you to assess a SEPA counterparty account by retrieving risk and fraud indicators, account capabilities and by performing IBAN and name/identification matching. Only one identification of each type can be matched per account assessment (an IBAN has a single holder): requests with several name, siren or lei identifications are rejected.

Scope: account-assessments:write

application/json

Body Required

  • iban string Required

    IBAN of the account to assess.

    Format should match the following pattern: ^[A-Z]{2}[0-9]{2}[a-zA-Z0-9]{1,30}$.

  • identifications array[object]

    List of identifications to match against the account. An IBAN belongs to a single account holder, so at most one identification of each type (name, siren, lei) is accepted; to check several holders, create one account assessment per holder.

    Default value is [] (empty).

    One of:
    name object siren object lei object

Responses

  • 200 application/json

    OK

    Hide response attributes Show response attributes object
    • id string(uuid) Required

      ID of the account assessment.

    • status string Required

      Status of the account assessment.

      Values are pending, completed, or failed.

    • iban string Required

      IBAN from the request.
POST /v2/account_assessments 
curl \
 --request POST 'https://api.memo.bank/v2/account_assessments' \
 --header "Content-Type: application/json" \
 --data '{
  "iban": "FR7617338000014606038580616",
  "identifications": [
    {
      "value": "John Doe",
      "type": "name"
    }
  ]
}'
Request examples 
{
  "iban": "FR7617338000014606038580616",
  "identifications": [
    {
      "value": "John Doe",
      "type": "name"
    }
  ]
}
Response examples (200) 
{
  "id": "61ccd037-8d95-4856-89e7-b043fb84ca26",
  "status": "pending",
  "iban": "FR7617338000014606038580616"
}