Create an account assessment

POST /v2/account_assessments
Jwt

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.

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.

    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 "Authorization: Bearer $ACCESS_TOKEN" \
 --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"
}