Skip to main content
It includes examples of API requests with mandatory and optional fields, a comprehensive list of all available fields, common responses, and error descriptions. To create contract: HTTP Method: POST Path: {{baseUrl}}/amlyze-ws-rest/contract ContentType: application/json Authorization: Bearer Token To update contract: HTTP Method: PUT Path: {{baseUrl}}/amlyze-ws-rest/contract ContentType: application/json Authorization: Bearer Token

​
API requests example

​
Fields

​
communicationNumber
string(256)
required
Unique number of communication. It is used for risk assessment callback.Example: ComNr_000321
​
requester
string(100)
required
Name of the system requesting web service.Example: financial_institution
​
action
string from enum
Important: This field is only be included when using batch API. Element is used to create/update data of the contract. As this field is not mandatory and if not provided, CREATE values is set as default.❗ By UPDATEing, all data will be replaced with newly received oneEnum class values: CREATE, UPDATEExample: UPDATE
​
active
Boolean
A contract is active or not.Example: true
​
contractType
string(255) from classifier list
Type of contract for evaluation of the object.💡 Possible values will be updated during configuration period.💡 [AdditionalProperty] fields should be validated against classifier.Example: LOAN_CONTRACT
​
extId
string(255)
required
Unique external contract identifier. The identifier corresponds to the contract identifier in the financial institutionExample: any_contract_1232
​
contractCode
string(255)
Contract code or number.Example: REG74121101
​
customerExtId
string(255)
External customer identifier. ThiscustomerExtIdlinks a contract to customer. The identifier corresponds to the client’s identifier in the financial institution.Example: cust_1232
​
accountExtId
string(255)
External account identification number. Corresponds to the account’s identifier in the financial institution.Example: Acc_0011
​
businessUnit
string(255) from classifier list
This parameter is mandatory only for clients utilizing a multi-organizational solution. ❗Omit this parameter unless instructed about it.❗ It serves to specify the unique identifier for the business unit. Business units are logical groupings of users and data. Each business unit can have its own set of users, permissions, and data access rules. (Upcoming feature)Example: LOAN_CONTRACT
​
startAt
date
Contract start date or any other date that covers starting point.Example: 2000-01-03
​
endAt
date
Contract end date or any other date that covers ending point.Example: 1995-05-24
​
additionalProperties
list[]
required
Additional properties for contract.

​
List of possible responses

This part lists common responses after the submission of the request. 
200 OK
{
  "resultType": "REQUEST_ACCEPTED"
}

400 Bad Request
{
  "resultType": "REQUEST_REJECTED",
  "errorCode": "O001",
  "errorDescription": "extId is mandatory"
}

404 Not Found
{
  "timestamp": "2024-05-26T16:49:50.237+00:00",
  "status": 404,
  "error": "Not Found",
  "path": "/amlyze-ws-rest/contract" //--> mistake inside the endpoint
}

500 Internal Server Error
{
  "resultType": "REQUEST_REJECTED",
  "status": 500,
  "error": "Internal Server Error"
}

​
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.
extId is mandatory
code is mandatory