Batch account service

Validate batch of accounts without saving

This method sends data only for validating JSON. HTTP Method: POST Path: {{baseUrl}}/amlyze-ws-rest/validate-batch-accounts ContentType: application/json Authorization: Basic Auth/Bearer Token

Validate batch of accounts with saving

This method sends data and imports accounts in Amlyze. HTTP Method: POST Path: {{baseUrl}}/amlyze-ws-rest/batch-accounts ContentType: application/json Authorization: Basic Auth/Bearer Token The minimalistic request represents scenario of already onboarded customer (INDIVIDUAL or ORGANIZATION), to whom a new IBAN account (Not necessarily) is being attached. All payload fields & descriptions suitable for request.

API requests example

Show Mandatory fields example | CUSTOMER import - BATCH

{
"accounts":[
{
  "communicationNumber": "comNumber0",
  "requester": "Company Name Amlyze",
  "businessUnit": "sandbox",
  "businessEntityExtId": "ORG_IMPORT_B1_TEST",
  "accountExtId": "accountExtId3",
  "accountNumber": "LI9208800274335945522",
  "accountStatus": "ACTIVE",
  "currencyCode": "EUR",
  "openingDate": "2023-09-05T08:07:34.605Z",
  "bic": "AmlyzeXX22",
  "isOtherFinInstAccount": true
},
{
  "communicationNumber": "comNumber1",
  "requester": "Company Name Amlyze",
  "businessUnit": "sandbox",
  "businessEntityExtId": "ORG_C1_TEST",
  "accountExtId": "accountExtId4",
  "accountNumber": "LI9208800274335945523",
  "accountStatus": "ACTIVE",
  "currencyCode": "EUR",
  "openingDate": "2023-09-05T08:07:34.605Z",
  "bic": "SANDLT00XXX"
}
]
}

Fields

The data documentation can be found here.

List of possible responses

200 OK
{
  "results": [
    {
      "resultType": "REQUEST_ACCEPTED",
      "communicationNumber": "comNumber0",
      "accountExtId": "accountExtId0",
      "businessUnit": "businessUnit0",
      "timeElapsedMs": 203
    },
    {
      "resultType": "REQUEST_ACCEPTED",
      "communicationNumber": "comNumber1",
      "accountExtId": "accountExtId0",
      "businessUnit": "businessUnit1",
      "timeElapsedMs": 203
    },
  ],
  "timeElapsedMs": 408
}
    
200 OK
{
  "results": [
    {
      "resultType": "REQUEST_ACCEPTED",
      "communicationNumber": "comNumber0",
      "accountExtId": "accountExtId0",
      "businessUnit": "businessUnit0",
      "timeElapsedMs": 203
    },
    {
      "resultType": "REQUEST_REJECTED",
      "communicationNumber": "comNumber1",
      "accountExtId": "accountExtId1",
      "businessUnit": "businessUnit1",
      "errorCode": "O005",
      "errorDescription": "CommunicationNumber already used in amlyze",
      "timeElapsedMs": 20
    },
  ],
  "timeElapsedMs": 223
}
    
400 Bad Request (Invalid json body)
{
  "timestamp": "2024-05-26T16:49:50.237+00:00",
  "status": 400,
  "error": "Bad Request",
  "path": "/amlyze-ws-rest/batch-accounts"
}

500 Internal Server Error
{
  "errorCode": "500",
  "errorDescription": "Processing failed",
  "timeElapsedMs": 172
}

List of possible errors

This section lists the possible errors that can occur when making a bad account request to the API. A bad request is a request that somehow does not follow the API specifications.

Error Description
AccountExtId is mandatory
AccountNumber is mandatory
BusinessEntityExtId is mandatory
BusinessEntity with given extId does not exist in Amlyze
Cannot register account for lead customer
Currency does not exist in Amlyze
Account already linked with other customer
When using external account, BIC is mandatory
Given BIC does not belong to your institution
OpeningDate is mandatory
Invalid Account status, allowed values: ACTIVE, SUSPENDED, CLOSED
Given AccountType does not exist in Amlyze
CLOSED account requires closingDate
Non-closed account cannot have a closing date
CommunicationNumber is mandatory
Requester is mandatory
CommunicationNumber already used in Amlyze
Tenant header is mandatory
Business unit is mandatory
Tenant business unit does not exist

API Documentation

​Validate batch of accounts without saving

​Validate batch of accounts with saving

​API requests example

​Fields

​List of possible responses