> ## Documentation Index > Fetch the complete documentation index at: https://api.amlyze.com/llms.txt > Use this file to discover all available pages before exploring further. # Evaluate operation > To initiate the scoring process, the `sourceOfRiskLevel` field in the API payload must be set to `EVALUATE`. This instructs the AMLYZE engine to run the operation's data through the active risk matrix. In contrast, sending the value `IMPORT` will only update the operation's data in the system without triggering a new risk evaluation. ## OpenAPI ````yaml /api/openapi_api_adapter.json post /amlyze-ws-rest/operation openapi: 3.1.0 info: title: OpenAPI definition version: v0 servers: - url: https://{{baseUrl}} description: Generated server url security: - bearerAuth: [] tags: [] paths: /amlyze-ws-rest/operation: post: tags: - operation summary: Evaluate operation description: >- To initiate the scoring process, the `sourceOfRiskLevel` field in the API payload must be set to `EVALUATE`. This instructs the AMLYZE engine to run the operation's data through the active risk matrix. In contrast, sending the value `IMPORT` will only update the operation's data in the system without triggering a new risk evaluation. operationId: postOperation requestBody: content: application/json: schema: $ref: '#/components/schemas/AmlyzeOperationApi' examples: sepa_evaluate_no_screening: summary: sepa evaluate without screening value: communicationNumber: Test_ComNr_SEPA_13 requester: Company Name AMLYZE businessUnit: sandbox operationExtId: Op_11_SEPA_TEST operationType: SEPA riskManagementCategory: OP_TRANSFER sourceOfRiskLevel: EVALUATE operationDateTime: '2025-06-20T12:09:33+02:00' financialFlowDirection: OUTGOING currency: EUR amount: 10000 exchangeRate: 1 amountInEquivalent: 10000 description: Invoice 'Nr.01' listOperationParty: - partyRole: DEBTOR accountNumber: ORG20231117550 entityType: ORGANIZATION bic: SANDLT00XXX title: UAB 'BrotherHood' - partyRole: CREDITOR accountNumber: LT9208800274335945522 bic: AMLYZEXX22 entityType: INDIVIDUAL firstName: Tomas lastName: Garcia sepa_evaluate_with_screening: summary: sepa evaluate with screening value: communicationNumber: Test_ComNr_SEPA_15 requester: Company Name AMLYZE operationExtId: Op_12_SEPA_TEST operationType: SEPA businessUnit: sandbox riskManagementCategory: OP_TRANSFER sourceOfRiskLevel: EVALUATE initializeScreeningProcesses: - SANCTIONS - PEP - ADVERSE_MEDIA - INTERNAL_LIST operationDateTime: '2025-06-20T10:09:33+02:00' financialFlowDirection: OUTGOING currency: EUR amount: 100000 exchangeRate: 1 amountInEquivalent: 100000 description: Invoice 'Nr.01' listOperationParty: - partyRole: DEBTOR accountNumber: VG50GHJL6649878241059005 bic: SANDLT00XXX entityType: ORGANIZATION title: Vending Machines LTD - partyRole: CREDITOR accountNumber: LV11245541148212335 entityType: ORGANIZATION title: LTD 'VivaFocus' sepa_evaluate_full_example: summary: sepa full example value: communicationNumber: Test_ComNr_SEPA_20 requester: Company Name AMLYZE businessUnit: sandbox operationExtId: Op_14_SEPA_TEST operationType: SEPA riskManagementCategory: OP_TRANSFER sourceOfRiskLevel: EVALUATE initializeScreeningProcesses: - SANCTIONS - PEP - ADVERSE_MEDIA - INTERNAL_LIST operationDateTime: '2025-06-20T15:09:33+02:00' financialFlowDirection: INCOMING currency: EUR amount: 123 exchangeRate: 1 amountInEquivalent: 123 sourceCountry: LT destinationCountry: LV description: invoice '06' ipAddress: 555.222.4545.144 ipAddressCountry: LT listOperationParty: - partyRole: ULTIMATE_DEBTOR accountNumber: LT20240226T133450 bic: BIC currency: EUR bankTitle: TBC entityType: INDIVIDUAL firstName: Hakaka lastName: Luka identifier: '50007102289' address: Verkių g. 7-8, Vilnius country: LT - partyRole: DEBTOR accountNumber: LV11245541148212335 bic: BIC22XX currency: EUR bankTitle: TBC entityType: INDIVIDUAL firstName: Antonio lastName: Murara - partyRole: CREDITOR accountNumber: VG50GHJL6649878241059005 bic: SANDLT00XXX currency: EUR accountExtId: 7457767a-9803-41fd-80c4-0357e560ee61 bankTitle: Sandbox entityType: ORGANIZATION title: Vending Machines LTD - partyRole: ULTIMATE_CREDITOR accountNumber: LT20240226T133633 bic: BIC currency: EUR bankTitle: TBC entityType: INDIVIDUAL title: Dona Murara identifier: '60007102289' address: Kauno g. 9, Vilnius country: LT sepa_import_full_example: summary: sepa import full example value: communicationNumber: Test_ComNr_SEPA_11 requester: Company Name AMLYZE businessUnit: sandbox operationExtId: Op_08_SEPA_TEST operationType: SEPA riskManagementCategory: OP_TRANSFER sourceOfRiskLevel: IMPORT initializeScreeningProcesses: - SANCTIONS - PEP - ADVERSE_MEDIA - INTERNAL_LIST operationDateTime: '2025-06-20T15:09:33+02:00' operationStatus: EXECUTED riskLevel: MEDIUM financialFlowDirection: INCOMING currency: EUR amount: 123 exchangeRate: 1 amountInEquivalent: 123 sourceCountry: LT destinationCountry: LV description: invoice '06' ipAddress: 555.222.4545.144 ipAddressCountry: LT listOperationParty: - partyRole: ULTIMATE_DEBTOR accountNumber: LT20240226T133450 bic: BIC currency: EUR bankTitle: TBC entityType: INDIVIDUAL firstName: Hakaka lastName: Luka identifier: '50007102289' address: Verkių g. 7-8, Vilnius country: LT - partyRole: DEBTOR accountNumber: LV11245541148212335 bic: BIC22XX currency: EUR bankTitle: TBC entityType: INDIVIDUAL firstName: Antonio lastName: Murara - partyRole: CREDITOR accountNumber: VG50GHJL6649878241059005 bic: SANDLT00XXX currency: EUR bankTitle: Sandbox entityType: ORGANIZATION title: Vending Machines LTD - partyRole: ULTIMATE_CREDITOR accountNumber: LT20240226T133633 bic: BIC currency: EUR bankTitle: TBC entityType: INDIVIDUAL title: Dona Murara identifier: '60007102289' address: Kauno g. 9, Vilnius country: LT internal_import_full_example: summary: internal import full example value: communicationNumber: Test_ComNr_INTERNAL_03 requester: Company Name AMLYZE businessUnit: sandbox operationExtId: Op_03_INTERNAL_TEST operationType: INTERNAL riskManagementCategory: OP_TRANSFER sourceOfRiskLevel: IMPORT initializeScreeningProcesses: - SANCTIONS - PEP - ADVERSE_MEDIA - INTERNAL_LIST operationDateTime: '2023-09-22T15:09:33+02:00' operationStatus: EXECUTED riskLevel: HIGH financialFlowDirection: 'NULL' currency: GBP amount: 123 exchangeRate: 1.16 amountInEquivalent: 143 sourceCountry: LT destinationCountry: LT description: invoice '123458' ipAddress: 555.222.4545.144 ipAddressCountry: LT listOperationParty: - partyRole: DEBTOR accountNumber: LT9208800274335945522 bic: AMLYZEXX22 currency: EUR bankTitle: TBC entityType: INDIVIDUAL firstName: Tomas lastName: Garcia address: Baltų pr. 16, LT-44001, Kauno m. sav. country: LT - partyRole: CREDITOR accountNumber: LT9208800274335945555 bic: AMLYZEXX22 currency: EUR bankTitle: TBC entityType: ORGANIZATION title: LTD 'VivaElementus' swift_import_full_example: summary: swift import full example value: communicationNumber: Test_ComNr_SWIFT_07 requester: Company Name AMLYZE businessUnit: sandbox operationExtId: Op_07_SWIFT_TEST operationType: SWIFT riskManagementCategory: OP_TRANSFER sourceOfRiskLevel: IMPORT initializeScreeningProcesses: - SANCTIONS - PEP - ADVERSE_MEDIA - INTERNAL_LIST operationDateTime: '2025-06-23T16:09:33+02:00' operationStatus: EXECUTED riskLevel: MEDIUM financialFlowDirection: INCOMING currency: GBP amount: 123 exchangeRate: 1.16 amountInEquivalent: 143 sourceCountry: LT destinationCountry: LV description: invoice '06' ipAddress: 555.222.4545.144 ipAddressCountry: LT listOperationParty: - partyRole: ULTIMATE_DEBTOR accountNumber: LT20240226T133450 bic: BIC currency: EUR bankTitle: TBC entityType: INDIVIDUAL firstName: Hakaka lastName: Luka identifier: '50007102289' address: Verkių g. 7-8, Vilnius country: LT - partyRole: DEBTOR accountNumber: LV11245541148212335 bic: BIC22XX currency: EUR bankTitle: TBC entityType: INDIVIDUAL firstName: Antonio lastName: Murara - partyRole: CREDITOR accountNumber: SM63K064810183873IY90137424 bic: SANDLT00XXX currency: EUR bankTitle: Sandbox entityType: INDIVIDUAL firstName: Althea lastName: Reyes - partyRole: ULTIMATE_CREDITOR accountNumber: LT20240226T133633 bic: BIC currency: EUR bankTitle: TBC entityType: INDIVIDUAL title: Dona Murara identifier: '60007102289' address: Kauno g. 9, Vilnius country: LT card_payment_import_full_example: summary: card payment import full example value: communicationNumber: Com_0027 requester: financial_institution businessUnit: sandbox operationExtId: ExtId_0027 operationType: CARD_PAYMENT cardOperationSubType: CARD_PURCHASE riskManagementCategory: OP_DEFAULT sourceOfRiskLevel: IMPORT operationStatus: EXECUTED riskLEvel: HIGH operationDateTime: '2023-09-22T15:09:33+02:00' sourceCountry: LT destinationCountry: LV currency: EUR amount: 999 exchangeRate: 1 amountInEquivalent: 999 financialFlowDirection: OUTGOING initializeScreeningProcesses: - SANCTIONS - ADVERSE_MEDIA - PEP - INTERNAL_LIST description: invoice 'LT523458' ipAddress: 222.222.222.222 ipAddressCountry: LT terminalExtId: AOZ_AOC541 terminalCode: '400154' merchantExtId: AO40014541 merchantCode: '5000815454' merchantDescription: Financial Terminal merchantName: XYZ Bank Group - Terminal 1 merchantCountryCode: UA salesPointExtId: AOZ_AOC541ZZ41 salesPointCode: '87400154' listOperationParty: - partyRole: DEBTOR accountNumber: LT933520036948858623 bic: BICXX22 currency: EUR bankTitle: TBC entityType: INDIVIDUAL firstName: Geli lastName: Deliono address: Baltų pr. 16, LT-44001, Kauno m. sav. country: LT cardNumber: '************1288' cardValidTill: '2025-12-01' cardHolderName: Geli Jr. Deliono - partyRole: CREDITOR accountNumber: LT12345678901234567890 bic: BIC23 currency: EUR bankTitle: TLC entityType: ORGANIZATION title: LAMEER CardNumber: '************1254' cardValidTill: '2023-12-01' cardHolderName: L. Hammeri cash_import_import_full_example: summary: cash import full example value: communicationNumber: ComNr_0011 requester: Kauno kredito unija businessUnit: sandbox operationExtId: OP20231114T12 operationType: CASH riskManagementCategory: OP_DEFAULT sourceOfRiskLevel: IMPORT initializeScreeningProcesses: - SANCTIONS - ADVERSE_MEDIA - PEP - INTERNAL_LIST operationDateTime: '2023-11-15T15:09:33+02:00' riskLevel: LOW operationStatus: EXECUTED financialFlowDirection: OUTGOING currency: EUR amount: 998 exchangeRate: 1.14 amountInEquivalent: 1140.41 sourceCountry: LT destinationCountry: LT description: Money withdrawal listOperationParty: - partyRole: DEBTOR accountNumber: LV6630800200000018155 bic: BICXX22 currency: EUR bankTitle: MyBank entityType: INDIVIDUAL firstName: Geli lastName: Deliono address: Baltų pr. 16, LT-44001, Kauno m. sav. country: LT - partyRole: CREDITOR accountNumber: LV6630800200000018155 entityType: INDIVIDUAL firstName: Geli lastName: Deliono crypto_import_full_example: summary: crypto import full example value: communicationNumber: ComNr_0028{{seq}} requester: financial_institution businessUnit: sandbox operationExtId: Op_0028 operationType: CRYPTO riskManagementCategory: OP_DEFAULT sourceOfRiskLevel: IMPORT initializeScreeningProcesses: - SANCTIONS - PEP - ADVERSE_MEDIA - INTERNAL_LIST operationDateTime: '2023-09-22T15:09:33+02:00' operationStatus: EXECUTED riskLevel: EXTREME financialFlowDirection: INCOMING currency: ETH amount: 14.5 exchangeRate: 100 amountInEquivalent: 1450 sourceCountry: LT destinationCountry: LV description: crypto invoice '123487' ipAddress: 555.222.4545.144 ipAddressCountry: LT listOperationParty: - partyRole: DEBTOR accountNumber: '12345678901234567890' bic: BIC23XX currency: EUR bankTitle: TBC entityType: ORGANIZATION title: LONDO address: Baltų pr. 16, LT-44001, Kauno m. sav. country: LT - partyRole: CREDITOR accountNumber: aaaz00145C9aa785aaz0C3fDd7197B6777b55b8ebc1BfE758fC7 bic: KRYPXX currency: ETH_222 bankTitle: TBC entityType: ORGANIZATION title: RyptoKrypto crypto_exchange_import_full_example: summary: crypto exchange import full example value: communicationNumber: ComNr_0029 requester: financial_institution businessUnit: sandbox operationExtId: Op_0029 operationType: CRYPTO_EXCHANGE riskManagementCategory: OP_DEFAULT sourceOfRiskLevel: IMPORT initializeScreeningProcesses: - SANCTIONS - PEP - ADVERSE_MEDIA - INTERNAL_LIST operationDateTime: '2023-09-22T15:09:33+02:00' operationStatus: EXECUTED riskLevel: EXTREME financialFlowDirection: INCOMING currency: ETH amount: 14.5 exchangeRate: 100 amountInEquivalent: 1450 sourceCountry: LT destinationCountry: LV description: crypto invoice '123487' ipAddress: 555.222.4545.144 ipAddressCountry: LT listOperationParty: - partyRole: DEBTOR accountNumber: ZZ55ZZ3fDd7197B6777b55b8ebc1BfE7ZZZ bic: BICXX22 currency: BTC bankTitle: TBC entityType: ORGANIZATION title: RyptoKrypto address: Baltų pr. 16, LT-44001, Kauno m. sav. country: LT - partyRole: CREDITOR accountNumber: aaaz00145C9aa785aaz0C3fDd7197B6777b55b8ebc1BfE758fC7 bic: KRYPXX currency: ETH_222 bankTitle: TBC entityType: ORGANIZATION title: RyptoKrypto required: true responses: '200': description: OK content: '*/*': schema: $ref: '#/components/schemas/OperationResultApi' components: schemas: AmlyzeOperationApi: properties: action: description: >- Element is used to indicate whether to create new record or update exiting one. If not provided, 'CREATE' is the default. When using 'UPDATE', all existing data will be replaced by the new data provided. enum: - CREATE - UPDATE type: string amount: description: >- The monetary amount in the currency in which the payment was initiated. type: number amountInEquivalent: description: >- The monetary amount in the original currency. ❗Mandatory if `currency` is not your original currency. type: number amountInEuro: deprecated: true description: >- Amount of money in euro currency. ❗Mandatory if `currency` is not euro. type: number businessUnit: description: >- Mandatory field for clients utilizing a multi-organizational solution. 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. type: string cardOperationSubType: type: string maxLength: 255 description: ' Card operation subtype code. These field values are configurable individually. Value is taken from `/classifier/cardOperationSubType` endpoint.' x-dynamic-enum: path: /classifier/cardOperationSubType valueField: code communicationNumber: description: >- Unique number of communication. It is used for risk assessment callback. maxLength: 255 type: string currency: type: string description: >- International currency code. Value is taken from `/classifier/currency` endpoint. x-dynamic-enum: path: /classifier/currency valueField: code dateAuthorized: format: date-time type: string description: Date payment was authorized. dateSettled: format: date-time type: string description: Date payment was settled. description: type: string description: The purpose of payment is saved under description. maxLength: 550 destinationCountry: type: string description: >- Country of operation's destination. Value is taken from `/classifier/country` endpoint x-dynamic-enum: path: /classifier/country valueField: code euroExchangeRate: deprecated: true type: number description: Euro exchange rate for other than Eur currency. exchangeRate: description: >- The exchange rate applied when converting from the original currency. type: number fastPayment: description: Indication if this is fast payment. type: boolean deprecated: true financialFlowDirection: description: Refers to the movement of money between entities or accounts. enum: - INCOMING - 'NULL' - OUTGOING type: string initializeScreeningProcesses: description: Defines which lists to check during screening process. items: type: string enum: - SANCTIONS - PEP - ADVERSE_MEDIA - INTERNAL_LIST type: array ipAddress: description: The IP address of the operation. type: string ipAddressCountry: description: >- Country of an IP address of the operation. Value is taken from `/classifier/country` endpoint. type: string x-dynamic-enum: path: /classifier/country valueField: code listOperationParty: items: $ref: '#/components/schemas/OperationPartyApi' maxItems: 4 minItems: 1 type: array merchantCode: description: External identifier of the seller-mediator. maxLength: 50 type: string merchantCountryCode: description: >- Seller-mediator country code. Value is taken from `/classifier/country` endpoint. maxLength: 2 type: string x-dynamic-enum: path: /classifier/country valueField: code merchantDescription: description: Seller-mediator description. maxLength: 32768 type: string merchantExtId: description: External identifier of the seller-mediator. maxLength: 100 type: string merchantName: description: Name of the seller-mediator. maxLength: 32768 type: string operationDateTime: description: The operation date and time show when the operation proceeded. format: date-time type: string operationExtId: description: External identifier of operation. maxLength: 255 type: string operationStatus: description: Operation result whether it was successfully executed or rejected. enum: - EXECUTED - REJECTED type: string operationType: description: >- Notifies about which kind of operation type was performed. Value is taken from `/classifier/operationType` endpoint. type: string x-dynamic-enum: path: /classifier/operationType valueField: code requester: description: Name of the system requesting web service. maxLength: 100 type: string riskLevel: description: The risk level of imported operation. enum: - EXTREME - HIGH - LOW - MEDIUM - NONE type: string riskManagementCategory: description: >- Code of risk management category of the object. Value must be from a classifier list personalized to your company. Value is taken from `/classifier/riskManagementCategory` endpoint. type: string x-dynamic-enum: path: /classifier/riskManagementCategory valueField: code salesPointCode: description: External code of the sales point. maxLength: 50 type: string salesPointExtId: description: External identifier of the sales point. maxLength: 100 type: string sourceCountry: description: >- Country of operation's source. Value is taken from `/classifier/country` endpoint. maxLength: 2 type: string x-dynamic-enum: path: /classifier/country valueField: code sourceOfRiskLevel: description: >- The value `IMPORT` should be used for migration purposes only - the transaction will be imported without risk assessment. enum: - EVALUATE - IMPORT type: string terminalCode: description: External code of the terminal. maxLength: 100 type: string terminalExtId: description: External identifier of the terminal. maxLength: 100 type: string required: - amount - communicationNumber - currency - description - financialFlowDirection - listOperationParty - operationDateTime - operationExtId - operationType - requester - riskManagementCategory - sourceOfRiskLevel type: object OperationResultApi: properties: errorCode: type: string errorDescription: type: string resultType: enum: - REQUEST_ACCEPTED - REQUEST_REJECTED type: string type: object OperationPartyApi: properties: accountNumber: description: >- Unique account identification number used in performing operations.❗Not mandatory if partyRole is `ULTIMATE_DEBTOR` or `ULTIMATE_CREDITOR`. maxLength: 255 type: string accountExtId: description: >- External account identifier. If this is not provided, then system will check a combination of `accountNumber` + `currency` + `bic` to detect customer. maxLength: 255 type: string address: description: >- Party’s nformation including street address, city, and possibly other relevant details. maxLength: 4000 type: string bankTitle: description: Title of bank at which the operation is happening. maxLength: 255 type: string bic: description: Bank identifier code for account number. maxLength: 100 type: string cardHolderName: description: Name written on the card. maxLength: 255 type: string cardNumber: description: card number. maxLength: 255 type: string cardValidTill: description: Card date of expiration written on the card. maxLength: 255 type: string country: description: >- Two-letter country code specifying the participant's country.Value is taken from `/classifier/country` endpoint. maxLength: 2 type: string x-dynamic-enum: path: /classifier/country valueField: code currency: description: >- International currency code. Value is taken from `/classifier/currency` endpoint. maxLength: 3 type: string x-dynamic-enum: path: /classifier/currency valueField: code entityType: description: Client type. enum: - INDIVIDUAL - ORGANIZATION - UNKNOWN type: string firstName: description: First name of the party. maxLength: 100 type: string identifier: description: >- Unique identification number (e.g., personal ID, company VAT code) to distinguish the payer and the transaction. Can be used for customer, counterparty and ultimate party. ❗Mandatory only when `partyRole` is `ULTIMATE_*` and no more elements are provided for that party. maxLength: 255 type: string lastName: description: Last name of the party. maxLength: 100 type: string partyRole: description: >- The role of the party in ongoing operation. At least one operation party account must already exist in AMLYZE. Only one operation can be imported per API request which means only one `CREDITOR` and one `DEBTOR` could be provided. If `financialFlowDirection` is `INCOMING` your customer is `CREDITOR`. If `financialFlowDirection` is `OUTGOING` your customer is `DEBTOR`. enum: - CREDITOR - DEBTOR - ULTIMATE_CREDITOR - ULTIMATE_DEBTOR type: string title: description: >- Identifies a party (`INDIVIDUAL`, `ORGANIZATION` or `UNKNOWN`) without requiring `firstName` or `lastName`. ❗Not mandatory if entity is `INDIVIDUAL` and both `firstName` and `lastName` are provided. maxLength: 255 type: string required: - accountNumber - entityType - partyRole type: object securitySchemes: bearerAuth: type: http scheme: bearer ````