{"swagger":"2.0","info":{"version":"1.3.0","title":"Xe.Api.Payments"},"paths":{"/permissions":{"get":{"tags":["Permission"],"summary":"Gets all permissions for the current user.","description":"Sample request:\r\n            \r\n    GET /permissions\r\n            \r\n\\\r\n<details><summary>**The complete set of permissions are**</summary>\r\n* OnlineCardSettlementEnabled\r\n* CanQuote\r\n* CanQuoteAndCreateTransaction\r\n* CanUseOnlineDealing\r\n* CanAccessRecipients\r\n* CanEditOwnAddress\r\n* CanAddRecipient\r\n* CanDeleteRecipient\r\n* ViewPaymentsAwaitingAuthorisation\r\n* CanSubmitPayment\r\n* AllowOnlineForwards\r\n</details>","operationId":"Get","consumes":[],"produces":["text/plain","application/json","text/json"],"parameters":[],"responses":{"200":{"description":"Returns the list of permissions.","schema":{"$ref":"#/definitions/StringArrayResponse"},"examples":{"application/json":["CanQuote","CanQuoteAndCreateTransaction"]}},"500":{"description":"Error getting permissions."}}}},"/purposesofpayment/{currency}":{"get":{"tags":["PurposesOfPayment"],"summary":"Get purposes of payment for given user.","description":"Sample request:\r\n\r\n    Get /purposesofpayment/INR\r\n\r\n\\\r\n<details><summary>**The complete set of purposes of payment for all currencies are**</summary>\r\n* BONUS_SALARY\r\n* CORP_BONUS\r\n* CORP_CHARITY\r\n* CORP_CUSTOMER_PAYMENT\r\n* CORP_DIVIDEND\r\n* CORP_EMPLOYEE_EXPENSES\r\n* CORP_FREIGHT\r\n* CORP_IMPORT_EXPORT\r\n* CORP_INR_BANKERS\r\n* CORP_INR_COOP\r\n* CORP_INR_CREDIT\r\n* CORP_INR_EDUCATIONAL\r\n* CORP_INR_EMI\r\n* CORP_INR_FAMILIES\r\n* CORP_INR_POSTMASTER\r\n* CORP_INR_TAX\r\n* CORP_INR_TRADE\r\n* CORP_INR_TRAVEL\r\n* CORP_INR_UTILTY\r\n* CORP_INSURANCE\r\n* CORP_INVESTMENT\r\n* CORP_INVOICE\r\n* CORP_OPERATING_COST\r\n* CORP_OTHER\r\n* CORP_OUTSOURCING\r\n* CORP_PENSION\r\n* CORP_PROPERTY_BUY_SELL\r\n* CORP_PROPERTY_MANAGEMENT\r\n* CORP_REPATRIATION\r\n* CORP_SALARY\r\n* CORP_SUPPLIER_PAYMENT\r\n* CORP_TAX\r\n* CORP_TRAVEL_SERVICES\r\n* DIVIDEND_PAYMENT\r\n* EXPENSES\r\n* INSURANCE_CLAIMS\r\n* INVOICES\r\n* OTHER\r\n* PENSION\r\n* PRIV_BILL_PAYMENT\r\n* PRIV_BUSINESS_PAYMENT\r\n* PRIV_CHARITY\r\n* PRIV_FAMILY_SUPPORT\r\n* PRIV_GIFT\r\n* PRIV_GOODS_SERVICES\r\n* PRIV_HOLIDAY\r\n* PRIV_INHERITANCE\r\n* PRIV_INR_BANKERS\r\n* PRIV_INR_COOP\r\n* PRIV_INR_CREDIT\r\n* PRIV_INR_EDUCATIONAL\r\n* PRIV_INR_EMI\r\n* PRIV_INR_FAMILIES\r\n* PRIV_INR_HOTELS\r\n* PRIV_INR_MEDICAL\r\n* PRIV_INR_POSTMASTER\r\n* PRIV_INR_TAX\r\n* PRIV_INR_TRADE\r\n* PRIV_INR_TRAVEL\r\n* PRIV_INR_UTILTY\r\n* PRIV_INVESTMENT\r\n* PRIV_LIVING\r\n* PRIV_LOAN_REPAYMENT\r\n* PRIV_MEDICAL\r\n* PRIV_MORTGAGE\r\n* PRIV_OTHER\r\n* PRIV_PENSION\r\n* PRIV_PROPERTY_BUY_SELL\r\n* PRIV_RELOCATION\r\n* PRIV_SALARY\r\n* PRIV_TAX\r\n* PRIV_TEST_TRANSFER\r\n* PRIV_TRAVEL_EXPENSES\r\n* PRIV_TRAVEL_MONEY\r\n* PRIV_TUITION\r\n* PRIV_WEDDING\r\n* PROPERTY_MANAGEMENT\r\n* SALARY\r\n* SUPPLIERS\r\n* TAX\r\n* TEMPORARY_CODE_102\r\n* TEMPORARY_CODE_103\r\n* TRAVEL_SERVICES\r\n</details>","operationId":"Get","consumes":[],"produces":["application/json"],"parameters":[{"name":"currency","in":"path","description":"Currency code to get purposes of payment for.","required":true,"type":"string"}],"responses":{"200":{"description":"Returns list of purposes of payment.","schema":{"$ref":"#/definitions/PurposeOfPaymentListResponse"},"examples":{"application/json":{"content":[{"code":"PRIV_BILL_PAYMENT","allowFreeText":true}]}}},"400":{"description":"Purposes of payment not found for this user","schema":{"$ref":"#/definitions/PurposeOfPaymentListResponse"},"examples":{"application/json":{"message":"Request failed validation.","errors":[{"code":"CURRENCY_VALIDATION","data":[{"key":"currency","value":"Currency is required."}]}]}}},"500":{"description":"Error getting purposes of payment for this user."}}}},"/quotes":{"post":{"tags":["Quote"],"summary":"Creates a quote for the currencies and amount provided.","description":"Sample request:\r\n            \r\n    POST /quotes\r\n            \r\n\\\r\nRequired user rights:\r\n            \r\n    CanQuote","operationId":"Create","consumes":["application/json-patch+json","application/json","text/json","application/*+json"],"produces":["text/plain","application/json","text/json"],"parameters":[{"name":"quoteRequest","in":"body","description":"Details needed to create a quote.","required":false,"schema":{"$ref":"#/definitions/CreateQuoteRequest"}}],"responses":{"200":{"description":"Returns the created quote.","schema":{"$ref":"#/definitions/QuoteResponse"},"examples":{"application/json":{"content":{"quoteId":"Quote_12016fea-5310-32b2-eca3-917c1ad62f87","quoteStatus":2,"quoteStatusText":"Quoted","expiryTimeMilliseconds":14127,"buyCurrency":"GBP","sellCurrency":"USD","baseCurrency":"GBP","rate":"1.7471","inverseRate":"0.5724","rateMovement":"","buyOrSell":"Sell","buyAmount":"57.24","sellAmount":"100.00","fees":"6.90","settlementAmount":"117.50","balanceAmount":"106.90","balanceDueDate":"2019-01-25","securityDeposit":"10.60","securityDepositDueDate":"2019-01-11","valueDate":"2019-01-25","availableDate":""},"warnings":[{"code":"WARN001"}],"information":[{"code":"INFO001"}]}}},"400":{"description":"Request was invalid.","schema":{"$ref":"#/definitions/QuoteResponse"},"examples":{"application/json":{"message":"Request failed validation.","errors":[{"code":"CREATE_QUOTE_REQUEST_VALIDATION","data":[{"key":"BuyCurrency","value":"Currency code must be 3 characters."}]}]}}},"500":{"description":"Error creating quote."}}}},"/quotes/{quoteId}":{"get":{"tags":["Quote"],"summary":"Refreshes a quote to gain an up-to-date quote.","description":"Sample request:\r\n            \r\n    GET /quotes/Quote_123456-1234\r\n    GET /quotes/Quote_123456-1234?refresh=false\r\n\\\r\nRequired user rights:\r\n            \r\n    CanQuote","operationId":"Refresh","consumes":[],"produces":["text/plain","application/json","text/json"],"parameters":[{"name":"quoteId","in":"path","description":"ID of the quote to be refreshed.","required":true,"type":"string"},{"name":"refresh","in":"query","description":"Set to false to return a cached quote if available, or 404 if no cached quote is found.","required":false,"type":"boolean"}],"responses":{"200":{"description":"Returns the refreshed quote.","schema":{"$ref":"#/definitions/QuoteResponse"},"examples":{"application/json":{"content":{"quoteId":"Quote_12016fea-5310-32b2-eca3-917c1ad62f87","quoteStatus":2,"quoteStatusText":"Quoted","expiryTimeMilliseconds":14127,"buyCurrency":"GBP","sellCurrency":"USD","baseCurrency":"GBP","rate":"1.7471","inverseRate":"0.5724","rateMovement":"","buyOrSell":"Sell","buyAmount":"57.24","sellAmount":"100.00","fees":"6.90","settlementAmount":"117.50","balanceAmount":"106.90","balanceDueDate":"2019-01-25","securityDeposit":"10.60","securityDepositDueDate":"2019-01-11","valueDate":"2019-01-25","availableDate":""},"warnings":[{"code":"WARN001"}],"information":[{"code":"INFO001"}]}}},"404":{"description":"Quote not found."},"500":{"description":"Error refreshing quote."}}},"patch":{"tags":["Quote"],"summary":"Updates a quote to change or add more details.","description":"Sample request:\r\n            \r\n    PATCH /quotes/Quote_123456-1234\r\n            \r\n\\\r\nRequired user rights:\r\n            \r\n    CanQuote","operationId":"Update","consumes":["application/json-patch+json","application/json","text/json","application/*+json"],"produces":["text/plain","application/json","text/json"],"parameters":[{"name":"quoteRequest","in":"body","description":"Details to update the quote with. If a value is null then the attribute will not be updated.","required":false,"schema":{"$ref":"#/definitions/UpdateQuoteRequest"}},{"name":"quoteId","in":"path","description":"ID of the quote to be updated.","required":true,"type":"string"}],"responses":{"200":{"description":"Returns the updated quote.","schema":{"$ref":"#/definitions/QuoteResponse"},"examples":{"application/json":{"content":{"quoteId":"Quote_12016fea-5310-32b2-eca3-917c1ad62f87","quoteStatus":2,"quoteStatusText":"Quoted","expiryTimeMilliseconds":14127,"buyCurrency":"GBP","sellCurrency":"USD","baseCurrency":"GBP","rate":"1.7471","inverseRate":"0.5724","rateMovement":"","buyOrSell":"Sell","buyAmount":"57.24","sellAmount":"100.00","fees":"6.90","settlementAmount":"117.50","balanceAmount":"106.90","balanceDueDate":"2019-01-25","securityDeposit":"10.60","securityDepositDueDate":"2019-01-11","valueDate":"2019-01-25","availableDate":""},"warnings":[{"code":"WARN001"}],"information":[{"code":"INFO001"}]}}},"400":{"description":"Request was invalid.","schema":{"$ref":"#/definitions/QuoteResponse"},"examples":{"application/json":{"message":"Request failed validation.","errors":[{"code":"UPDATE_QUOTE_REQUEST_VALIDATION","data":[{"key":"Amount","value":"Must be greater than 0."}]}]}}},"404":{"description":"Quote not found."},"500":{"description":"Error updating quote."}}}},"/recipients":{"get":{"tags":["Recipient"],"summary":"Gets recipients for a currency.","description":"Sample requests:\r\n            \r\n    GET /recipients?currency=GBP\r\n            \r\n\\\r\nRequired user rights:\r\n            \r\n    CanAccessRecipients","operationId":"Get","consumes":[],"produces":["text/plain","application/json","text/json"],"parameters":[{"name":"currency","in":"query","description":"Get recipients for a specific currency.","required":false,"type":"string"}],"responses":{"200":{"description":"Returns the list of recipients.","schema":{"$ref":"#/definitions/RecipientListResponse"},"examples":{"application/json":{"content":[{"id":1234567,"name":"Joe Smith","currency":"GBP","accountNumber":"87654321","accountName":"Joe Smith","bankName":"BankName","bankCountry":"GB","nickname":"Nickname","paymentReference":"Reference","purposeOfPaymentCode":"PRIV_OTHER","purposeOfPaymentFreeText":"Free text","bankAddressLine1":"Bank 1","bankAddressLine2":"Bank 2","bankAddressLine3":"Bank 3","bankBic":"194857","nationalClearingCode":"1235457","addressLine1":"Address1","addressLine2":"Address2","addressLine3":"Address3","email":"Joe.Smith@email.com","intermediaryBankAddressLine1":"IntBank1","intermediaryBankAddressLine2":"IntBank2","intermediaryBankAddressLine3":"IntBank3","intermediaryBankBic":"6582342","intermediaryNationalClearingCode":"6534211","intermediaryBankName":"IntBankName","intermediaryBankAddressCountryCode":"GB","intermediaryAccountNumber":"564245821"}]}}},"400":{"description":"Request was invalid.","schema":{"$ref":"#/definitions/RecipientListResponse"},"examples":{"application/json":{"message":"Invalid currency code.","errors":[{"code":"RECIPIENT001","data":[{"key":"currency","value":"123"}]}]}}},"404":{"description":"No recipients were found."},"500":{"description":"Error getting recipients."}}},"post":{"tags":["Recipient"],"summary":"Creates a recipient with the details provided.","description":"Sample request:\r\n            \r\n    POST /recipients\r\n            \r\n\\\r\nRequired user rights:\r\n            \r\n    CanAddRecipient","operationId":"Create","consumes":["application/json-patch+json","application/json","text/json","application/*+json"],"produces":["text/plain","application/json","text/json"],"parameters":[{"name":"recipientRequest","in":"body","description":"Details needed to create a recipient. The fields that are required, and those that can be included in the request, vary depending on the country and the currency.\r\n             Use GET /recipients/fields/{country}/{currency} to retrieve the valid format for the country/currency combination.","required":false,"schema":{"$ref":"#/definitions/RecipientRequest"}}],"responses":{"200":{"description":"Returns the created recipient.","schema":{"$ref":"#/definitions/RecipientResponse"},"examples":{"application/json":{"content":{"id":1234567,"name":"Joe Smith","currency":"GBP","accountNumber":"87654321","accountName":"Joe Smith","bankName":"BankName","bankCountry":"GB","nickname":"Nickname","paymentReference":"Reference","purposeOfPaymentCode":"PRIV_OTHER","purposeOfPaymentFreeText":"Free text","bankAddressLine1":"Bank 1","bankAddressLine2":"Bank 2","bankAddressLine3":"Bank 3","bankBic":"194857","nationalClearingCode":"1235457","addressLine1":"Address1","addressLine2":"Address2","addressLine3":"Address3","email":"Joe.Smith@email.com","intermediaryBankAddressLine1":"IntBank1","intermediaryBankAddressLine2":"IntBank2","intermediaryBankAddressLine3":"IntBank3","intermediaryBankBic":"6582342","intermediaryNationalClearingCode":"6534211","intermediaryBankName":"IntBankName","intermediaryBankAddressCountryCode":"GB","intermediaryAccountNumber":"564245821"},"warnings":[{"code":"WARN001"}],"information":[{"code":"INFO001"}]}}},"400":{"description":"Request was invalid.","schema":{"$ref":"#/definitions/RecipientResponse"},"examples":{"application/json":{"message":"Request failed validation.","errors":[{"code":"CREATE_RECIPIENT_REQUEST_VALIDATION","data":[{"key":"BankCountryCode","value":"Country code must be 2 characters."}]}]}}},"500":{"description":"Error creating recipient."}}}},"/recipients/{recipientId}":{"delete":{"tags":["Recipient"],"summary":"Delete a recipient.","description":"Sample request:\r\n            \r\n    DELETE /recipients/{recipientId}\r\n            \r\n\\\r\nRequired user rights:\r\n            \r\n    CanDeleteRecipient","operationId":"Delete","consumes":[],"produces":[],"parameters":[{"name":"recipientId","in":"path","description":"Recipient ID of recipient to delete.","required":true,"type":"integer","format":"int32"}],"responses":{"204":{"description":"Recipient has been deleted."},"404":{"description":"Recipient not found."},"500":{"description":"Error occurred while deleting the recipient."}}}},"/recipients/fields/{country}/{currency}":{"get":{"tags":["Recipient"],"summary":"Gets all recipient field definitions for a user for a specified currency and a country.","description":"Sample request:\r\n            \r\n    GET /recipients/fields/AU/GBP\r\n            \r\n\\\r\nRequired user rights:\r\n            \r\n    CanAccessRecipients\r\n            \r\n\\\r\n<details><summary>**Names and descriptions for the fields that can be returned**</summary>\r\n*   ibanOrAccountNumber - Used if either an IBAN, or an domestic Account Number can be provided.\r\n*   accountNumber - Account Number (Domestic - with respect to the Bank Address Country Code) for the recipient's bank account.\r\n*   iban - International Bank Account Number for the recipient's bank account.\r\n*   nationalClearingCode - National Clearing Code for the recipient's bank.\r\n*   bankAccountType - The type of bank account. (NOTE: is looking for an integer value that should map to the values stored for each type, e.g. 10 for Savings)\r\n*   bankBic - Bank Identification Code for the recipient's bank.\r\n*   bankName - Name of the bank for the recipient's account.\r\n*   bankAddressLine1 - Line 1 of the address for the recipient's bank.\r\n*   bankAddressLine2 - Line 2 of the address for the recipient's bank.\r\n*   bankAddressLine3 - Line 3 of the address for the recipient's bank.\r\n*   bankAddressCountryCode - Country code for the recipient's bank.\r\n*   accountName - Name of the recipient on their bank account.\r\n*   email -  Email for the recipient.\r\n*   addressLine1 - Line 1 of the address for the recipient.\r\n*   addressLine2 - Line 2 of the address for the recipient.\r\n*   addressCountryCode - Country code of the address for the recipient.\r\n*   paymentReference - Client specified reference when making payments to the recipient.\r\n*   intermediaryBankNationalClearingCode - National Clearing Code for an intermediary bank.\r\n*   intermediaryBankBic - Bank Identification Code for an intermediary bank.\r\n*   intermediaryBankName - Name of the intermediary bank.\r\n*   intermediaryBankIbanOrAccountNumber - IBAN or Account Number for an intermediary bank.\r\n*   intermediaryBankAddressLine1 - Line 1 of the address for an intermediary bank.\r\n*   intermediaryBankAddressLine2 - Line 2 of the address for an intermediary bank.\r\n*   intermediaryBankAddressLine3 - Line 3 of the address for an intermediary bank.\r\n*   intermediaryBankAddressCountryCode - Country code for an intermediary bank.\r\n*   purposeOfPaymentCode - Default purpose of payment code for the recipient.\r\n*   purposeOfPaymentFreeText - Default purpose of payment free text for the recipient.\r\n*   nickname - Nickname specified by the client.\r\n</details>","operationId":"GetRecipientFieldDefinitions","consumes":[],"produces":["text/plain","application/json","text/json"],"parameters":[{"name":"country","in":"path","description":"Country code to get recipient field definitions for.","required":true,"type":"string"},{"name":"currency","in":"path","description":"Currency code to get recipient field definitions for.","required":true,"type":"string"}],"responses":{"200":{"description":"Returns all Recipient Field definitions.","schema":{"$ref":"#/definitions/RecipientFieldDefinitionsResponse"},"examples":{"application/json":{"content":{"fieldDefinitions":[{"fieldName":"accountName","regEx":"^[a-zA-Z0-9\\s\\(\\)\\+\\-'/\\?\\.:,]{1,70}$","required":false,"fieldType":"Text","allowedValues":[]},{"fieldName":"addressLine1","regEx":"^$|^[a-zA-Z0-9,\\s\\(\\)\\+\\-'/\\?\\.:]{3,35}$","required":false,"fieldType":"Text","allowedValues":[]}],"contentReplacements":{"COUNTRY_CODE":"GB","ACCOUNT_LENGTH":"8"},"errors":{},"infos":{}}}}},"400":{"description":"Request was invalid.","schema":{"$ref":"#/definitions/RecipientFieldDefinitionsResponse"},"examples":{"application/json":{"message":"Request failed validation.","errors":[{"code":"COUNTRY_VALIDATION","data":[{"key":"GBR","value":"Country code must be 2 characters."}]}]}}},"500":{"description":"Error getting all Recipient Field definitions."}}}},"/tradeablecurrencies":{"get":{"tags":["TradeableCurrency"],"summary":"Get tradeable currencies.","description":"Sample request:\r\n\r\n    Get /tradeablecurrencies","operationId":"Get","consumes":[],"produces":["application/json"],"parameters":[],"responses":{"200":{"description":"Returns list of Tradeable currencies.","schema":{"$ref":"#/definitions/TradeableCurrencyListResponse"},"examples":{"application/json":{"content":[{"amountPrecision":2,"isoCode":"AED","name":"UAE Dirham","canBuy":true,"canSell":true}]}}},"404":{"description":"Tradeable currencies not found for this user"},"500":{"description":"Error getting Tradeable currencies."}}}},"/transactions":{"get":{"tags":["Transaction"],"summary":"Gets a list of transactions for the specified page number and page size, filtered by creation date.","description":"Sample request:\r\n            \r\n    GET /transactions?fromDate=2019-01-10","operationId":"GetList","consumes":[],"produces":["text/plain","application/json","text/json"],"parameters":[{"name":"pageNumber","in":"query","description":"The page to return (First page is page 0).","required":false,"type":"integer","format":"int32","default":0},{"name":"pageSize","in":"query","description":"The number of transactions per page.","required":false,"type":"integer","format":"int32","default":4},{"name":"fromDate","in":"query","description":"Date to get transactions from.","required":false,"type":"string","default":"2019-01-01"},{"name":"toDate","in":"query","description":"Date to get transactions up to.","required":false,"type":"string"}],"responses":{"200":{"description":"Returns the specified page of transactions, filtered by creation date.","schema":{"$ref":"#/definitions/TransactionPagedDataResponse"},"examples":{"application/json":{"content":{"content":[{"transactionId":12345678,"isValidTransaction":true,"buyOrSell":"Sell","transactionReference":"C4281953","transactionDate":"2019-01-08","transactionStatus":"Confirmed","workflowState":"AwaitingBalance","buyCurrency":"GBP","buyAmount":57.24,"sellCurrency":"USD","sellAmount":100,"baseCurrency":"GBP","rate":1.7471,"fees":6.9,"feeCurrency":"USD","valueDate":"2019-01-25","payments":[{"amount":57.24,"recipientId":1234567,"reference":"Reference","recipientEmailAddress":"recip@email.co.uk","purposeOfPaymentCode":"PRIV_OTHER","purposeOfPaymentFreeText":"Free text"}],"settlementAccountDetails":{"accountName":"AccountName","accountNumber":"123456789","iban":"GB41ABCD285627869934271","bankName":"BankName","branch":"BranchName","addressLine1":"Address1","addressLine2":"Address2","addressLine3":"Address3","swiftCode":"ABCDGB64","nationalClearingCode":"273841","supportsBPayPayment":false,"bPayPaymentName":"","bPayBillerCode":null},"bPayCustomerReferenceNumber":0,"settlementAmount":117.5,"balanceAmount":106.9,"balanceDueDate":"2019-01-25","securityDeposit":10.6,"securityDepositDueDate":"2019-01-11"},{"transactionId":12345682,"isValidTransaction":true,"buyOrSell":"Buy","transactionReference":"C4287591","transactionDate":"2019-01-27","transactionStatus":"Confirmed","workflowState":"AwaitingBalance","buyCurrency":"GBP","buyAmount":150,"sellCurrency":"USD","sellAmount":262.05,"baseCurrency":"GBP","rate":1.747,"fees":12,"feeCurrency":"USD","valueDate":"2019-01-29","payments":[{"amount":57.24,"recipientId":1234567,"reference":"Reference","recipientEmailAddress":"recip@email.co.uk","purposeOfPaymentCode":"PRIV_OTHER","purposeOfPaymentFreeText":"Free text"}],"settlementAccountDetails":{"accountName":"AccountName","accountNumber":"123456789","iban":"GB41ABCD285627869934271","bankName":"BankName","branch":"BranchName","addressLine1":"Address1","addressLine2":"Address2","addressLine3":"Address3","swiftCode":"ABCDGB64","nationalClearingCode":"273841","supportsBPayPayment":false,"bPayPaymentName":"","bPayBillerCode":null},"bPayCustomerReferenceNumber":0,"settlementAmount":274.05,"balanceAmount":274.05,"balanceDueDate":"2019-01-29","securityDeposit":0,"securityDepositDueDate":""}],"totalRecords":2,"pageSize":4,"pageNumber":0}}}},"400":{"description":"Invalid dates or paging parameters.","schema":{"$ref":"#/definitions/TransactionPagedDataResponse"},"examples":{"application/json":{"message":"fromDate must be earlier than toDate."}}},"404":{"description":"No transactions found."},"500":{"description":"Error getting transactions."}}},"post":{"tags":["Transaction"],"summary":"Creates a transaction for the quote specified.","description":"Sample request:\r\n            \r\n    POST /transactions\r\n            \r\n\\\r\nRequired user rights:\r\n            \r\n    CanQuoteAndCreateTransaction","operationId":"Book","consumes":["application/json-patch+json","application/json","text/json","application/*+json"],"produces":["text/plain","application/json","text/json"],"parameters":[{"name":"transactionRequest","in":"body","description":"Details needed to create a transaction.","required":false,"schema":{"$ref":"#/definitions/CreateTransactionRequest"}}],"responses":{"200":{"description":"Returns the created transaction.","schema":{"$ref":"#/definitions/TransactionResponse"},"examples":{"application/json":{"content":{"transactionId":12345678,"isValidTransaction":true,"buyOrSell":"Sell","transactionReference":"C4281953","transactionDate":"2019-01-08","transactionStatus":"Confirmed","workflowState":"AwaitingBalance","buyCurrency":"GBP","buyAmount":57.24,"sellCurrency":"USD","sellAmount":100,"baseCurrency":"GBP","rate":1.7471,"fees":6.9,"feeCurrency":"USD","valueDate":"2019-01-25","payments":[{"amount":57.24,"recipientId":1234567,"reference":"Reference","recipientEmailAddress":"recip@email.co.uk","purposeOfPaymentCode":"PRIV_OTHER","purposeOfPaymentFreeText":"Free text"}],"settlementAccountDetails":{"accountName":"AccountName","accountNumber":"123456789","iban":"GB41ABCD285627869934271","bankName":"BankName","branch":"BranchName","addressLine1":"Address1","addressLine2":"Address2","addressLine3":"Address3","swiftCode":"ABCDGB64","nationalClearingCode":"273841","supportsBPayPayment":false,"bPayPaymentName":"","bPayBillerCode":null},"bPayCustomerReferenceNumber":0,"settlementAmount":117.5,"balanceAmount":106.9,"balanceDueDate":"2019-01-25","securityDeposit":10.6,"securityDepositDueDate":"2019-01-11"},"warnings":[{"code":"WARN004"}]}}},"400":{"description":"There was an issue with the quote data.","schema":{"$ref":"#/definitions/TransactionResponse"},"examples":{"application/json":{"message":"Quote failed validation.","errors":[{"code":"TRANSACTION001"}]}}},"404":{"description":"Quote for the transaction was not found."},"500":{"description":"Error creating transaction."}}}},"/transactions/{transactionId}":{"get":{"tags":["Transaction"],"summary":"Gets a transaction with the specified ID.","description":"Sample request:\r\n            \r\n    GET /transactions/20258137","operationId":"Get","consumes":[],"produces":["text/plain","application/json","text/json"],"parameters":[{"name":"transactionId","in":"path","description":"ID of the transaction to get.","required":true,"type":"integer","format":"int32"}],"responses":{"200":{"description":"Returns the transaction.","schema":{"$ref":"#/definitions/TransactionResponse"},"examples":{"application/json":{"content":{"transactionId":12345678,"isValidTransaction":true,"buyOrSell":"Sell","transactionReference":"C4281953","transactionDate":"2019-01-08","transactionStatus":"Confirmed","workflowState":"AwaitingBalance","buyCurrency":"GBP","buyAmount":57.24,"sellCurrency":"USD","sellAmount":100,"baseCurrency":"GBP","rate":1.7471,"fees":6.9,"feeCurrency":"USD","valueDate":"2019-01-25","payments":[{"amount":57.24,"recipientId":1234567,"reference":"Reference","recipientEmailAddress":"recip@email.co.uk","purposeOfPaymentCode":"PRIV_OTHER","purposeOfPaymentFreeText":"Free text"}],"settlementAccountDetails":{"accountName":"AccountName","accountNumber":"123456789","iban":"GB41ABCD285627869934271","bankName":"BankName","branch":"BranchName","addressLine1":"Address1","addressLine2":"Address2","addressLine3":"Address3","swiftCode":"ABCDGB64","nationalClearingCode":"273841","supportsBPayPayment":false,"bPayPaymentName":"","bPayBillerCode":null},"bPayCustomerReferenceNumber":0,"settlementAmount":117.5,"balanceAmount":106.9,"balanceDueDate":"2019-01-25","securityDeposit":10.6,"securityDepositDueDate":"2019-01-11"}}}},"400":{"description":"Invalid transaction ID.","schema":{"$ref":"#/definitions/TransactionResponse"},"examples":{"application/json":{"message":"transactionId must be greater than 0."}}},"404":{"description":"Transaction not found."},"500":{"description":"Error getting transaction."}}}}},"definitions":{"StringArrayResponse":{"description":"Generic response returned for each request.\r\n            \r\n\"message\" - Result from the request.\r\n\"content\" - Data returned in the response.\r\n\"errors\" - Issues while processing the request.\r\n\"warnings\" - Potential issues while processing the request or with the response data.\r\n\"information\" - Extra details relating to the response data.\r\n<typeparam name=\"T\">The type of the content.</typeparam>","type":"object","properties":{"content":{"uniqueItems":false,"type":"array","items":{"type":"string"}},"message":{"type":"string"},"errors":{"uniqueItems":false,"type":"array","items":{"$ref":"#/definitions/Message"}},"warnings":{"uniqueItems":false,"type":"array","items":{"$ref":"#/definitions/Message"}},"information":{"uniqueItems":false,"type":"array","items":{"$ref":"#/definitions/Message"}}}},"Message":{"description":"Details for an error or warning that occured during the request or general information from it.\r\n            \r\n\"code\" - Code that can be used to find full details for the message.\r\n\"data\" - Any relevant data that caused the message, if applicable.","type":"object","properties":{"code":{"type":"string"},"data":{"uniqueItems":false,"type":"array","items":{"$ref":"#/definitions/StringStringKeyValuePair"}}}},"StringStringKeyValuePair":{"type":"object","properties":{"key":{"type":"string","readOnly":true},"value":{"type":"string","readOnly":true}}},"PurposeOfPaymentListResponse":{"description":"Generic response returned for each request.\r\n            \r\n\"message\" - Result from the request.\r\n\"content\" - Data returned in the response.\r\n\"errors\" - Issues while processing the request.\r\n\"warnings\" - Potential issues while processing the request or with the response data.\r\n\"information\" - Extra details relating to the response data.\r\n<typeparam name=\"T\">The type of the content.</typeparam>","type":"object","properties":{"content":{"uniqueItems":false,"type":"array","items":{"$ref":"#/definitions/PurposeOfPayment"}},"message":{"type":"string"},"errors":{"uniqueItems":false,"type":"array","items":{"$ref":"#/definitions/Message"}},"warnings":{"uniqueItems":false,"type":"array","items":{"$ref":"#/definitions/Message"}},"information":{"uniqueItems":false,"type":"array","items":{"$ref":"#/definitions/Message"}}}},"PurposeOfPayment":{"type":"object","properties":{"code":{"type":"string"},"allowFreeText":{"type":"boolean"}}},"CreateQuoteRequest":{"description":"Request body for creating a new quote. Quotes expire in around 15 seconds.\r\n\r\nSWIFT characters match the following regular expression: ^[\\r\\n\\sa-zA-Z0-9\\/\\-:,'\\?\\(\\)\\.\\+]*$\r\n            \r\n\"buyCurrency\" - Code of the currency being converted to.\r\n\"sellCurrency\" - Code of the currency provided by the client.\r\n\"buyOrSell\" - 'Buy' or 'Sell': Whether the client is buying or selling the amount of currency.\r\n\"amount\" - Amount of the currency being bought or sold.\r\n\"recipientId\" - Optional: ID of the recipient to make the payment to. Note that this is required for a contract to be updated, so if not provided on creation then the quote will need updating to contain it.\r\n\"reference\" - Optional: Reference for the recipient to identify a transfer. SWIFT characters only.\r\n\"purposeOfPaymentCode\" - Optional: Code for the reason why the client is making the transfer. Cannot be an empty string, if provided. Note that this is required for a contract to be updated, so if not provided on creation then the quote will need updating to contain it.\r\n\"purposeOfPaymentFreeText\" - Optional: If allowed for the code, the client can enter their reason for the transfer in text form. SWIFT characters only.\r\n\"recipientEmailAddress\" - Optional: Email address that will be notified when the payment is made.\r\n\"privateReference\" - Optional: Private reference for the client to identify a transfer. SWIFT characters only.\r\n\"valueDate\" - Optional: yyyy-MM-dd - Effective date of the transfer.","required":["amount","buyOrSell","buyCurrency","sellCurrency"],"type":"object","properties":{"amount":{"format":"double","type":"number"},"buyOrSell":{"type":"string"},"buyCurrency":{"type":"string"},"sellCurrency":{"type":"string"},"recipientId":{"format":"int32","type":"integer"},"reference":{"type":"string"},"purposeOfPaymentCode":{"type":"string"},"purposeOfPaymentFreeText":{"type":"string"},"recipientEmailAddress":{"type":"string"},"privateReference":{"type":"string"},"valueDate":{"type":"string"}},"example":{"amount":100,"buyOrSell":"Sell","buyCurrency":"GBP","sellCurrency":"USD","recipientId":1234567,"reference":"Reference","purposeOfPaymentCode":"CORP_OTHER","purposeOfPaymentFreeText":"Free text","recipientEmailAddress":"recip@email.co.uk","privateReference":"Private reference","valueDate":"2019-01-25"}},"QuoteResponse":{"description":"Generic response returned for each request.\r\n            \r\n\"message\" - Result from the request.\r\n\"content\" - Data returned in the response.\r\n\"errors\" - Issues while processing the request.\r\n\"warnings\" - Potential issues while processing the request or with the response data.\r\n\"information\" - Extra details relating to the response data.\r\n<typeparam name=\"T\">The type of the content.</typeparam>","type":"object","properties":{"content":{"$ref":"#/definitions/Quote"},"message":{"type":"string"},"errors":{"uniqueItems":false,"type":"array","items":{"$ref":"#/definitions/Message"}},"warnings":{"uniqueItems":false,"type":"array","items":{"$ref":"#/definitions/Message"}},"information":{"uniqueItems":false,"type":"array","items":{"$ref":"#/definitions/Message"}}}},"Quote":{"description":"Details for a quote.\r\n            \r\n\"quoteId\" - ID of the quote.\r\n\"quoteStatus\" - Enum value for the status of the quote.\r\n\"quoteStatusText\" - Text value for the status of the quote.\r\n\"expiryTimeMilliseconds\" - Amount of time until the quote expires.\r\n\"buyCurrency\" - Code of the currency being converted to.\r\n\"sellCurrency\" - Code of the currency provided by the client.\r\n\"baseCurrency\" - Code of the base currency for the currency pair.\r\n\"rate\" - Quoted exchange rate of base currency to the other currency.\r\n\"inverseRate\" - Inverse quoted exchange rate of the currency pair.\r\n\"rateMovement\" - Whether the rate is better or worse than the previous rate for this quote.\r\n\"buyOrSell\" - Whether the client is buying or selling the amount of currency.\r\n\"buyAmount\" - Amount of money for the buy currency.\r\n\"sellAmount\" - Amount of money for the sell currency.\r\n\"fees\" - Total fees for the transfer of the specified currencies.\r\n\"settlementAmount\" - Total cost to the client, including fees.\r\n\"balanceAmount\" - Amount of money the client has left to pay for the contract.\r\n\"balanceDueDate\" - yyyy-MM-dd: Date by which the contract balance is to be paid by the client.\r\n\"securityDeposit\" - Amount of money the client has to pay for the security deposit.\r\n\"securityDepositDueDate\" - Date by which the security deposit is to be paid by the client. This will be confirmed when the contract is created.\r\n\"valueDate\" - yyyy-MM-dd: Effective date of the transfer.\r\n\"availableDate\" - yyyy-MM-dd: Date the contract proceeds should be available (received) by the recipient.","type":"object","properties":{"quoteId":{"type":"string"},"quoteStatus":{"format":"int32","description":"\n0 = NotSet\n1 = Error\n2 = Quoted\n3 = PollRequired\n4 = FailedValidation\n5 = InvalidQuoteId\n6 = Timeout\n7 = Validated","enum":[0,1,2,3,4,5,6,7],"type":"integer"},"quoteStatusText":{"type":"string","readOnly":true},"expiryTimeMilliseconds":{"format":"int32","type":"integer"},"buyCurrency":{"type":"string"},"sellCurrency":{"type":"string"},"baseCurrency":{"type":"string"},"rate":{"type":"string"},"inverseRate":{"type":"string"},"rateMovement":{"type":"string"},"buyOrSell":{"type":"string"},"buyAmount":{"type":"string"},"sellAmount":{"type":"string"},"fees":{"type":"string"},"settlementAmount":{"type":"string"},"balanceAmount":{"type":"string"},"balanceDueDate":{"type":"string"},"securityDeposit":{"type":"string"},"securityDepositDueDate":{"type":"string"},"valueDate":{"type":"string"},"availableDate":{"type":"string"}}},"UpdateQuoteRequest":{"description":"Request body for updating a quote.\r\n\r\nSWIFT characters match the following regular expression: ^[\\r\\n\\sa-zA-Z0-9\\/\\-:,'\\?\\(\\)\\.\\+]*$\r\n            \r\n\"amount\" - Optional: Amount of the currency being bought or sold.\r\n\"recipientId\" - Optional: ID of the recipient to make the payment to.\r\n\"reference\" - Optional: Reference for the recipient to identify a transaction. Note that this is required for a contract to be updated, so if not provided on creation then the quote will need updating to contain it. SWIFT characters only.\r\n\"purposeOfPaymentCode\" - Optional: Code for the reason why the client is making the transfer. Cannot be an empty string, if provided. Note that this is required for a contract to be updated, so if not provided on creation then the quote will need updating to contain it.\r\n\"purposeOfPaymentFreeText\" - Optional: If allowed for the code, the client can enter their reason for the transfer in text form. SWIFT characters only.\r\n\"recipientEmailAddress\" - Optional: Email address that will be notified when the payment is made.\r\n\"privateReference\" - Optional: Private reference for the client to identify a transfer. SWIFT characters only.\r\n\"valueDate\" - Optional: yyyy-MM-dd - Effective date of the transfer.","type":"object","properties":{"amount":{"format":"double","type":"number"},"recipientId":{"format":"int32","type":"integer"},"reference":{"type":"string"},"purposeOfPaymentCode":{"type":"string"},"purposeOfPaymentFreeText":{"type":"string"},"recipientEmailAddress":{"type":"string"},"privateReference":{"type":"string"},"valueDate":{"type":"string"}},"example":{"amount":150,"recipientId":1234567,"reference":"Reference","purposeOfPaymentCode":"PRIV_OTHER","purposeOfPaymentFreeText":"Free text","recipientEmailAddress":"recip@email.co.uk","privateReference":"Private reference","valueDate":"2019-01-26"}},"RecipientRequest":{"description":"Request body for creating a new recipient.\r\n            \r\n\"bankCountryCode\" - Country code of the bank for the recipient.\r\n\"currencyCode\" - Currency code that the recipient is for.\r\n\"fields\" - Dynamic set of fields, which will include all the other required/optional fields to create a recipient for the country/currency combination.","type":"object","properties":{"bankCountryCode":{"type":"string"},"currencyCode":{"type":"string"},"fields":{"uniqueItems":false,"type":"array","items":{"$ref":"#/definitions/RecipientField"}}},"example":{"bankCountryCode":"GB","currencyCode":"GBP","fields":[{"name":"AccountName","value":"Account Name"},{"name":"AccountNumber","value":"12548795"},{"name":"NationalClearingCode","value":"132546"},{"name":"BankName","value":"Bank Name"},{"name":"BankAccountType","value":"10"}]}},"RecipientField":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"}}},"RecipientResponse":{"description":"Generic response returned for each request.\r\n            \r\n\"message\" - Result from the request.\r\n\"content\" - Data returned in the response.\r\n\"errors\" - Issues while processing the request.\r\n\"warnings\" - Potential issues while processing the request or with the response data.\r\n\"information\" - Extra details relating to the response data.\r\n<typeparam name=\"T\">The type of the content.</typeparam>","type":"object","properties":{"content":{"$ref":"#/definitions/Recipient"},"message":{"type":"string"},"errors":{"uniqueItems":false,"type":"array","items":{"$ref":"#/definitions/Message"}},"warnings":{"uniqueItems":false,"type":"array","items":{"$ref":"#/definitions/Message"}},"information":{"uniqueItems":false,"type":"array","items":{"$ref":"#/definitions/Message"}}}},"Recipient":{"description":"Details for a recipient.\r\n            \r\n\"id\" - ID of the recipient.\r\n\"name\" - Display name of the recipient.\r\n\"currency\" - Currency code for the recipient's account.\r\n\"accountNumber\" - Bank account number for the recipient.\r\n\"accountName\" - Name of the recipient on their bank account.\r\n\"bankName\" - Name of the bank for the recipient's account.\r\n\"bankCountry\" - Country where the recipient's bank is located.\r\n\"nickname\" - Nickname specified by the client.\r\n\"paymentReference\" - Client specified reference when making payments to the recipient.\r\n\"purposeOfPaymentCode\" - Default purpose of payment code for the recipient.\r\n\"purposeOfPaymentFreeText\" - Default purpose of payment free text for the recipient.\r\n\"bankAddressLine1\" - Line 1 of the address for the recipient’s bank.\r\n\"bankAddressLine2\" - Line 2 of the address for the recipient’s bank.\r\n\"bankAddressLine3\" - Line 3 of the address for the recipient’s bank.\r\n\"bankBic\" - Bank Identification Code for the recipient’s bank.\r\n\"nationalClearingCode\" - National Clearing Code for the recipient’s bank.\r\n\"addressLine1\" - Line 1 of the address for the recipient.\r\n\"addressLine2\" - Line 2 of the address for the recipient.\r\n\"addressLine3\" - Line 3 of the address for the recipient.\r\n\"email\" - Email address for the recipient.\r\n\"intermediaryBankAddressLine1\" - Line 1 of the address for an intermediary bank.\r\n\"intermediaryBankAddressLine2\" - Line 2 of the address for an intermediary bank.\r\n\"intermediaryBankAddressLine3\" - Line 3 of the address for an intermediary bank.\r\n\"intermediaryBankBic\" - Bank Identification Code for an intermediary bank.\r\n\"intermediaryNationalClearingCode\" - National Clearing Code for an intermediary bank.\r\n\"intermediaryBankName\" - Name for an intermediary bank.\r\n\"intermediaryBankAddressCountryCode\" - Country code of the address for an intermediary bank.\r\n\"intermediaryAccountNumber\" - Account Number for an intermediary bank.","type":"object","properties":{"id":{"format":"int32","type":"integer"},"name":{"type":"string"},"currency":{"type":"string"},"accountNumber":{"type":"string"},"accountName":{"type":"string"},"bankName":{"type":"string"},"bankCountry":{"type":"string"},"nickname":{"type":"string"},"paymentReference":{"type":"string"},"purposeOfPaymentCode":{"type":"string"},"purposeOfPaymentFreeText":{"type":"string"},"bankAddressLine1":{"type":"string"},"bankAddressLine2":{"type":"string"},"bankAddressLine3":{"type":"string"},"bankBic":{"type":"string"},"nationalClearingCode":{"type":"string"},"addressLine1":{"type":"string"},"addressLine2":{"type":"string"},"addressLine3":{"type":"string"},"email":{"type":"string"},"intermediaryBankAddressLine1":{"type":"string"},"intermediaryBankAddressLine2":{"type":"string"},"intermediaryBankAddressLine3":{"type":"string"},"intermediaryBankBic":{"type":"string"},"intermediaryNationalClearingCode":{"type":"string"},"intermediaryBankName":{"type":"string"},"intermediaryBankAddressCountryCode":{"type":"string"},"intermediaryAccountNumber":{"type":"string"}}},"RecipientListResponse":{"description":"Generic response returned for each request.\r\n            \r\n\"message\" - Result from the request.\r\n\"content\" - Data returned in the response.\r\n\"errors\" - Issues while processing the request.\r\n\"warnings\" - Potential issues while processing the request or with the response data.\r\n\"information\" - Extra details relating to the response data.\r\n<typeparam name=\"T\">The type of the content.</typeparam>","type":"object","properties":{"content":{"uniqueItems":false,"type":"array","items":{"$ref":"#/definitions/Recipient"}},"message":{"type":"string"},"errors":{"uniqueItems":false,"type":"array","items":{"$ref":"#/definitions/Message"}},"warnings":{"uniqueItems":false,"type":"array","items":{"$ref":"#/definitions/Message"}},"information":{"uniqueItems":false,"type":"array","items":{"$ref":"#/definitions/Message"}}}},"RecipientFieldDefinitionsResponse":{"description":"Generic response returned for each request.\r\n            \r\n\"message\" - Result from the request.\r\n\"content\" - Data returned in the response.\r\n\"errors\" - Issues while processing the request.\r\n\"warnings\" - Potential issues while processing the request or with the response data.\r\n\"information\" - Extra details relating to the response data.\r\n<typeparam name=\"T\">The type of the content.</typeparam>","type":"object","properties":{"content":{"$ref":"#/definitions/RecipientFieldDefinitions"},"message":{"type":"string"},"errors":{"uniqueItems":false,"type":"array","items":{"$ref":"#/definitions/Message"}},"warnings":{"uniqueItems":false,"type":"array","items":{"$ref":"#/definitions/Message"}},"information":{"uniqueItems":false,"type":"array","items":{"$ref":"#/definitions/Message"}}}},"RecipientFieldDefinitions":{"description":"Details for a recipient field definitions\r\n            \r\n\"fieldDefinitions\" - List of recipient field definition.\r\n\"contentReplacements\" -  A list of replacements values that are applicable to this recipient field definition.\r\n\"errors\" - A list of errors occured when requesting the field definitions.\r\n\"infos\" - A list of information for field definitions (if there is any).","type":"object","properties":{"fieldDefinitions":{"uniqueItems":false,"type":"array","items":{"$ref":"#/definitions/RecipientFieldDefinition"}},"contentReplacements":{"type":"object","additionalProperties":{"type":"string"}},"errors":{"type":"object","additionalProperties":{"type":"object","additionalProperties":{"type":"string"}}},"infos":{"type":"object","additionalProperties":{"type":"object","additionalProperties":{"type":"string"}}}}},"RecipientFieldDefinition":{"description":"Details for a recipient field definition.\r\n            \r\n\"fieldName\" - Name of the recipient field.\r\n\"regEx\" - Allowed format of the field.\r\n\"required\" - Boolean value to indicate whether the field is mandatory or not.\r\n\"fieldType\" - Type of the field.\r\n\"allowedValues\" - Values allowed for the field. If it is null, can enter any value.","type":"object","properties":{"fieldName":{"type":"string"},"regEx":{"type":"string"},"required":{"type":"boolean"},"fieldType":{"type":"string"},"allowedValues":{"uniqueItems":false,"type":"array","items":{"$ref":"#/definitions/LocalisableString"}}}},"LocalisableString":{"description":"Details for the localisable string.\r\n            \r\n\"externalCode\" - code to indentify the display name.\r\n\"text\" - Text to display for the field.","type":"object","properties":{"externalCode":{"type":"string"},"text":{"type":"string"}}},"TradeableCurrencyListResponse":{"description":"Generic response returned for each request.\r\n            \r\n\"message\" - Result from the request.\r\n\"content\" - Data returned in the response.\r\n\"errors\" - Issues while processing the request.\r\n\"warnings\" - Potential issues while processing the request or with the response data.\r\n\"information\" - Extra details relating to the response data.\r\n<typeparam name=\"T\">The type of the content.</typeparam>","type":"object","properties":{"content":{"uniqueItems":false,"type":"array","items":{"$ref":"#/definitions/TradeableCurrency"}},"message":{"type":"string"},"errors":{"uniqueItems":false,"type":"array","items":{"$ref":"#/definitions/Message"}},"warnings":{"uniqueItems":false,"type":"array","items":{"$ref":"#/definitions/Message"}},"information":{"uniqueItems":false,"type":"array","items":{"$ref":"#/definitions/Message"}}}},"TradeableCurrency":{"type":"object","properties":{"amountPrecision":{"format":"int32","type":"integer"},"isoCode":{"type":"string"},"name":{"type":"string"},"canBuy":{"type":"boolean"},"canSell":{"type":"boolean"}}},"CreateTransactionRequest":{"required":["quoteId"],"type":"object","properties":{"quoteId":{"type":"string"}},"example":{"quoteId":"Quote_123456-1234"}},"TransactionResponse":{"description":"Generic response returned for each request.\r\n            \r\n\"message\" - Result from the request.\r\n\"content\" - Data returned in the response.\r\n\"errors\" - Issues while processing the request.\r\n\"warnings\" - Potential issues while processing the request or with the response data.\r\n\"information\" - Extra details relating to the response data.\r\n<typeparam name=\"T\">The type of the content.</typeparam>","type":"object","properties":{"content":{"$ref":"#/definitions/Transaction"},"message":{"type":"string"},"errors":{"uniqueItems":false,"type":"array","items":{"$ref":"#/definitions/Message"}},"warnings":{"uniqueItems":false,"type":"array","items":{"$ref":"#/definitions/Message"}},"information":{"uniqueItems":false,"type":"array","items":{"$ref":"#/definitions/Message"}}}},"Transaction":{"description":"\"transactionId\" - ID of the transaction.\r\n\"isValidTransaction\" - Whether there are any issues with the current transaction.\r\n\"buyOrSell\" - Whether the client is buying or selling the amount of currency.\r\n\"transactionReference\" - Reference for the transaction.\r\n\"transactionDate\" - Date the transaction was created.\r\n\"transactionStatus\" - Status of the transaction.\r\n\"workflowState\" - State of the workflow for the transaction.\r\n\"buyCurrency\" - Code of the currency being converted to.\r\n\"buyAmount\" - Amount of money for the buy currency.\r\n\"sellCurrency\" - Code of the currency provided by the client.\r\n\"sellAmount\" - Amount of money for the sell currency.\r\n\"baseCurrency\" - Code of the base currency for the currency pair.\r\n\"rate\" - Quoted exchange rate of base currency to the other currency.\r\n\"fees\" - Total fees for the transfer of the specified currencies.\r\n\"feeCurrency\" - Code of the currency the client will pay the fees in.\r\n\"valueDate\" - yyyy-MM-dd: Effective date of the transfer.\r\n\"payments\" - Details for the payments, including recipient details and purpose of payments.\r\n\"settlementAccountDetails\" - Bank account details the client can use to provide the settlement.\r\n\"bPayCustomerReferenceNumber\" - Reference number for the customer if it is a BPay payment.\r\n\"settlementAmount\" - Total cost to the client, including fees.\r\n\"balanceAmount\" - Amount of money the client has left to pay for the transaction.\r\n\"balanceDueDate\" - yyyy-MM-dd: Date by which the transaction balance is to be paid by the client.\r\n\"securityDeposit\" - Amount of money the client has to pay for the security deposit.\r\n\"securityDepositDueDate\" - yyyy-MM-dd: Date by which the security deposit is to be paid by the client.","type":"object","properties":{"transactionId":{"format":"int32","type":"integer"},"isValidTransaction":{"type":"boolean"},"buyOrSell":{"type":"string"},"transactionReference":{"type":"string"},"transactionDate":{"type":"string"},"transactionStatus":{"type":"string"},"workflowState":{"type":"string"},"buyCurrency":{"type":"string"},"buyAmount":{"format":"double","type":"number"},"sellCurrency":{"type":"string"},"sellAmount":{"format":"double","type":"number"},"baseCurrency":{"type":"string"},"rate":{"format":"double","type":"number"},"fees":{"format":"double","type":"number"},"feeCurrency":{"type":"string"},"valueDate":{"type":"string"},"payments":{"uniqueItems":false,"type":"array","items":{"$ref":"#/definitions/Payment"}},"settlementAccountDetails":{"$ref":"#/definitions/SettlementBankAccount"},"bPayCustomerReferenceNumber":{"format":"int64","type":"integer"},"settlementAmount":{"format":"double","type":"number"},"balanceAmount":{"format":"double","type":"number"},"balanceDueDate":{"type":"string"},"securityDeposit":{"format":"double","type":"number"},"securityDepositDueDate":{"type":"string"}}},"Payment":{"description":"Details for the payment including recipient details and purpose of payment.\r\n \r\n\"amount\" - Amount to pay the recipient.\r\n\"recipientID\" - ID of the recipient to make the payment to.\r\n\"reference\" - Reference for the payment to the recipient.\r\n\"emailAddress\" - Email address that will be notified when the payment is made.\r\n\"purposeOfPaymentCode\" - Code for the reason why the client is making the transfer.\r\n\"purposeOfPaymentFreeText\" - If allowed for the code, the client can enter their reason for the transfer in text form.","type":"object","properties":{"amount":{"format":"double","type":"number"},"recipientId":{"format":"int32","type":"integer"},"reference":{"type":"string"},"recipientEmailAddress":{"type":"string"},"purposeOfPaymentCode":{"type":"string"},"purposeOfPaymentFreeText":{"type":"string"}}},"SettlementBankAccount":{"description":"Bank details for the client.\r\n            \r\n\"accountName\" - Name of the account holder.\r\n\"accountNumber\" - Account number of the bank account.\r\n\"iban\" - IBAN for the bank account.\r\n\"bankName\" - Name of the bank for the account.\r\n\"branch\" - Branch for the bank account.\r\n\"addressLine1\" - Address of the branch.\r\n\"addressLine2\" - Address of the branch.\r\n\"addressLine3\" - Address of the branch.\r\n\"swiftCode\" - Swift code for the bank account.\r\n\"nationalClearingCode\" - NCC for the bank account.\r\n\"supportsBPayPayment\" - Whether BPAY payments are supported for the bank account.\r\n\"bPayPaymentName\" - Name used for a BPAY payment.\r\n\"bPayBillerCode\" - Biller code used for a BPAY payment.","type":"object","properties":{"accountName":{"type":"string"},"accountNumber":{"type":"string"},"iban":{"type":"string"},"bankName":{"type":"string"},"branch":{"type":"string"},"addressLine1":{"type":"string"},"addressLine2":{"type":"string"},"addressLine3":{"type":"string"},"swiftCode":{"type":"string"},"nationalClearingCode":{"type":"string"},"supportsBPayPayment":{"type":"boolean"},"bPayPaymentName":{"type":"string"},"bPayBillerCode":{"format":"int64","type":"integer"}}},"TransactionPagedDataResponse":{"description":"Generic response returned for each request.\r\n            \r\n\"message\" - Result from the request.\r\n\"content\" - Data returned in the response.\r\n\"errors\" - Issues while processing the request.\r\n\"warnings\" - Potential issues while processing the request or with the response data.\r\n\"information\" - Extra details relating to the response data.\r\n<typeparam name=\"T\">The type of the content.</typeparam>","type":"object","properties":{"content":{"$ref":"#/definitions/TransactionPagedData"},"message":{"type":"string"},"errors":{"uniqueItems":false,"type":"array","items":{"$ref":"#/definitions/Message"}},"warnings":{"uniqueItems":false,"type":"array","items":{"$ref":"#/definitions/Message"}},"information":{"uniqueItems":false,"type":"array","items":{"$ref":"#/definitions/Message"}}}},"TransactionPagedData":{"type":"object","properties":{"content":{"uniqueItems":false,"type":"array","items":{"$ref":"#/definitions/Transaction"}},"totalRecords":{"format":"int32","type":"integer"},"pageSize":{"format":"int32","type":"integer"},"pageNumber":{"format":"int32","type":"integer"}}}},"tags":[]}