Skip to main content
API docs by Redocly

PortX ORCA Account Management (0.3.2)

Download OpenAPI specification:Download

E-mail: betiana.darderes@portx.io

PortX ORCA semantic and interaction is based on ISO 20022 and restricted to the US banking domain. The scope covers the following communication flows: bank account opening, maintenance, closing and reporting. In many cases, the financial institution will require additional documentation that is available as PDF or Word document. The recommended solution is to group one ORCA message (for example the account opening request) with these accompanying documents in one file archive. The archive establishes the link between the different documents. Every ORCA request message has an attribute to support the ISO 20022 digital signature.

Accounts

Bank Account Management

Retrieves a list of accounts matching the parameters.

Authorizations:
jwtopenIdConnect
query Parameters
accountId.eq
string (Id) [ 1 .. 36 ] characters
Example: accountId.eq=5fb9d4d6-1a3c-11ed-861d-0242ac120002
accountOwnershipType.eq
string
accountType.eq
string
accountBranchCode.eq
string
status.eq
string <date> (Date)
Example: status.eq=2022-04-17

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

accountNumber.eq
string (AccountNumber) <= 30 characters
Example: accountNumber.eq=012345678

The account number or Basic Bank Account Number (BBAN). A Basic Bank Account Number (BBAN) is a bank account number that includes the domestic bank code, branch identifier, and account number. It is a unique identifier for a bank account within a specific country.

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Opens an Account

Authorizations:
jwtopenIdConnect
header Parameters
idempotencyId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Idempotency identifier used by the client when making repeated calls

servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Core-Validation-Mode
required
string

<ENFORCING|PERMISSIVE|DISABLED> Indicates how the API validates requests against the core validation request policy. ENFORCING: The API validates all requests against the core validation request policy. The API only sends requests that pass validation to the back-end core service. PERMISSIVE: The API validates all requests against the validation request policy. The API sends all requests to the back-end service, regardless of whether they pass or fail the core validation. DISABLED: The API does not validate any requests against the validation request policy. The API gateway sends all requests to the core back-end service.

Request Body schema: application/json
object (CompositeAccountIdentifier)

The composite account identifier provides unique account identification when overlaying its parts. [branch-type-subtype-number]

branch
string [ 1 .. 10 ] characters
Example: "1"

Account branch

type
string [ 1 .. 10 ] characters
Example: "DD"

Account type.

subtype
string [ 1 .. 10 ] characters
Example: "HA"

Account subtype

number
required
string [ 1 .. 20 ] characters
Example: "12345"

Account number

accountBranchId
string (ServicerBranchId) [ 1 .. 36 ] characters
Example: "SEA_1"

Identification of the account servicer institution at branch level or operation level.

accountNumber
string (AccountNumber) <= 30 characters
Example: "012345678"

The account number or Basic Bank Account Number (BBAN). A Basic Bank Account Number (BBAN) is a bank account number that includes the domestic bank code, branch identifier, and account number. It is a unique identifier for a bank account within a specific country.

Array of objects (RoutingNumber)
Array
number
string (ABANumber) = 9 characters
Example: "012345678"

The routing number (sometimes referred to as an ABA routing number, regarding the American Bankers Association) is a sequence of nine digits used by banks to identify specific financial institutions within the United States.

routingNumberType
string (RoutingNumberType) = 9 characters
Example: "ACH"

Different types of payments may require different bank routing numbers. Some possible values: ACH, WIRE, ElectronicCheck, PaperCheck

Array of objects (AccountIdentification)
Array
identification
string [ 1 .. 34 ] characters

Identification assigned by an institution.

schemeName
string [ 1 .. 35 ] characters
Example: "BBANIdentifier"

Name of the identification scheme, in PascalCase. Possible ISO 20022 compliant values names are: IssuerIdentificationNumber, BBANIdentifier, CHIPSUniversalIdentifier, UPICIdentifier, IBANIdentifier

issuer
string [ 1 .. 35 ] characters

Entity that assigns the identification.

accountType
required
string (AccountType) [ 1 .. 35 ] characters
Example: "Checking"

Type of the account. Some possible ISO 20022 compliant values are: Checking, CardAccount, CashPayment, Charges, CashIncome, Commission, ClearingParticipantSettlementAccount, LimitedLiquiditySavingsAccount, MarginalLending, MoneyMarket, NonResidentExternal, Overdraft, OverNightDeposit, Settlement, Salary, Savings, Tax, TransactingAccount, CashTrading, VirtualAccount, CreditCard, DebitCard, Universal, Investment, EpurseCard, CertificateOfDeposit, MoneyMarketChecking, RetirementAccount, StockOrBond, PrePaid, FleetCard, Cash, DebitAccount, CreditAccount, Benefit, HealthSavingsAccount, FlexibleSpendingAccount, ForBenefitOf, Estate, ClientTrustAccount, LawyersTrustAccount, KeoghPlanAccount, UniformTransfersToMinorsAct, UniformGiftsToMinorsAct, ReserveFunds, SelfDirectedBrokerage.

ownershipType
required
string (AccountOwnershipType) [ 1 .. 35 ] characters
Example: "SingleOwnerAccount"

Specifies the type of account ownership. Possible ISO 20022 compliant values names are: JointAccountWithSurvivorshipRights, JointAccountInCommon, CustodialAccount, SingleOwnerAccount, JointAccount, Corporation, Business, FormalPartnership, FormalTrust, Nominee, NonProfitOrganization, NotForProfitOrganization, ForProfit, EUResidualEntity, GovernmentOrganization, LimitedLiabilityCompany, RegisteredInvestmentCompany, Entrepreneurial, Unincorporated, LimitedPartnership, LimitedLiabilityPartnership, BareOwner, Usufructuary, Fiduciary, ServicerEmployeeAccount, BusinessTrust, FamilyTrust, Estate.

productId
string (ProductId) [ 1 .. 36 ] characters
Example: "PD_CA_0002"
name
string (AccountName) [ 1 .. 70 ] characters
Example: "Hermes PD_CA 0002"

Name of the account. It provides an additional means of identification, and is designated by the account servicer in agreement with the account owner.

accountPurpose
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
currency
string (CurrencyCode) = 3 characters ^([A-Z]{3})?$
Example: "USD"

Three contiguous letters for the representation of currencies and funds. Valid currency codes are registered with the ISO 4217 Maintenance Agency.

initialAmount
string (AmountInCents) <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: -9999999999999.99999999

depositDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

object (AccountContract)

Account contractual details between the owners and the account servicer.

documentId
string (Id) [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"
documentReference
string [ 1 .. 35 ] characters

Document location.

version
string [ 1 .. 18 ] characters

Document version indentification.

signOffDate
string <date>
Example: "2022-04-17"

Signoff date of the document.

issueDate
string <date>
Example: "2022-04-17"

Issue date of the document.

purpose
string [ 1 .. 35 ] characters

Specifies the function of the document.

fromDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period starts.

upToDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period ends.

periodNumber
integer

Sequence number of the period.

object (Jurisdiction)

Area with a set of laws under the control of a system which are different from neighbouring areas

countrySubdivision
string (CountrySubdivision) [ 1 .. 35 ] characters
Example: "Oregon"

Name of a country subdivision such as state, region, county.

townName
string (TownName) [ 1 .. 35 ] characters
Example: "Tualatin"

Name of a built-up area, with defined boundaries, and a local government.

country
string (CountryCode) ^([A-Z]{2,2})?$
Example: "US"

Country name obtained from the United Nations (ISO 3166, Alpha-2 code).

targetClosingDate
string <date>
Example: "2022-04-17"

Date on which the account and related services are expected to cease for the account owner.

targetGoLiveDate
string <date>
Example: "2022-04-17"

Date on which the account and related services are expected to be operational for the account owner.

object

Agreement that governs a contract agreed between parties.

documentId
string (Id) [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"
documentReference
string [ 1 .. 35 ] characters

Document location.

version
string [ 1 .. 18 ] characters

Document version indentification.

signOffDate
string <date>
Example: "2022-04-17"

Signoff date of the document.

issueDate
string <date>
Example: "2022-04-17"

Issue date of the document.

purpose
string [ 1 .. 35 ] characters

Specifies the function of the document.

required
Array of objects (AccountParty)
Array
partyId
required
string (Id) [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"
partyType
required
string (PartyType)
Example: "Person"

Possible values are: Person, Organization. Also other types of servicer internal entities: ServicerOfficer

partyAccountRole
required
string (AccountPartyRole) [ 1 .. 35 ] characters
Example: "AccountOwner"

Type of the account party role. Some possibles values are: Comaker, Cosigner, AccountOwner, AccountSigner, LiquidityManager, Endorser, LimitManager, PaymentManager, Reader, BackupManager, SettlementManager, FundManagementCompany, TransferAgent, FundAccountant, Registrar, InvestmentManager, Custodian, Auditor, PayingAgent, CashCorrespondent, DataProvider, FinalAgent, Investor, FirstAgent, Intermediary, Distributor, Concentrator, UnderlyingClient1, UnderlyingClient2, TransmittingAgent, FundBroker, FinancialAdvisor, ContactPersonAtInstructingPartyInstitution, ContactPersonAtExecutingPartyInstitution, NameOfAgentToOrder, PrimeBroker, Internal, LegalGuardian, DecisionMaker, Guarantor, LoanLender, LoanBorrower, LoanCoBorrower, PrimaryOwner, Trustee, CustodianForMinor, Nominee, SecondaryOwner, Executor, Beneficiary, PrimaryServicerOfficer, SecondaryServicerOfficer, AccountOpenningOfficer, CustomerServiceOfficer.

partyName
string (PartyName) [ 1 .. 350 ] characters
Example: "Jane Birkin"

Name by which a party is known and which is usually used to identify that party.

maturityDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

Array of objects (RelatedAccount)
Array
accountRelationType
required
string (AccountRelationType)
Example: "Child"

Account relation role. Possible values are: Parent, Child, Group.

accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: "0dd926fe-1ca2-11ed-861d-0242ac120002"

Identification assigned by the account service institution (Servicer).

accountNumber
string (AccountNumber) <= 30 characters
Example: "012345678"

The account number or Basic Bank Account Number (BBAN). A Basic Bank Account Number (BBAN) is a bank account number that includes the domestic bank code, branch identifier, and account number. It is a unique identifier for a bank account within a specific country.

accountType
required
string (RelatedAccountType) [ 1 .. 35 ] characters
Example: "Checking"

Type of the account. Some possible ISO 20022 compliant values are: Checking, CardAccount, CashPayment, Charges, CashIncome, Commission, ClearingParticipantSettlementAccount, LimitedLiquiditySavingsAccount, MarginalLending, MoneyMarket, NonResidentExternal, Overdraft, OverNightDeposit, Settlement, Salary, Savings, Tax, TransactingAccount, CashTrading, VirtualAccount, CreditCard, DebitCard, Universal, Investment, EpurseCard, CertificateOfDeposit, MoneyMarketChecking, RetirementAccount, StockOrBond, PrePaid, FleetCard, Cash, DebitAccount, CreditAccount, Benefit, HealthSavingsAccount, FlexibleSpendingAccount, ForBenefitOf, Estate, ClientTrustAccount, LawyersTrustAccount, KeoghPlanAccount, UniformTransfersToMinorsAct, UniformGiftsToMinorsAct, ReserveFunds, SelfDirectedBrokerage, Loan, Ledger.

name
string (AccountName) [ 1 .. 70 ] characters
Example: "Hermes PD_CA 0002"

Name of the account. It provides an additional means of identification, and is designated by the account servicer in agreement with the account owner.

referenceAccount
string [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"

Account used as a reference for the account opening. Could be used to provide initial funds.

Array of objects (Restriction)
Array
name
required
string [ 1 .. 60 ] characters
Example: "WireTransferIn"

Name of the restriction in PascalCase. Possible values: WireTransferIn, WireTransferOut, ForeignIncomingWires, ForeignOutgoingWires, ACHTransfers, InternetBankingTransfer, InternetView, InternetInquiry, ForeignOutgoingIran, Withdrawals, Renew, Transfers

restrictionPurpose
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
enableIndicator
boolean
Example: true

Indicates whether the capability is allowed or not.

validFrom
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

validUntil
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

Array of objects (Limit)
Array
name
required
string [ 1 .. 60 ] characters
Example: "creditLimit"

Name of the limit in PascalCase. Possible values: Overdraft, CreditLimit, CreditCard, Withdraw, CreditCardWithdraw, ForeignFeesWaived, CreditTransactions, DebitTransactions

limitTypeCode
string (LimitType) <= 35 characters
Example: "DirectDebit"

Specifies the type of risk management limit. Possible ISO 20020 compliant values are: Bilateral, NetBilateral, IndirectBilateral, Global, MandatoryBilateral, DiscretionaryBilateral, DirectDebit, SingleCustomerDirectDebit, SingleFinancialInstitutionDirectDebit, TotalDailyCustomerDirectDebit, TotalDailyFinancialInstitutionDirectDebit, AutoCollateralisation, UnsecuredCredit, ExternalGuarantee

channelType
string [ 1 .. 30 ] characters

Channel type for which this limit applies. Possible values: OnlineATM, OfflineATM, ATM, SaleTerminal

amount
string <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Amount limit

number
integer

Number limit.

percentage
string (Percentage) <= 23 characters ^100|(([1-9][0-9]{0,1})([.][0-9]{0,8}){0,1})$...
Example: "25"

Value expressed as a percentage, rate expressed as a percentage, that is, in hundredths, for example, 0.7 is 7/10 of a percent, and 7.0 is 7%. total number of digits: 11 number of digits in fractional part: 10 Max Value: 100

object (Period)
object (Frequency)

Specifies an event frequency

usedAmount
string <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Amount limit used

usedNumber
integer

Number limit used.

usedPercentage
string (Percentage) <= 23 characters ^100|(([1-9][0-9]{0,1})([.][0-9]{0,8}){0,1})$...
Example: "25"

Value expressed as a percentage, rate expressed as a percentage, that is, in hundredths, for example, 0.7 is 7/10 of a percent, and 7.0 is 7%. total number of digits: 11 number of digits in fractional part: 10 Max Value: 100

status
string (LimitStatus) <= 35 characters
Example: "Requested"

Specifies the current status of a limit. Possible ISO 20020 compliant values are: Enabled, Disabled, Deleted, Requested

object (Frequency)

Specifies an event frequency

object (FinancialStatement)

Specifies financial statement details.

object (Frequency)

Specifies an event frequency

cycleType
string [ 1 .. 35 ] characters

Specifies a cycle type. Possible values: Temporal, AtMaturity, InterestCycle, FromLastStatement, LastDay.

cycle
string [ 1 .. 35 ] characters
Example: "Monthly"

Specifies a temporal cycle. Possible values: Annual, Monthly, Quarterly, SemiAnnual, Weekly, Daily, Once, IntraDay, Overnight, TenDays, Fortnightly, TriggeredByMovement, Never, Rate, OnCreditEvent, Upfront, OnExpiry, Hourly, TriAnnual, Bimonthly, OnDemand, Shift, TwiceAWeek, XDays, XMonths, XYears.

every
integer <= 999
Example: 15

Custom cycle definition. Number of XDays, XMonths, XYears.

weekDay
string <= 3
Example: "Tuesday"

Day of the week. Possible Values: Monday, Tuesday, Wednesday, Thursday, Friday.

weekNumbers
Array of strings[ items <= 3 ]
Example: ["1st"]
days
Array of integers[ items <= 31 ]
Example: [30]
startDay
string (MonthDay) ([0-9]{2})-([0-9]{2})
Example: "04-17"

A particular point in the year expressed in the MM-DD format.

communicationMethod
string (CommunicationChannelName) [ 1 .. 35 ] characters
Example: "Email"

Channel used to communicate with a party. Possible Values: Email, Fax, File, Online, PostalService, LiveSupport, ATM, IVR, Kiosk, Mobile, OnlineBanking, Phone, SMS, Card, InPerson.

format
string (DocumentFormat) [ 1 .. 35 ] characters
Example: "PDF"

Specifies a choice of format for a document. Possible Values: PDF, HTML

templateCode
string (StatementTemplateId) [ 1 .. 36 ] characters
Example: "1"

Template used to create the statement document. This is an external code provided by the account servicer.

object (Period)
fromDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period starts.

upToDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period ends.

periodNumber
integer

Sequence number of the period.

lastStatementDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

lastRegularStatementDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

accountNameIndicator
boolean

Indicates whether the account name is printed on the statement.

Array of objects (Balance)

Statement total amounts

Array
balanceName
required
string (BalanceName) [ 1 .. 17 ] characters
Example: "Available"

Specifies the nature of the balance. Possible values: Current, Available, Pending, Blocked, Previous, PendingLedger, LastAnniversary, CurrentAccrued, PreviousAccrued, CurrentWithLastCalculus, CarriedAdjustment, PaidWithPenalties, Accrued, Penalty, CollectionLedger, LastLedger, CurrentLedger, Withheld.

amount
required
string (AmountInCents) <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: -9999999999999.99999999

currency
string (CurrencyCode) = 3 characters ^([A-Z]{3})?$
Example: "USD"

Three contiguous letters for the representation of currencies and funds. Valid currency codes are registered with the ISO 4217 Maintenance Agency.

calculationDate
string <date-time>
Example: "2022-04-17T08:00:00Z"

Specifies the date and time at which the balance is calculated.

preferredLanguage
string (PreferredLanguage) [ 1 .. 35 ] characters
Example: "English"

Language of the contact person. Names according to the language list provided in the ISO 639-1 codes. Some possible values: Chinese, Spanish, French, English, Japanese, Italian, German.

combineType
string [ 1 .. 36 ] characters
Example: "SavingsSatement"

Indicates whether account transactions are printed on a combined statement. Possible combinations: CheckingStatement, SavingsSatement.

category
string (StatementCategory) [ 1 .. 36 ] characters
Example: "BalanceSheet"

Used to categorize the statement. Possible Values: BalanceSheet, ProfitAndLoss

subcategory
string (StatementSubcategory) [ 1 .. 36 ] characters
Example: "Cash"

Used to subcategorize the statement. Possible Values: Cash, AccountReceivable, Inventory, CurrentAssets

profitabilityModelId
string (StatementModelId) [ 1 .. 36 ] characters
Example: "1"

Model used to calculate customer profitability. This is an external id provided by the account servicer.

lastIRAStatementDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

Array of objects (InterestCalculation)
Array
name
string (InterestName) [ 1 .. 35 ] characters
Example: "Deposit"

Name of the interest that applies to the account. For instance, Deposit.

code
string <= 50 characters

Interest code used by the account servicer.

dayCountBasis
string (InterestComputationMethod) [ 1 .. 50 ] characters
Example: "30360AmericanBasicRule"

Specifies the method used to compute accruing interest of a financial instrument. Possible Values: 30360AmericanBasicRule, IC30365, IC30Actual, Actual360, Actual365Fixed, ActualActualICMA, IC30E360orEuroBondBasismodel1, ActualActualISDA, Actual365LorActuActubasisRule, ActualActualAFB, IC30360ICMAor30360basicrule, IC30E2360orEurobondbasismodel2, IC30E3360orEurobondbasismodel3, Actual365NL, Narrative, ActualActualUltimo, IC30EPlus360, Actual364, Business252, Actual360NL, OneOne. DateDeposit365365, DateDeposit365360, LastInterest365365, LastInterest365360, EqualPayments365365, EqualPayments365360

accruedDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

nextInterestDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

rate
string <= 23 characters ^100|(([1-9][0-9]{0,1})([.][0-9]{0,8}){0,1})$...
Example: "25"

The actual interest rate.

object

The period funds are earning interest.

rateType
string (InterestRateType) [ 1 .. 35 ] characters
Example: "Fixed"

Specifies the type of interest rate. Some ISO 20022 compliant values are: Fixed, Forfeit, Variable, StepUp, Scheduled, Unscheduled, Discount, FixedRateUnderlyingExposureForLife, FixedRateUnderlyingExposureWithCompulsoryFutureSwitchToFloating, FixedWithFuturePeriodicResets, FloatingLinkedToIndex, FloatingRateUnderlyingExposureForLife, FloatingRateUnderlyingExposureWithCap, FloatingRateUnderlyingExposureWithFloor, FloatingRateUnderlyingExposureWithFloorAndCap, Modular, ObligorSwapped, SwicthOptionality

compoundingMethod
string (InterestCompoundingMethod) [ 1 .. 35 ] characters
Example: "Deposit"

Inteterst compounding method: Possible Values: Simple, Daily, Continuous.

object (Frequency)

Specifies an event frequency

object (VariableInterestCalculation)

Specifies the parameters to be used for variable interest.

dateNextInterest
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

oneDayInterest
string (PositiveAmountInCents) <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: 0

object (InterestPayment)

Set of attributes related to the interest payment.

Array of objects (Balance)

Total amounts related to an interest

object (InterestDetails)

Set of attributes related to the interest calculus.

object (InterestRenewalDetails)

Detailed interest attributes related to rate change and account maturity.

object (InterestDetails)

Set of attributes related to the interest calculus.

object (InterestCycle)

Set of parameters used to calculate an interest cycle.

lastCalculus
string (PositiveAmountInCents) <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: 0

Array of objects (ChargeCalculation)
Array
fromDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period starts.

upToDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period ends.

periodNumber
integer

Sequence number of the period.

name
string (ChargeName) [ 1 .. 60 ] characters
Example: "CardLatePayment"

Name of the charge calculation in PascalCase. Possible values: Overdraft, CardLatePayment, CashAdvance, LatePayment, CashWithdrawal, EarlyWithdrawal

amount
string <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Amount charged for the service.

rate
string <= 23 characters ^100|(([1-9][0-9]{0,1})([.][0-9]{0,8}){0,1})$...
Example: "25"

Rate applied on a basis amount to calculate the service charge.

chargeType
string (ChargeType) [ 1 .. 35 ] characters
Example: "ManagementFee"

Type of service for which a charge is asked or paid. Some possible ISO 20022 compliant values are: BrokerageFee, Commission, BackEndLoad, FrontEndLoad, Switch, DilutionLevy, Discount, ManagementFee, TransferFee, MatchingFees, PostageCharge, RegulatoryFee, ShippingCharge, ServiceProvisionFee, SpecialConcessions, PartAcquis, Penalty, ContingencyDeferredSalesCharge, Equalisation, CorrespondentBankCharge, Premium, Initial, AdvisoryFee, CustodyFee, PublicationFee, AccountingFee, SignatureService, StorageAtDestination, StorageAtOrigin, Packaging, PickUp, DangerousGoodsFee, SecurityCharge, InsurancePremium, CollectFreight, ClearanceAndHandlingAtOrigin, ClearanceAndHandlingAtDestination, AirWayBillFee, TransportCharges, UCITSCommission, SpeciallyAgreedFrontEndLoad, ADRFee, IssuanceCancellationFee, MiscellaneousFee, IssuanceFee.

calculationMethodCode
string [ 1 .. 60 ] characters

Servicer charge calculation code

calculationBasis
string (CalculationBasis) [ 1 .. 35 ] characters
Example: "Monthly"

Specifies the calculation basis of a charge or fee. Some possible ISO 20022 compliant values are: Average, Daily, Monthly, Annual, FullTerm, RemainingTerm

bearerType
string (ChargeBearerType) [ 1 .. 35 ] characters
Example: "Shared"

Specifies which party(ies) will pay charges due for processing of the instruction. BorneByDebtor, BorneByCreditor, Shared, FollowingServiceLevel

maximumAmount
string <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Maximum amount of money asked or paid for the charge.

object (InterestCalculation)

Set of parameters used to calculate an interest.

debitIndicator
boolean

Indicates whether the charge is automatically debited from the defined account.

accountToCharge
string (AccountId) [ 1 .. 36 ] characters
Example: "0dd926fe-1ca2-11ed-861d-0242ac120002"

Identification assigned by the account service institution (Servicer).

object (Frequency)

Specifies an event frequency

Array of objects (TotalAmount)

Total amounts related to a charge

Array of objects (Tax)
Array
taxType
string (TaxType) [ 1 .. 35 ] characters
Example: "TaxCredit"

Specifies the type of tax. Possible ISO values are: ValueAddedTaxOfZeroRate, Provincial, NationalTax, StateTax, WithholdingTax, CapitalGainTax, InterimProfitTax, StampDuty, WealthTax, InheritanceTax, SolidaritySurcharge, TaxCredit, Equalisation, GiftTax, ConsumptionTax, AlternativeMinimumTax, LocalTax, NationalFederalTax, PaymentLevyTax, StockExchangeTax, TransactionTax, TransferTax, ValueAddedTax, LocalBrokerCommission, ExecutingBrokerCommission, EUTaxRetention, Aktiengewinn1, Aktiengewinn2, Zwischengewinn, CustomsTax, Mietgewinn, GermanLocalTax3, GermanLocalTax4, GermanLocalTax2, WithholdingOfForeignTax, WithholdingOfLocalTax, CapitalLossCredit, FederalWithholding,

rate
string <= 23 characters ^100|(([1-9][0-9]{0,1})([.][0-9]{0,8}){0,1})$...
Example: "25"

Rate applied on a basis amount to calculate the withholding.

debitIndicator
boolean

Indicates whether the tax is automatically debited from the defined account.

Array of objects (Balance)

Total amounts related to the tax type

Array of objects (CommunicationChannel)
Array
channel
string (CommunicationChannelName) [ 1 .. 35 ] characters
Example: "Email"

Channel used to communicate with a party. Possible Values: Email, Fax, File, Online, PostalService, LiveSupport, ATM, IVR, Kiosk, Mobile, OnlineBanking, Phone, SMS, Card, InPerson.

channelIdentification
string (CommunicationChannelIdentification) [ 1 .. 128 ] characters
Example: "011-02010020202"

Communication value such as phone number or email address.

channelPurpose
string (CommunicationChannelPurpose) [ 1 .. 40 ] characters
Example: "Alert"

Communication purpose of the channel. Possible values: Alerts, PrivacyNotices

codeWord
string

A party is asked for a codeword to verify their identity trought a communication channel

alertIndicator
any

Indicates whether the channel is used for enterprise alerts

object (CommunicationChannelHistory)
primaryIndicator
boolean (PrimaryContactIndicator)

Indicates whether the contact informacion is primary.

relationshipId
string [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"

This id gives the ability to view a party’s total relationship with the bank. The relationship Id ties multiple parties and accounts together. This code is also used to reduce mailing costs during marketing campaigns to avoid sending duplicate materials to parties residing at the same address.

Array of objects (GenericAccountCode)

Generic codes to aggregate accounts for similar accounting, processing and integration into the general ledger.

Array
name
string <= 50 characters
Example: "AccountingGroup"

Name of the code. Possible values are: AccountingGroup, CostCenter, DistributionGroup.

code
required
string [ 1 .. 35 ] characters
Example: "195"

Code value to identify the type of account.

object (AccountPrintOptions)
accountTitle
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
balanceOnReceiptOverride
string (BalanceOnReceiptOptions) [ 1 .. 35 ] characters

Indicates whether the account balance is printed on teller terminal and ATM receipts. Possible Values: PrintWhenPositive, PrintWhenNegative, AllwaysPrint, NotPrint

nameIndicator
boolean

Indicates whether the account name is printed on account statements.

handlingLevels
Array of strings (PrintHandlingLevel) [ items [ 1 .. 35 ] characters ]
Array of objects (ServicerAlert)

Account alerts to be received by the account servicer.

Array
alertName
string (AlertName) [ 1 .. 35 ] characters
Example: "CreditBureauAlert"

An alert notification received by the bank. Possible values: CreditBureauAlert, CustomerAlert, PaymentCard

alertType
string (AlertType) [ 1 .. 35 ] characters
Example: "Warning"

An alert notification type. Possible values: Warning, Urgent.

alertCode
string [ 1 .. 36 ] characters
message
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
lastAlertDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

object (AccountHistory)

History attribute values.

originalOpenDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

originalMaturityDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

lastMaturedDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

supplementaryData
object (SupplementaryData)

Additional information that cannot be captured in the structured elements and/or any other specific block. If this information need to be converted in ISO Messages, must be ISO 20022 compliant: it requires development of a compliant message extension model and its components must be registered in the ISO 20022 Data Dictionary. https://www.iso20022.org/catalogue-messages/additional-content-messages/supplementary-data

Responses

Request samples

Content type
application/json
{
  • "compositeId": {
    },
  • "accountBranchId": "SEA_1",
  • "accountNumber": "012345678",
  • "routingNumbers": [
    ],
  • "identifiers": [
    ],
  • "accountType": "Checking",
  • "ownershipType": "SingleOwnerAccount",
  • "productId": "PD_CA_0002",
  • "name": "Hermes PD_CA 0002",
  • "accountPurpose": "This is a description.",
  • "currency": "USD",
  • "initialAmount": "100",
  • "depositDate": "2022-04-17",
  • "contract": {
    },
  • "parties": [
    ],
  • "maturityDate": "2022-04-17",
  • "relatedAccounts": [
    ],
  • "referenceAccount": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "restrictions": [
    ],
  • "limits": [
    ],
  • "statement": {
    },
  • "interests": [
    ],
  • "charges": [
    ],
  • "taxes": [
    ],
  • "communicationChannels": [
    ],
  • "relationshipId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "codes": [
    ],
  • "print": {
    },
  • "servicerAlerts": [
    ],
  • "history": {
    },
  • "supplementaryData": { }
}

Response samples

Content type
{
  • "compositeId": {
    },
  • "accountBranchId": "SEA_1",
  • "accountNumber": "012345678",
  • "routingNumbers": [
    ],
  • "identifiers": [
    ],
  • "accountType": "Checking",
  • "ownershipType": "SingleOwnerAccount",
  • "productId": "PD_CA_0002",
  • "name": "Hermes PD_CA 0002",
  • "accountPurpose": "This is a description.",
  • "currency": "USD",
  • "initialAmount": "100",
  • "depositDate": "2022-04-17",
  • "contract": {
    },
  • "parties": [
    ],
  • "maturityDate": "2022-04-17",
  • "relatedAccounts": [
    ],
  • "referenceAccount": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "restrictions": [
    ],
  • "limits": [
    ],
  • "statement": {
    },
  • "interests": [
    ],
  • "charges": [
    ],
  • "taxes": [
    ],
  • "communicationChannels": [
    ],
  • "relationshipId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "codes": [
    ],
  • "print": {
    },
  • "servicerAlerts": [
    ],
  • "history": {
    },
  • "supplementaryData": { },
  • "balances": [
    ],
  • "transactionGroups": [
    ],
  • "accountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "cards": [
    ],
  • "standingOrders": [
    ],
  • "audit": {
    },
  • "status": {
    }
}

Retrieves an Account

Authorizations:
jwtopenIdConnect
path Parameters
accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: 0dd926fe-1ca2-11ed-861d-0242ac120002

Account Identification

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Responses

Response samples

Content type
application/json
{
  • "compositeId": {
    },
  • "accountBranchId": "SEA_1",
  • "accountNumber": "012345678",
  • "routingNumbers": [
    ],
  • "identifiers": [
    ],
  • "accountType": "Checking",
  • "ownershipType": "SingleOwnerAccount",
  • "productId": "PD_CA_0002",
  • "name": "Hermes PD_CA 0002",
  • "accountPurpose": "This is a description.",
  • "currency": "USD",
  • "initialAmount": "100",
  • "depositDate": "2022-04-17",
  • "contract": {
    },
  • "parties": [
    ],
  • "maturityDate": "2022-04-17",
  • "relatedAccounts": [
    ],
  • "referenceAccount": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "restrictions": [
    ],
  • "limits": [
    ],
  • "statement": {
    },
  • "interests": [
    ],
  • "charges": [
    ],
  • "taxes": [
    ],
  • "communicationChannels": [
    ],
  • "relationshipId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "codes": [
    ],
  • "print": {
    },
  • "servicerAlerts": [
    ],
  • "history": {
    },
  • "supplementaryData": { },
  • "balances": [
    ],
  • "transactionGroups": [
    ],
  • "accountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "cards": [
    ],
  • "standingOrders": [
    ],
  • "audit": {
    },
  • "status": {
    }
}

Replaces an Account by Id.

Use the JSON Merge Patch standard https://tools.ietf.org/html/rfc7396

Authorizations:
jwtopenIdConnect
path Parameters
accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: 0dd926fe-1ca2-11ed-861d-0242ac120002

Account Identification

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Core-Validation-Mode
required
string

<ENFORCING|PERMISSIVE|DISABLED> Indicates how the API validates requests against the core validation request policy. ENFORCING: The API validates all requests against the core validation request policy. The API only sends requests that pass validation to the back-end core service. PERMISSIVE: The API validates all requests against the validation request policy. The API sends all requests to the back-end service, regardless of whether they pass or fail the core validation. DISABLED: The API does not validate any requests against the validation request policy. The API gateway sends all requests to the core back-end service.

Request Body schema: application/json
object

The composite account identifier provides unique account identification when overlaying its parts. [branch-type-subtype-number]

branch
string [ 1 .. 10 ] characters
Example: "1"

Account branch

type
string [ 1 .. 10 ] characters
Example: "DD"

Account type.

subtype
string [ 1 .. 10 ] characters
Example: "HA"

Account subtype

number
required
string [ 1 .. 20 ] characters
Example: "12345"

Account number

accountBranchId
string [ 1 .. 36 ] characters
Example: "SEA_1"

Identification of the account servicer institution at branch level or operation level.

accountNumber
string <= 30 characters
Example: "012345678"

The account number or Basic Bank Account Number (BBAN). A Basic Bank Account Number (BBAN) is a bank account number that includes the domestic bank code, branch identifier, and account number. It is a unique identifier for a bank account within a specific country.

Array of objects
Array
number
string = 9 characters
Example: "012345678"

The routing number (sometimes referred to as an ABA routing number, regarding the American Bankers Association) is a sequence of nine digits used by banks to identify specific financial institutions within the United States.

routingNumberType
string = 9 characters
Example: "ACH"

Different types of payments may require different bank routing numbers. Some possible values: ACH, WIRE, ElectronicCheck, PaperCheck

Array of objects
Array
identification
string [ 1 .. 34 ] characters

Identification assigned by an institution.

schemeName
string [ 1 .. 35 ] characters
Example: "BBANIdentifier"

Name of the identification scheme, in PascalCase. Possible ISO 20022 compliant values names are: IssuerIdentificationNumber, BBANIdentifier, CHIPSUniversalIdentifier, UPICIdentifier, IBANIdentifier

issuer
string [ 1 .. 35 ] characters

Entity that assigns the identification.

accountType
required
string (AccountType) [ 1 .. 35 ] characters
Example: "Checking"

Type of the account. Some possible ISO 20022 compliant values are: Checking, CardAccount, CashPayment, Charges, CashIncome, Commission, ClearingParticipantSettlementAccount, LimitedLiquiditySavingsAccount, MarginalLending, MoneyMarket, NonResidentExternal, Overdraft, OverNightDeposit, Settlement, Salary, Savings, Tax, TransactingAccount, CashTrading, VirtualAccount, CreditCard, DebitCard, Universal, Investment, EpurseCard, CertificateOfDeposit, MoneyMarketChecking, RetirementAccount, StockOrBond, PrePaid, FleetCard, Cash, DebitAccount, CreditAccount, Benefit, HealthSavingsAccount, FlexibleSpendingAccount, ForBenefitOf, Estate, ClientTrustAccount, LawyersTrustAccount, KeoghPlanAccount, UniformTransfersToMinorsAct, UniformGiftsToMinorsAct, ReserveFunds, SelfDirectedBrokerage.

ownershipType
required
string (AccountOwnershipType) [ 1 .. 35 ] characters
Example: "SingleOwnerAccount"

Specifies the type of account ownership. Possible ISO 20022 compliant values names are: JointAccountWithSurvivorshipRights, JointAccountInCommon, CustodialAccount, SingleOwnerAccount, JointAccount, Corporation, Business, FormalPartnership, FormalTrust, Nominee, NonProfitOrganization, NotForProfitOrganization, ForProfit, EUResidualEntity, GovernmentOrganization, LimitedLiabilityCompany, RegisteredInvestmentCompany, Entrepreneurial, Unincorporated, LimitedPartnership, LimitedLiabilityPartnership, BareOwner, Usufructuary, Fiduciary, ServicerEmployeeAccount, BusinessTrust, FamilyTrust, Estate.

productId
string (ProductId) [ 1 .. 36 ] characters
Example: "PD_CA_0002"
name
string (AccountName) [ 1 .. 70 ] characters
Example: "Hermes PD_CA 0002"

Name of the account. It provides an additional means of identification, and is designated by the account servicer in agreement with the account owner.

accountPurpose
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
currency
string (CurrencyCode) = 3 characters ^([A-Z]{3})?$
Example: "USD"

Three contiguous letters for the representation of currencies and funds. Valid currency codes are registered with the ISO 4217 Maintenance Agency.

initialAmount
string (AmountInCents) <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: -9999999999999.99999999

depositDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

object (AccountContract)

Account contractual details between the owners and the account servicer.

documentId
string (Id) [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"
documentReference
string [ 1 .. 35 ] characters

Document location.

version
string [ 1 .. 18 ] characters

Document version indentification.

signOffDate
string <date>
Example: "2022-04-17"

Signoff date of the document.

issueDate
string <date>
Example: "2022-04-17"

Issue date of the document.

purpose
string [ 1 .. 35 ] characters

Specifies the function of the document.

fromDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period starts.

upToDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period ends.

periodNumber
integer

Sequence number of the period.

object (Jurisdiction)

Area with a set of laws under the control of a system which are different from neighbouring areas

countrySubdivision
string (CountrySubdivision) [ 1 .. 35 ] characters
Example: "Oregon"

Name of a country subdivision such as state, region, county.

townName
string (TownName) [ 1 .. 35 ] characters
Example: "Tualatin"

Name of a built-up area, with defined boundaries, and a local government.

country
string (CountryCode) ^([A-Z]{2,2})?$
Example: "US"

Country name obtained from the United Nations (ISO 3166, Alpha-2 code).

targetClosingDate
string <date>
Example: "2022-04-17"

Date on which the account and related services are expected to cease for the account owner.

targetGoLiveDate
string <date>
Example: "2022-04-17"

Date on which the account and related services are expected to be operational for the account owner.

object

Agreement that governs a contract agreed between parties.

documentId
string (Id) [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"
documentReference
string [ 1 .. 35 ] characters

Document location.

version
string [ 1 .. 18 ] characters

Document version indentification.

signOffDate
string <date>
Example: "2022-04-17"

Signoff date of the document.

issueDate
string <date>
Example: "2022-04-17"

Issue date of the document.

purpose
string [ 1 .. 35 ] characters

Specifies the function of the document.

required
Array of objects (AccountParty)
Array
partyId
required
string (Id) [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"
partyType
required
string (PartyType)
Example: "Person"

Possible values are: Person, Organization. Also other types of servicer internal entities: ServicerOfficer

partyAccountRole
required
string (AccountPartyRole) [ 1 .. 35 ] characters
Example: "AccountOwner"

Type of the account party role. Some possibles values are: Comaker, Cosigner, AccountOwner, AccountSigner, LiquidityManager, Endorser, LimitManager, PaymentManager, Reader, BackupManager, SettlementManager, FundManagementCompany, TransferAgent, FundAccountant, Registrar, InvestmentManager, Custodian, Auditor, PayingAgent, CashCorrespondent, DataProvider, FinalAgent, Investor, FirstAgent, Intermediary, Distributor, Concentrator, UnderlyingClient1, UnderlyingClient2, TransmittingAgent, FundBroker, FinancialAdvisor, ContactPersonAtInstructingPartyInstitution, ContactPersonAtExecutingPartyInstitution, NameOfAgentToOrder, PrimeBroker, Internal, LegalGuardian, DecisionMaker, Guarantor, LoanLender, LoanBorrower, LoanCoBorrower, PrimaryOwner, Trustee, CustodianForMinor, Nominee, SecondaryOwner, Executor, Beneficiary, PrimaryServicerOfficer, SecondaryServicerOfficer, AccountOpenningOfficer, CustomerServiceOfficer.

partyName
string (PartyName) [ 1 .. 350 ] characters
Example: "Jane Birkin"

Name by which a party is known and which is usually used to identify that party.

maturityDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

Array of objects (RelatedAccount)
Array
accountRelationType
required
string (AccountRelationType)
Example: "Child"

Account relation role. Possible values are: Parent, Child, Group.

accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: "0dd926fe-1ca2-11ed-861d-0242ac120002"

Identification assigned by the account service institution (Servicer).

accountNumber
string (AccountNumber) <= 30 characters
Example: "012345678"

The account number or Basic Bank Account Number (BBAN). A Basic Bank Account Number (BBAN) is a bank account number that includes the domestic bank code, branch identifier, and account number. It is a unique identifier for a bank account within a specific country.

accountType
required
string (RelatedAccountType) [ 1 .. 35 ] characters
Example: "Checking"

Type of the account. Some possible ISO 20022 compliant values are: Checking, CardAccount, CashPayment, Charges, CashIncome, Commission, ClearingParticipantSettlementAccount, LimitedLiquiditySavingsAccount, MarginalLending, MoneyMarket, NonResidentExternal, Overdraft, OverNightDeposit, Settlement, Salary, Savings, Tax, TransactingAccount, CashTrading, VirtualAccount, CreditCard, DebitCard, Universal, Investment, EpurseCard, CertificateOfDeposit, MoneyMarketChecking, RetirementAccount, StockOrBond, PrePaid, FleetCard, Cash, DebitAccount, CreditAccount, Benefit, HealthSavingsAccount, FlexibleSpendingAccount, ForBenefitOf, Estate, ClientTrustAccount, LawyersTrustAccount, KeoghPlanAccount, UniformTransfersToMinorsAct, UniformGiftsToMinorsAct, ReserveFunds, SelfDirectedBrokerage, Loan, Ledger.

name
string (AccountName) [ 1 .. 70 ] characters
Example: "Hermes PD_CA 0002"

Name of the account. It provides an additional means of identification, and is designated by the account servicer in agreement with the account owner.

referenceAccount
string [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"

Account used as a reference for the account opening. Could be used to provide initial funds.

Array of objects (Restriction)
Array
name
required
string [ 1 .. 60 ] characters
Example: "WireTransferIn"

Name of the restriction in PascalCase. Possible values: WireTransferIn, WireTransferOut, ForeignIncomingWires, ForeignOutgoingWires, ACHTransfers, InternetBankingTransfer, InternetView, InternetInquiry, ForeignOutgoingIran, Withdrawals, Renew, Transfers

restrictionPurpose
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
enableIndicator
boolean
Example: true

Indicates whether the capability is allowed or not.

validFrom
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

validUntil
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

Array of objects (Limit)
Array
name
required
string [ 1 .. 60 ] characters
Example: "creditLimit"

Name of the limit in PascalCase. Possible values: Overdraft, CreditLimit, CreditCard, Withdraw, CreditCardWithdraw, ForeignFeesWaived, CreditTransactions, DebitTransactions

limitTypeCode
string (LimitType) <= 35 characters
Example: "DirectDebit"

Specifies the type of risk management limit. Possible ISO 20020 compliant values are: Bilateral, NetBilateral, IndirectBilateral, Global, MandatoryBilateral, DiscretionaryBilateral, DirectDebit, SingleCustomerDirectDebit, SingleFinancialInstitutionDirectDebit, TotalDailyCustomerDirectDebit, TotalDailyFinancialInstitutionDirectDebit, AutoCollateralisation, UnsecuredCredit, ExternalGuarantee

channelType
string [ 1 .. 30 ] characters

Channel type for which this limit applies. Possible values: OnlineATM, OfflineATM, ATM, SaleTerminal

amount
string <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Amount limit

number
integer

Number limit.

percentage
string (Percentage) <= 23 characters ^100|(([1-9][0-9]{0,1})([.][0-9]{0,8}){0,1})$...
Example: "25"

Value expressed as a percentage, rate expressed as a percentage, that is, in hundredths, for example, 0.7 is 7/10 of a percent, and 7.0 is 7%. total number of digits: 11 number of digits in fractional part: 10 Max Value: 100

object (Period)
object (Frequency)

Specifies an event frequency

usedAmount
string <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Amount limit used

usedNumber
integer

Number limit used.

usedPercentage
string (Percentage) <= 23 characters ^100|(([1-9][0-9]{0,1})([.][0-9]{0,8}){0,1})$...
Example: "25"

Value expressed as a percentage, rate expressed as a percentage, that is, in hundredths, for example, 0.7 is 7/10 of a percent, and 7.0 is 7%. total number of digits: 11 number of digits in fractional part: 10 Max Value: 100

status
string (LimitStatus) <= 35 characters
Example: "Requested"

Specifies the current status of a limit. Possible ISO 20020 compliant values are: Enabled, Disabled, Deleted, Requested

object (Frequency)

Specifies an event frequency

object (FinancialStatement)

Specifies financial statement details.

object (Frequency)

Specifies an event frequency

cycleType
string [ 1 .. 35 ] characters

Specifies a cycle type. Possible values: Temporal, AtMaturity, InterestCycle, FromLastStatement, LastDay.

cycle
string [ 1 .. 35 ] characters
Example: "Monthly"

Specifies a temporal cycle. Possible values: Annual, Monthly, Quarterly, SemiAnnual, Weekly, Daily, Once, IntraDay, Overnight, TenDays, Fortnightly, TriggeredByMovement, Never, Rate, OnCreditEvent, Upfront, OnExpiry, Hourly, TriAnnual, Bimonthly, OnDemand, Shift, TwiceAWeek, XDays, XMonths, XYears.

every
integer <= 999
Example: 15

Custom cycle definition. Number of XDays, XMonths, XYears.

weekDay
string <= 3
Example: "Tuesday"

Day of the week. Possible Values: Monday, Tuesday, Wednesday, Thursday, Friday.

weekNumbers
Array of strings[ items <= 3 ]
Example: ["1st"]
days
Array of integers[ items <= 31 ]
Example: [30]
startDay
string (MonthDay) ([0-9]{2})-([0-9]{2})
Example: "04-17"

A particular point in the year expressed in the MM-DD format.

communicationMethod
string (CommunicationChannelName) [ 1 .. 35 ] characters
Example: "Email"

Channel used to communicate with a party. Possible Values: Email, Fax, File, Online, PostalService, LiveSupport, ATM, IVR, Kiosk, Mobile, OnlineBanking, Phone, SMS, Card, InPerson.

format
string (DocumentFormat) [ 1 .. 35 ] characters
Example: "PDF"

Specifies a choice of format for a document. Possible Values: PDF, HTML

templateCode
string (StatementTemplateId) [ 1 .. 36 ] characters
Example: "1"

Template used to create the statement document. This is an external code provided by the account servicer.

object (Period)
fromDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period starts.

upToDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period ends.

periodNumber
integer

Sequence number of the period.

lastStatementDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

lastRegularStatementDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

accountNameIndicator
boolean

Indicates whether the account name is printed on the statement.

Array of objects (Balance)

Statement total amounts

Array
balanceName
required
string (BalanceName) [ 1 .. 17 ] characters
Example: "Available"

Specifies the nature of the balance. Possible values: Current, Available, Pending, Blocked, Previous, PendingLedger, LastAnniversary, CurrentAccrued, PreviousAccrued, CurrentWithLastCalculus, CarriedAdjustment, PaidWithPenalties, Accrued, Penalty, CollectionLedger, LastLedger, CurrentLedger, Withheld.

amount
required
string (AmountInCents) <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: -9999999999999.99999999

currency
string (CurrencyCode) = 3 characters ^([A-Z]{3})?$
Example: "USD"

Three contiguous letters for the representation of currencies and funds. Valid currency codes are registered with the ISO 4217 Maintenance Agency.

calculationDate
string <date-time>
Example: "2022-04-17T08:00:00Z"

Specifies the date and time at which the balance is calculated.

preferredLanguage
string (PreferredLanguage) [ 1 .. 35 ] characters
Example: "English"

Language of the contact person. Names according to the language list provided in the ISO 639-1 codes. Some possible values: Chinese, Spanish, French, English, Japanese, Italian, German.

combineType
string [ 1 .. 36 ] characters
Example: "SavingsSatement"

Indicates whether account transactions are printed on a combined statement. Possible combinations: CheckingStatement, SavingsSatement.

category
string (StatementCategory) [ 1 .. 36 ] characters
Example: "BalanceSheet"

Used to categorize the statement. Possible Values: BalanceSheet, ProfitAndLoss

subcategory
string (StatementSubcategory) [ 1 .. 36 ] characters
Example: "Cash"

Used to subcategorize the statement. Possible Values: Cash, AccountReceivable, Inventory, CurrentAssets

profitabilityModelId
string (StatementModelId) [ 1 .. 36 ] characters
Example: "1"

Model used to calculate customer profitability. This is an external id provided by the account servicer.

lastIRAStatementDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

Array of objects (InterestCalculation)
Array
name
string (InterestName) [ 1 .. 35 ] characters
Example: "Deposit"

Name of the interest that applies to the account. For instance, Deposit.

code
string <= 50 characters

Interest code used by the account servicer.

dayCountBasis
string (InterestComputationMethod) [ 1 .. 50 ] characters
Example: "30360AmericanBasicRule"

Specifies the method used to compute accruing interest of a financial instrument. Possible Values: 30360AmericanBasicRule, IC30365, IC30Actual, Actual360, Actual365Fixed, ActualActualICMA, IC30E360orEuroBondBasismodel1, ActualActualISDA, Actual365LorActuActubasisRule, ActualActualAFB, IC30360ICMAor30360basicrule, IC30E2360orEurobondbasismodel2, IC30E3360orEurobondbasismodel3, Actual365NL, Narrative, ActualActualUltimo, IC30EPlus360, Actual364, Business252, Actual360NL, OneOne. DateDeposit365365, DateDeposit365360, LastInterest365365, LastInterest365360, EqualPayments365365, EqualPayments365360

accruedDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

nextInterestDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

rate
string <= 23 characters ^100|(([1-9][0-9]{0,1})([.][0-9]{0,8}){0,1})$...
Example: "25"

The actual interest rate.

object

The period funds are earning interest.

rateType
string (InterestRateType) [ 1 .. 35 ] characters
Example: "Fixed"

Specifies the type of interest rate. Some ISO 20022 compliant values are: Fixed, Forfeit, Variable, StepUp, Scheduled, Unscheduled, Discount, FixedRateUnderlyingExposureForLife, FixedRateUnderlyingExposureWithCompulsoryFutureSwitchToFloating, FixedWithFuturePeriodicResets, FloatingLinkedToIndex, FloatingRateUnderlyingExposureForLife, FloatingRateUnderlyingExposureWithCap, FloatingRateUnderlyingExposureWithFloor, FloatingRateUnderlyingExposureWithFloorAndCap, Modular, ObligorSwapped, SwicthOptionality

compoundingMethod
string (InterestCompoundingMethod) [ 1 .. 35 ] characters
Example: "Deposit"

Inteterst compounding method: Possible Values: Simple, Daily, Continuous.

object (Frequency)

Specifies an event frequency

object (VariableInterestCalculation)

Specifies the parameters to be used for variable interest.

dateNextInterest
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

oneDayInterest
string (PositiveAmountInCents) <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: 0

object (InterestPayment)

Set of attributes related to the interest payment.

Array of objects (Balance)

Total amounts related to an interest

object (InterestDetails)

Set of attributes related to the interest calculus.

object (InterestRenewalDetails)

Detailed interest attributes related to rate change and account maturity.

object (InterestDetails)

Set of attributes related to the interest calculus.

object (InterestCycle)

Set of parameters used to calculate an interest cycle.

lastCalculus
string (PositiveAmountInCents) <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: 0

Array of objects (ChargeCalculation)
Array
fromDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period starts.

upToDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period ends.

periodNumber
integer

Sequence number of the period.

name
string (ChargeName) [ 1 .. 60 ] characters
Example: "CardLatePayment"

Name of the charge calculation in PascalCase. Possible values: Overdraft, CardLatePayment, CashAdvance, LatePayment, CashWithdrawal, EarlyWithdrawal

amount
string <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Amount charged for the service.

rate
string <= 23 characters ^100|(([1-9][0-9]{0,1})([.][0-9]{0,8}){0,1})$...
Example: "25"

Rate applied on a basis amount to calculate the service charge.

chargeType
string (ChargeType) [ 1 .. 35 ] characters
Example: "ManagementFee"

Type of service for which a charge is asked or paid. Some possible ISO 20022 compliant values are: BrokerageFee, Commission, BackEndLoad, FrontEndLoad, Switch, DilutionLevy, Discount, ManagementFee, TransferFee, MatchingFees, PostageCharge, RegulatoryFee, ShippingCharge, ServiceProvisionFee, SpecialConcessions, PartAcquis, Penalty, ContingencyDeferredSalesCharge, Equalisation, CorrespondentBankCharge, Premium, Initial, AdvisoryFee, CustodyFee, PublicationFee, AccountingFee, SignatureService, StorageAtDestination, StorageAtOrigin, Packaging, PickUp, DangerousGoodsFee, SecurityCharge, InsurancePremium, CollectFreight, ClearanceAndHandlingAtOrigin, ClearanceAndHandlingAtDestination, AirWayBillFee, TransportCharges, UCITSCommission, SpeciallyAgreedFrontEndLoad, ADRFee, IssuanceCancellationFee, MiscellaneousFee, IssuanceFee.

calculationMethodCode
string [ 1 .. 60 ] characters

Servicer charge calculation code

calculationBasis
string (CalculationBasis) [ 1 .. 35 ] characters
Example: "Monthly"

Specifies the calculation basis of a charge or fee. Some possible ISO 20022 compliant values are: Average, Daily, Monthly, Annual, FullTerm, RemainingTerm

bearerType
string (ChargeBearerType) [ 1 .. 35 ] characters
Example: "Shared"

Specifies which party(ies) will pay charges due for processing of the instruction. BorneByDebtor, BorneByCreditor, Shared, FollowingServiceLevel

maximumAmount
string <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Maximum amount of money asked or paid for the charge.

object (InterestCalculation)

Set of parameters used to calculate an interest.

debitIndicator
boolean

Indicates whether the charge is automatically debited from the defined account.

accountToCharge
string (AccountId) [ 1 .. 36 ] characters
Example: "0dd926fe-1ca2-11ed-861d-0242ac120002"

Identification assigned by the account service institution (Servicer).

object (Frequency)

Specifies an event frequency

Array of objects (TotalAmount)

Total amounts related to a charge

Array of objects (Tax)
Array
taxType
string (TaxType) [ 1 .. 35 ] characters
Example: "TaxCredit"

Specifies the type of tax. Possible ISO values are: ValueAddedTaxOfZeroRate, Provincial, NationalTax, StateTax, WithholdingTax, CapitalGainTax, InterimProfitTax, StampDuty, WealthTax, InheritanceTax, SolidaritySurcharge, TaxCredit, Equalisation, GiftTax, ConsumptionTax, AlternativeMinimumTax, LocalTax, NationalFederalTax, PaymentLevyTax, StockExchangeTax, TransactionTax, TransferTax, ValueAddedTax, LocalBrokerCommission, ExecutingBrokerCommission, EUTaxRetention, Aktiengewinn1, Aktiengewinn2, Zwischengewinn, CustomsTax, Mietgewinn, GermanLocalTax3, GermanLocalTax4, GermanLocalTax2, WithholdingOfForeignTax, WithholdingOfLocalTax, CapitalLossCredit, FederalWithholding,

rate
string <= 23 characters ^100|(([1-9][0-9]{0,1})([.][0-9]{0,8}){0,1})$...
Example: "25"

Rate applied on a basis amount to calculate the withholding.

debitIndicator
boolean

Indicates whether the tax is automatically debited from the defined account.

Array of objects (Balance)

Total amounts related to the tax type

Array of objects (CommunicationChannel)
Array
channel
string (CommunicationChannelName) [ 1 .. 35 ] characters
Example: "Email"

Channel used to communicate with a party. Possible Values: Email, Fax, File, Online, PostalService, LiveSupport, ATM, IVR, Kiosk, Mobile, OnlineBanking, Phone, SMS, Card, InPerson.

channelIdentification
string (CommunicationChannelIdentification) [ 1 .. 128 ] characters
Example: "011-02010020202"

Communication value such as phone number or email address.

channelPurpose
string (CommunicationChannelPurpose) [ 1 .. 40 ] characters
Example: "Alert"

Communication purpose of the channel. Possible values: Alerts, PrivacyNotices

codeWord
string

A party is asked for a codeword to verify their identity trought a communication channel

alertIndicator
any

Indicates whether the channel is used for enterprise alerts

object (CommunicationChannelHistory)
primaryIndicator
boolean (PrimaryContactIndicator)

Indicates whether the contact informacion is primary.

relationshipId
string [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"

This id gives the ability to view a party’s total relationship with the bank. The relationship Id ties multiple parties and accounts together. This code is also used to reduce mailing costs during marketing campaigns to avoid sending duplicate materials to parties residing at the same address.

Array of objects (GenericAccountCode)

Generic codes to aggregate accounts for similar accounting, processing and integration into the general ledger.

Array
name
string <= 50 characters
Example: "AccountingGroup"

Name of the code. Possible values are: AccountingGroup, CostCenter, DistributionGroup.

code
required
string [ 1 .. 35 ] characters
Example: "195"

Code value to identify the type of account.

object (AccountPrintOptions)
accountTitle
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
balanceOnReceiptOverride
string (BalanceOnReceiptOptions) [ 1 .. 35 ] characters

Indicates whether the account balance is printed on teller terminal and ATM receipts. Possible Values: PrintWhenPositive, PrintWhenNegative, AllwaysPrint, NotPrint

nameIndicator
boolean

Indicates whether the account name is printed on account statements.

handlingLevels
Array of strings (PrintHandlingLevel) [ items [ 1 .. 35 ] characters ]
Array of objects (ServicerAlert)

Account alerts to be received by the account servicer.

Array
alertName
string (AlertName) [ 1 .. 35 ] characters
Example: "CreditBureauAlert"

An alert notification received by the bank. Possible values: CreditBureauAlert, CustomerAlert, PaymentCard

alertType
string (AlertType) [ 1 .. 35 ] characters
Example: "Warning"

An alert notification type. Possible values: Warning, Urgent.

alertCode
string [ 1 .. 36 ] characters
message
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
lastAlertDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

object (AccountHistory)

History attribute values.

originalOpenDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

originalMaturityDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

lastMaturedDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

supplementaryData
object (SupplementaryData)

Additional information that cannot be captured in the structured elements and/or any other specific block. If this information need to be converted in ISO Messages, must be ISO 20022 compliant: it requires development of a compliant message extension model and its components must be registered in the ISO 20022 Data Dictionary. https://www.iso20022.org/catalogue-messages/additional-content-messages/supplementary-data

Array of objects (Balance)
Array
balanceName
required
string (BalanceName) [ 1 .. 17 ] characters
Example: "Available"

Specifies the nature of the balance. Possible values: Current, Available, Pending, Blocked, Previous, PendingLedger, LastAnniversary, CurrentAccrued, PreviousAccrued, CurrentWithLastCalculus, CarriedAdjustment, PaidWithPenalties, Accrued, Penalty, CollectionLedger, LastLedger, CurrentLedger, Withheld.

amount
required
string (AmountInCents) <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: -9999999999999.99999999

currency
string (CurrencyCode) = 3 characters ^([A-Z]{3})?$
Example: "USD"

Three contiguous letters for the representation of currencies and funds. Valid currency codes are registered with the ISO 4217 Maintenance Agency.

calculationDate
string <date-time>
Example: "2022-04-17T08:00:00Z"

Specifies the date and time at which the balance is calculated.

Array of objects (TransactionGroup)
Array
domain
string (BankTransactionDomain) [ 1 .. 35 ] characters
Example: "Payments"

Specifies the bank transaction code domain. Some possible ISO 20022 compliant values are: Payments, AccountManagement.

family
string (BankTransactionFamily) [ 1 .. 60 ] characters
Example: "CustomerCardTransactions"

Specifies the bank transaction family. Some possible ISO 20022 compliant values are: For Payments domain: CustomerCardTransactions, MerchantCardTransactions.

subFamily
string (BankTransactionSubfamily) [ 1 .. 60 ] characters
Example: "CreditCardPayment"

Specifies the bank transaction subfamily. Some possible ISO 20022 compliant values are: For CustomerCardTransactions family: CashDeposit, CashWithdrawal, SmartCardPayment, PointOfSalePaymentDebitCard, CreditCardPayment, CrossBorderCreditCardPayment, CrossBorderCashWithdrawal

Array of objects (GenericTransactionCode)

Additional transaction codes.

status
string (TransactionStatus) [ 1 .. 35 ] characters
Example: "Booked"

Specifies the status of an entry on the books of the account servicer. Some possible ISO 20022 compliant values are: Booked, Future, Information, Pending.

number
integer

Number of individual transactions.

amount
string <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Total of the transaction amounts.

object

Temporal duration by which the transactions are grouped

accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: "0dd926fe-1ca2-11ed-861d-0242ac120002"

Identification assigned by the account service institution (Servicer).

Array of objects (RelatedCard)

Payment cards related to the account. Debit cards, for loans or current accounts. Credit cards, for credit card accounts.

Array
cardId
required
string (Id) [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"
cardHolderName
required
string (PartyName) [ 1 .. 350 ] characters
Example: "Jane Birkin"

Name by which a party is known and which is usually used to identify that party.

cardHolderType
required
string (CardHolderType) [ 1 .. 35 ] characters
Example: "Primary"

Specifies the card holder type of payment card. Possible Values: Primary, Additional

Array of objects (StandingOrder)

Instructions given by an account holder to an account servicer to make regular transfers on given dates to the same beneficiary.

Array
object

Dates during which the standing order is in effect.

orderSequence
required
integer
Example: 1

Specifies the sequence in which the system will execute the liquidity transfers standing order within the set.

object

Dates during which the standing order is in effect

eventDescription
string [ 1 .. 1025 ] characters
Example: "This is a description."

Describes the event which triggers the exercise of a standing order for instance the reception of a report or the closing of an account.

day
integer <= 31
Example: 30

Specifies the day for the time event.

object

Specifies the hour of the day for the time event.

required
object (CreditTransferDetail)

Further details on the credit transfer instruction

standingOrderId
string [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"

Unique and unambiguous identification for a standing order, as assigned by the account servicer or the account owner.

status
string (StandingOrderStatus) [ 1 .. 36 ] characters
Example: "Months"

Specifies the status of a standing order request. Possible values: Cancelled, Pending, Sent.

statusDateAndTime
string <date-time> (DateAndTime)
Example: "2022-04-17T08:00:00Z"
cancellationReason
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
object (Audit)

Resource Audit Information. Captures the creation, modification and maintenance details.

status
string (AuditStatus) [ 1 .. 35 ] characters

Maintenance status of a resource. Possible values: Requested, Created, Changed, Deleted

creationDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

lastModificacionChannel
string (CommunicationChannelName) [ 1 .. 35 ] characters
Example: "Email"

Channel used to communicate with a party. Possible Values: Email, Fax, File, Online, PostalService, LiveSupport, ATM, IVR, Kiosk, Mobile, OnlineBanking, Phone, SMS, Card, InPerson.

lastModificationDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

Array of objects (AuditChannel)

Activity audit throught comunication channles

Array
lastActivityDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

name
string (CommunicationChannelName) [ 1 .. 35 ] characters
Example: "Email"

Channel used to communicate with a party. Possible Values: Email, Fax, File, Online, PostalService, LiveSupport, ATM, IVR, Kiosk, Mobile, OnlineBanking, Phone, SMS, Card, InPerson.

activityType
string (AuditActivityType) [ 1 .. 35 ] characters

Maintenance activity of a resource. Possible values: Transaction, Modification, Deposit, Withdrawal.

amount
string (PositiveAmountInCents) <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: 0

required
object (AccountDetailedStatus)

Specifies the current state of an account.

status
string (AccountStatus) [ 1 .. 35 ] characters
Example: "Pending"

Specifies the current state of an account. Possible ISO 20022 compliant values names are: Enable, Dormant, Disable, Deleted, Pending, Form.

statusDateAndTime
string <date-time> (DateAndTime)
Example: "2022-04-17T08:00:00Z"
statusReason
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
processEvents
Array of strings[ items [ 1 .. 35 ] characters ]

Account process event list defined by the account servicer. Possible list values: YearEndProcessed, MonthEndProcessed, ManuallyControlled

openDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

closeDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

collateralIndicator
boolean

Indicates whether an account has been pledged as collateral.

negotiableIndicator
boolean

Indicates whether an account is a negotiable instrument.

profitabilityAnalysisStatus
string [ 1 .. 34 ] characters

Profit analysis status. Possible values: Hight, Low, NotAnalyzed, Analyzed, SystemClosed.

Responses

Request samples

Content type
application/json
{
  • "compositeId": {
    },
  • "accountBranchId": "SEA_1",
  • "accountNumber": "012345678",
  • "routingNumbers": [
    ],
  • "identifiers": [
    ],
  • "accountType": "Checking",
  • "ownershipType": "SingleOwnerAccount",
  • "productId": "PD_CA_0002",
  • "name": "Hermes PD_CA 0002",
  • "accountPurpose": "This is a description.",
  • "currency": "USD",
  • "initialAmount": "100",
  • "depositDate": "2022-04-17",
  • "contract": {
    },
  • "parties": [
    ],
  • "maturityDate": "2022-04-17",
  • "relatedAccounts": [
    ],
  • "referenceAccount": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "restrictions": [
    ],
  • "limits": [
    ],
  • "statement": {
    },
  • "interests": [
    ],
  • "charges": [
    ],
  • "taxes": [
    ],
  • "communicationChannels": [
    ],
  • "relationshipId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "codes": [
    ],
  • "print": {
    },
  • "servicerAlerts": [
    ],
  • "history": {
    },
  • "supplementaryData": { },
  • "balances": [
    ],
  • "transactionGroups": [
    ],
  • "accountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "cards": [
    ],
  • "standingOrders": [
    ],
  • "audit": {
    },
  • "status": {
    }
}

Response samples

Content type
{
  • "compositeId": {
    },
  • "accountBranchId": "SEA_1",
  • "accountNumber": "012345678",
  • "routingNumbers": [
    ],
  • "identifiers": [
    ],
  • "accountType": "Checking",
  • "ownershipType": "SingleOwnerAccount",
  • "productId": "PD_CA_0002",
  • "name": "Hermes PD_CA 0002",
  • "accountPurpose": "This is a description.",
  • "currency": "USD",
  • "initialAmount": "100",
  • "depositDate": "2022-04-17",
  • "contract": {
    },
  • "parties": [
    ],
  • "maturityDate": "2022-04-17",
  • "relatedAccounts": [
    ],
  • "referenceAccount": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "restrictions": [
    ],
  • "limits": [
    ],
  • "statement": {
    },
  • "interests": [
    ],
  • "charges": [
    ],
  • "taxes": [
    ],
  • "communicationChannels": [
    ],
  • "relationshipId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "codes": [
    ],
  • "print": {
    },
  • "servicerAlerts": [
    ],
  • "history": {
    },
  • "supplementaryData": { },
  • "balances": [
    ],
  • "transactionGroups": [
    ],
  • "accountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "cards": [
    ],
  • "standingOrders": [
    ],
  • "audit": {
    },
  • "status": {
    }
}

Updates an Account

Use the JSON Merge Patch standard https://tools.ietf.org/html/rfc7396

Authorizations:
jwtopenIdConnect
path Parameters
accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: 0dd926fe-1ca2-11ed-861d-0242ac120002

Account Identification

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Core-Validation-Mode
required
string

<ENFORCING|PERMISSIVE|DISABLED> Indicates how the API validates requests against the core validation request policy. ENFORCING: The API validates all requests against the core validation request policy. The API only sends requests that pass validation to the back-end core service. PERMISSIVE: The API validates all requests against the validation request policy. The API sends all requests to the back-end service, regardless of whether they pass or fail the core validation. DISABLED: The API does not validate any requests against the validation request policy. The API gateway sends all requests to the core back-end service.

Request Body schema: application/merge-patch+json
object

Responses

Request samples

Content type
application/merge-patch+json
{ }

Response samples

Content type
{
  • "compositeId": {
    },
  • "accountBranchId": "SEA_1",
  • "accountNumber": "012345678",
  • "routingNumbers": [
    ],
  • "identifiers": [
    ],
  • "accountType": "Checking",
  • "ownershipType": "SingleOwnerAccount",
  • "productId": "PD_CA_0002",
  • "name": "Hermes PD_CA 0002",
  • "accountPurpose": "This is a description.",
  • "currency": "USD",
  • "initialAmount": "100",
  • "depositDate": "2022-04-17",
  • "contract": {
    },
  • "parties": [
    ],
  • "maturityDate": "2022-04-17",
  • "relatedAccounts": [
    ],
  • "referenceAccount": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "restrictions": [
    ],
  • "limits": [
    ],
  • "statement": {
    },
  • "interests": [
    ],
  • "charges": [
    ],
  • "taxes": [
    ],
  • "communicationChannels": [
    ],
  • "relationshipId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "codes": [
    ],
  • "print": {
    },
  • "servicerAlerts": [
    ],
  • "history": {
    },
  • "supplementaryData": { },
  • "balances": [
    ],
  • "transactionGroups": [
    ],
  • "accountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "cards": [
    ],
  • "standingOrders": [
    ],
  • "audit": {
    },
  • "status": {
    }
}

Retrieves Account Balances

Authorizations:
jwtopenIdConnect
path Parameters
accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: 0dd926fe-1ca2-11ed-861d-0242ac120002

Account Identification

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Responses

Response samples

Content type
application/json
{
  • "accountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "accountNumber": "012345678",
  • "accountType": "Checking",
  • "ownershipType": "SingleOwnerAccount",
  • "balances": [
    ]
}

Retrieves Account Identifiers

Authorizations:
jwtopenIdConnect
path Parameters
accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: 0dd926fe-1ca2-11ed-861d-0242ac120002

Account Identification

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

Responses

Response samples

Content type
application/json
{
  • "compositeId": {
    },
  • "accountBranchId": "SEA_1",
  • "accountNumber": "012345678",
  • "routingNumbers": [
    ],
  • "identifiers": [
    ],
  • "accountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "accountType": "Checking",
  • "ownershipType": "SingleOwnerAccount"
}

Retrieves Account Parties

Authorizations:
jwtopenIdConnect
path Parameters
accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: 0dd926fe-1ca2-11ed-861d-0242ac120002

Account Identification

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Responses

Response samples

Content type
application/json
{
  • "accountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "accountNumber": "012345678",
  • "accountType": "Checking",
  • "ownershipType": "SingleOwnerAccount",
  • "parties": [
    ]
}

Retrieves Account Owners

Authorizations:
jwtopenIdConnect
path Parameters
accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: 0dd926fe-1ca2-11ed-861d-0242ac120002

Account Identification

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Responses

Response samples

Content type
application/json
{
  • "accountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "accountNumber": "012345678",
  • "accountType": "Checking",
  • "ownershipType": "SingleOwnerAccount",
  • "owners": [
    ]
}

Retrieves Account Cards

Authorizations:
jwtopenIdConnect
path Parameters
accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: 0dd926fe-1ca2-11ed-861d-0242ac120002

Account Identification

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Responses

Response samples

Content type
application/json
{
  • "accountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "accountNumber": "012345678",
  • "accountType": "Checking",
  • "ownershipType": "SingleOwnerAccount",
  • "cards": [
    ]
}

Retrieves Account Standing Orders

Authorizations:
jwtopenIdConnect
path Parameters
accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: 0dd926fe-1ca2-11ed-861d-0242ac120002

Account Identification

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Responses

Response samples

Content type
application/json
{
  • "accountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "accountNumber": "012345678",
  • "accountType": "Checking",
  • "ownershipType": "SingleOwnerAccount",
  • "standingOrders": [
    ]
}

Request Standing Order Cancellation

Authorizations:
jwtopenIdConnect
path Parameters
accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: 0dd926fe-1ca2-11ed-861d-0242ac120002

Account Identification

header Parameters
idempotencyId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Idempotency identifier used by the client when making repeated calls

servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Request Body schema: application/json
object

Dates during which the standing order is in effect.

fromDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period starts.

upToDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period ends.

periodNumber
integer

Sequence number of the period.

orderSequence
required
integer
Example: 1

Specifies the sequence in which the system will execute the liquidity transfers standing order within the set.

object

Dates during which the standing order is in effect

cycleType
string [ 1 .. 35 ] characters

Specifies a cycle type. Possible values: Temporal, AtMaturity, InterestCycle, FromLastStatement, LastDay.

cycle
string [ 1 .. 35 ] characters
Example: "Monthly"

Specifies a temporal cycle. Possible values: Annual, Monthly, Quarterly, SemiAnnual, Weekly, Daily, Once, IntraDay, Overnight, TenDays, Fortnightly, TriggeredByMovement, Never, Rate, OnCreditEvent, Upfront, OnExpiry, Hourly, TriAnnual, Bimonthly, OnDemand, Shift, TwiceAWeek, XDays, XMonths, XYears.

every
integer <= 999
Example: 15

Custom cycle definition. Number of XDays, XMonths, XYears.

weekDay
string <= 3
Example: "Tuesday"

Day of the week. Possible Values: Monday, Tuesday, Wednesday, Thursday, Friday.

weekNumbers
Array of strings[ items <= 3 ]
Example: ["1st"]
days
Array of integers[ items <= 31 ]
Example: [30]
startDay
string (MonthDay) ([0-9]{2})-([0-9]{2})
Example: "04-17"

A particular point in the year expressed in the MM-DD format.

eventDescription
string [ 1 .. 1025 ] characters
Example: "This is a description."

Describes the event which triggers the exercise of a standing order for instance the reception of a report or the closing of an account.

day
integer <= 31
Example: 30

Specifies the day for the time event.

object

Specifies the hour of the day for the time event.

hour
string <time-hour>
Example: "12"
timeZone
string (TimeZone) [ 1 .. 30 ] characters
Example: "Pacific"

A time zone is an area which observes a uniform standard time for legal, commercial and social purposes. Some possible values: Pacific, Mountain, Central, Eastern, GreenwichMean

required
object (CreditTransferDetail)

Further details on the credit transfer instruction

paymentMethod
required
string (PaymentMethod) [ 1 .. 35 ] characters
Example: "CreditTransfer"

Specifies the means of payment that will be used to move the amount of money. Possible ISO 20022 compliant values are: Check, CreditTransfer

paymentType
required
string (PaymentType) [ 1 .. 35 ] characters
Example: "On-Us"

Specifies the type of Payment. Possible values: LiquidityTransfer, On-Us, ACH, Wire

creditorAccountId
string (AccountId) [ 1 .. 36 ] characters
Example: "0dd926fe-1ca2-11ed-861d-0242ac120002"

Identification assigned by the account service institution (Servicer).

object (PaymentIdentifiers)

Set of elements used to reference a payment instruction.

endToEndIdentification
string (EndToEndIdentification) [ 1 .. 35 ] characters
Example: "12345678912345"

Unique identification assigned by the initiating party to unambiguously identify the transaction. This identification is passed on, unchanged, throughout the entire end-to-end chain.

Usage: The end-to-end identification can be used for reconciliation or to link tasks relating to the transaction. It can be included in several messages related to the transaction.

Array of objects (PaymentIdentification)
object (PaymentProcessingDetail)

Provides further details of the type of payment.

instructionPriority
string (InstructionPriority) [ 1 .. 35 ] characters
Example: "123456789"

Indicator of the urgency or order of importance that the instructing party would like the instructed party to apply to the processing of the instruction. Possible ISO Complaiant values are: High, Normal.

serviceLevel
string (ServiceLevel) [ 1 .. 35 ] characters
Example: "BookTransaction"

Specifies a pre-agreed service between the parties. Some ISO complaiant values from ExternalServiceLevel1Code are: BookTransaction, TrackedCustomerCreditTransfer, TrackedStopAndRecall, TrackedOutboundCorporateTransfer, TrackedFinancialInstitutionTransfe, NonurgentPriorityPayment, NonurgentPayment, EBAPriorityService, SameDayValue, DomesticChequeClearingAndSettlement, UrgentPayment, UrgentPaymentNetSettlement, InstantCreditTransferOrInstantDirectDebit, ServiceRequestToPay, ScheckVerarbeitungAustria, TrackedCaseManagement, TrackedInboundCustomerCreditTransfer, TrackedInstantCustomerCreditTransfer, TrackedLowValueCrossBorderCustomerCreditTransfer.

clearingChannel
string (ClearingSystem) [ 1 .. 35 ] characters
Example: "ACH"

Specifies the clearing system identification. Some ISO complaiant values from ExternalCashClearingSystem1Code are: USFedACH, USFedNow, USFedwireFunds, ACH, EBAEuro1Step1, CanadaACSS, Albania, Austrian, NewZealand, Azerbaijan, BosniaHerzegovina, SwedenBGC, Ecuador, Barbados, Belgium, Bulgaria, Bahamas, Botswana, Finland, BankOfJapanNet, Italy, Philippines, CanadaCAD, SpainCAM, CentralBankOfArubaCSM, CentraleBankVanCuraçaoEnSintMaartenCSM, Ireland, Peru, USTCHChips,UnitedKingdom, China, CentralInteroperabilityService, ColumbiaCEDEC, ColumbiaCENIT, ColumbiaCUD, DenmarkDDK,Denmark, EBAEuro1, GermanyELS, Germany, ECB, USTCHEPN, EBAStep1, ForeignExchangeYenClearing, FasterPaymentsServices, Ghana, HongKongCHAT, HongKongFPS, Croatia, Greece, Hungary, SpainIberpayInstantPayments, DEandNLEquens, IndiaImmediatePaymentService, Jordan, Kenya, Luxemburg, SriLanka, Latvia, CanadaLVTS, LynxCanada, Singapore, SouthAfrica, MacaoRTGS, Malta, Mauritius, Namibia, Norway, NorwayNICSReal, AustraliaNPP, USNSS, NewZealandRTGS, Switzerland, AustraliaPDS, Egypt, FrancePNS, AustrianCSM, Angola, Venezuela, RomaniaEPO, RomaniaGSRS, RTGS, GermanyRTGSPlus, RTRCanada, RPSAndSEPAClearer, Chili, SwedenSEC, euroSIC, SIC, SICIP, Slovania, SpainES, Portugal, SwedenSSK, EBAClearingSTEP2, UnitedKingdomGBP, FranceFR, USTCHRealTime, Target, Thailand, Thailand-NITMX, Tanzania, Netherlands, TrinidadAndTobago, CanadaUSBE, Uganda, IndiaUnifiedPaymentsInterface, VocaLink, EBASTEP2XCT, Zengin, Zimbabwe, Zambia, Iceland, NorwayRTGS, NGInterswitch, P27RealTime, P27, UnitedKingdomUKD, SingaporeSCRIPS, RIXRTGSSverigesRiksbank

localInstrument
string (LocalInstrument) [ 1 .. 35 ] characters
Example: "CorporateCreditDebit"

This element is used to specify a local clearing option and/or qualify the service or service level. CreditTransfers, ReturnedCreditTransfers, TruncatedCreditTransfers, TruncatedChecks, RevokedCreditTransfers, RevokedReturnedCreditTransfers, RevokedTruncatedChecks, RevokedTruncatedCreditTransfers, CardClearing, FedNowAccount, CorporateCreditDebit,CorporateTradeExchange, PrearrangedPaymentDeposit.

categoryPurpose
string (CategoryPurpose) [ 1 .. 35 ] characters
Example: "SalaryPayment"

Specifies the high level purpose of the instruction based on a set of pre-defined categories. Usage: This is used by the initiating party to provide information concerning the processing of the payment. It is likely to trigger special processing by any of the agents involved in the payment chain. Some ISO complaiant values are from ExternalCategoryPurpose1Code: BonusPayment, CashManagementTransfer, CardBulkClearing, CreditCardPayment, TradeSettlementPayment, DebitCardPayment, Dividend, DeliverAgainstPayment, Epayment,FeeCollectionAndInterest, FeeCollection,PersontoPersonPayment, GovernmentPayment, Hedging, IrrevocableCreditCardPayment, IrrevocableDebitCardPayment, IntraCompanyPayment, Interest, LockboxTransactions, Loan, Commercial, Consumer, PensionPayment, Represented, ReimbursementReceivedCreditTransfer, ReceiveAgainstPayment, SalaryPayment, Securities, SocialSecurityBenefit, SupplierPayment, TaxPayment, Trade, TreasuryPayment, ValueAddedTaxPayment, WithHolding, CashManagementSweepAccount, CashManagementTopAccount, CashManagementZeroBalanceAccount

chargeBearerType
string (ChargeBearerType) [ 1 .. 35 ] characters
Example: "Shared"

Specifies which party(ies) will pay charges due for processing of the instruction. BorneByDebtor, BorneByCreditor, Shared, FollowingServiceLevel

object (PartyIdentification)
name
required
string (PartyName) [ 1 .. 350 ] characters
Example: "Jane Birkin"

Name by which a party is known and which is usually used to identify that party.

required
object (PaymentAccount)
object (PostalAddress)

Information that locates and identifies a specific address, as defined by postal services.

object (FinancialInstitution)
object (PlaceAndDateOfBirth)

Date and place of birth of a person.

object (PaymentPartyContactDetails)

Specifies the contact details of a person.

Array of objects (PartyGenericIdentification)
countryOfResidence
string (CountryCode) ^([A-Z]{2,2})?$
Example: "US"

Country name obtained from the United Nations (ISO 3166, Alpha-2 code).

Responses

Request samples

Content type
application/json
{
  • "period": {
    },
  • "orderSequence": 1,
  • "frequency": {
    },
  • "eventDescription": "This is a description.",
  • "day": 30,
  • "timeOfDay": {
    },
  • "paymentInstruction": {
    }
}

Response samples

Content type
application/json
{
  • "period": {
    },
  • "orderSequence": 1,
  • "frequency": {
    },
  • "eventDescription": "This is a description.",
  • "day": 30,
  • "timeOfDay": {
    },
  • "paymentInstruction": {
    },
  • "standingOrderId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "status": "Months",
  • "statusDateAndTime": "2022-04-17T08:00:00Z",
  • "cancellationReason": "This is a description."
}

Request Standing Order Cancellation

Authorizations:
jwtopenIdConnect
path Parameters
accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: 0dd926fe-1ca2-11ed-861d-0242ac120002

Account Identification

standingOrderId
required
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Standing Order Identification

header Parameters
idempotencyId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Idempotency identifier used by the client when making repeated calls

servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Request Body schema: application/json
cancellationReason
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."

Responses

Request samples

Content type
application/json
{
  • "cancellationReason": "This is a description."
}

Response samples

Content type
application/json
{
  • "period": {
    },
  • "orderSequence": 1,
  • "frequency": {
    },
  • "eventDescription": "This is a description.",
  • "day": 30,
  • "timeOfDay": {
    },
  • "paymentInstruction": {
    },
  • "standingOrderId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "status": "Months",
  • "statusDateAndTime": "2022-04-17T08:00:00Z",
  • "cancellationReason": "This is a description."
}

Parties

Person and Organization Management

Retrieves a list of persons matching the parameters.

Authorizations:
jwtopenIdConnect
query Parameters
name.inc
string

The person name includes the substring provided.

lastName.eq
string (PartyName) [ 1 .. 350 ] characters
Example: lastName.eq=Jane Birkin

Name by which a party is known and which is usually used to identify that party.

firstName.eq
string (PartyName) [ 1 .. 350 ] characters
Example: firstName.eq=Jane Birkin

Name by which a party is known and which is usually used to identify that party.

birthDate.eq
string <date> (Date)
Example: birthDate.eq=2022-04-17

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

phoneNumber.eq
string (PhoneNumber) ^\+[0-9]{1,3}-[0-9()+\-]{1,30}$
Example: phoneNumber.eq=+1-415-731359

Any phone number equals to.

accountNumber.eq
string (AccountNumber) <= 30 characters
Example: accountNumber.eq=012345678

The account number or Basic Bank Account Number (BBAN). A Basic Bank Account Number (BBAN) is a bank account number that includes the domestic bank code, branch identifier, and account number. It is a unique identifier for a bank account within a specific country.

tin.eq
string
ssn.eq
string

Social Security Number

ssn.last4
string

Social Security Number last four digits.

email.eq
string

Email equals to

addressLine.inc
string

Any address line of any postal address includes substring

postCode.eq
string

Any postal address with post code equals to

country.eq
string

Any postal address with Country code equals to

countrySubDivision.inc
string

Any postal address with country subdivision includes substring

townName.inc
string

Any postal address with town name includes substring

personId.eq
string (Id) [ 1 .. 36 ] characters
Example: personId.eq=5fb9d4d6-1a3c-11ed-861d-0242ac120002

System id equals to

audit.lastModificationDate.lte
string <date> (Date)
Example: audit.lastModificationDate.lte=2022-04-17

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

audit.lastModificationDate.gte
string <date> (Date)
Example: audit.lastModificationDate.gte=2022-04-17

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Creates a Person

Authorizations:
jwtopenIdConnect
header Parameters
idempotencyId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Idempotency identifier used by the client when making repeated calls

servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Request Body schema: application/json
uSDocumentedIndicator
boolean
Array of objects (PersonIdentification)
Array
number
required
string [ 1 .. 35 ] characters
Example: "123-45-6789"

Unique and unambiguous identification of a person.

schemeName
required
string [ 1 .. 35 ] characters
Example: "SocialSecurityNumber"

Name of the identification scheme in PascalCase form. Possible values are: AlienRegistrationNumber, PassportNumber, CustomerIdentificationNumber, DriversLicenseNumber, EmployeeIdentificationNumber, NationalIdentityNumber, SocialSecurityNumber, TelephoneNumber, TaxIdentificationNumber, PersonCommercialIdentification, StateIdentificationNumber, MilitaryIdCard, BirthMarriageCertificateNumber, MarriageCertificateNumber, BirthCertificateNumber, CountryTerritoriIdCard, DriverLicenseNumber, WageTaxStatementFormNumber, GovernmentDocumentNumber, HealthInsuranceCard, CertificateOfIncorporationNumber, CertificateOfOrganizationNumber, CertificateOfPartnershipNumber, ForwardHealthMedicaIdCard, MexicanConsularIdCard, DLNTaxExemptNumber, PhotoIdCard, PermantResidentCard, TribalIdCard, UtilityBillInvoiceNumber, VoterUniqueIdentifier, WisconsinCRISSearch, PropertyTaxBillNumber, MedicareCardId, OrganizationalDocumentNumber, CertificationOfTrustNumber, EstateDomiciliaryLetterNumber, TaxReturnFormNumber, MinorIdCard, EmploymentAuthorizationCard, StateDocumentNumber, TravelDocumentNumber, StateIssuedPermitNumber

issuer
string
Example: "Baltimore"

Entity that assigns the identification.

issueDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

expirationDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

foreingIDIndicator
boolean

Indicates whether the identifications is from a foreing country.

name
string (PartyName) [ 1 .. 350 ] characters
Example: "Jane Birkin"

Name by which a party is known and which is usually used to identify that party.

shortName
string (PartyShortName) [ 1 .. 35 ] characters
Example: "Jane"

Short name or nickname by which a party is known and which is usually used to identify that party.

nameTemplateId
string (NameTemplateId) [ 1 .. 36 ] characters
Example: "1"

Template used to display the party name. This is an external id provided by the account servicer.

nameSoundExId
string (SoundExId) [ 1 .. 36 ] characters
Example: "1"

Identification of a SoundEx method develop for search attribute. SoundEx is a method used to find strings when the sound is known but the precise spelling is not. It searches out words with similar sounds based on phonetic assumptions about how certain letters are pronounced. It can be used to search names in a database, for example, where spellings and pronunciations for similar names may vary.

partyBranchId
string (ServicerBranchId) [ 1 .. 36 ] characters
Example: "SEA_1"

Identification of the account servicer institution at branch level or operation level.

comment
string [ 1 .. 1025 ] characters
Example: "This is a description."

Bank commnent of the party.

Array of objects (RelatedParty)
Array
partyId
required
string (Id) [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"
partyType
required
string (PartyType)
Example: "Person"

Possible values are: Person, Organization. Also other types of servicer internal entities: ServicerOfficer

partyName
string (PartyName) [ 1 .. 350 ] characters
Example: "Jane Birkin"

Name by which a party is known and which is usually used to identify that party.

partyRelationType
required
string (PartyRelationType) [ 1 .. 40 ] characters
Example: "PrimaryServicerOfficer"

Type of relation between parties. Possible values Between Organizations and persons are: ResponsibleParty, OrganizationOwner, ControlPerson, BeneficialOwner, PrimaryContact, SecondaryContact. For Trusts: Trustor, Trustee. Between organizations: ParentOrganization, Branch. Between parties and external entities: AccountOpenningOfficer, CustomerServiceOfficer, PrimaryServicerOfficer, SecondaryServicerOfficer, SalesPerson, ReferralOfficer. Between financial institutions: AffiliateFinancialInstitution, HoldingCompany. Between persons: Spouse.

partyRelationDescription
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
ownershipPercentage
string <= 23 characters ^100|(([1-9][0-9]{0,1})([.][0-9]{0,8}){0,1})$...
Example: "25"

Company Ownership Percentage. If the relation Type is BeneficialOwner the ownership percentage could be added. Ownership means any person with more than 25% equity in the legal entity.

Array of objects (PostalAddress)
Array
addressType
string
Example: "Postal"

Specifies the type of address, in PascalCase form. Possible ISO Compliant values are: PhysicalAddress, Postal, POBox, Residential, Permanent, Temporary, Business.

addressPurpose
string
Example: "Billing"

Specifies the purpose of an address, in PascalCase form. Possible ISO Compliant values are: MailTo, DeliveryTo, Billing, PlaceOfOperation, PlaceOfRegistration

primaryIndicator
boolean (PrimaryContactIndicator)

Indicates whether the contact informacion is primary.

department
string [ 1 .. 70 ] characters
Example: "A"

Identification of a division of a large Organization or building.

subDepartment
string [ 1 .. 70 ] characters
Example: "B"

Identification of a sub-division of a large Organization or building.

streetName
string [ 1 .. 70 ] characters
Example: "First Street"

Name of a street or thoroughfare.

firstCrossStreetName
string [ 1 .. 70 ] characters

Name of a the first cross street.

secondCrossStreetName
string [ 1 .. 70 ] characters
Example: "Second Street"

Name of a the second cross street.

buildingNumber
string [ 1 .. 16 ] characters
Example: "11407"

Number that identifies the position of a building or house on a street.

buildingName
string [ 1 .. 35 ] characters
Example: "Tall Tower"

Name of the building or house.

floor
string [ 1 .. 70 ] characters
Example: "20"

Floor or storey within a building.

postBox
string [ 1 .. 16 ] characters
Example: "MY779"

Numbered box in a post office, assigned to a person or Organization, where letters are kept until called for.

room
string [ 1 .. 70 ] characters
Example: "22"

Building room number.

postCode
string (PostCode) [ 1 .. 16 ] characters
Example: "97062-68"

Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.

censusTrack
string (CensusTrack) = 5 characters
Example: "04013216813"

A census tract, census area, census district or meshblock is a geographic region defined for the purpose of taking a census

cBSACode
string (CBSACode) = 5 characters
Example: "49780"

Core-based statistical area. Metropolitan statistical area (MSA) is the formal definition of a region that consists of a city and surrounding communities that are linked by social and economic factors. Micropolitan Statistical Areas (MISA) are CBSAs associated with at least one urban cluster that has a population of at least 10,000, but less than 50,000. The micropolitan statistical area comprises the central county or counties or equivalent entities containing the core, plus adjacent outlying counties having a high degree of social and economic integration with the central county as measured through commuting.

cBSAType
string (CBSAType) [ 1 .. 10 ] characters
Example: "MSA"

Type of Core-based statistical area. Possible values: MSA, MISA

foreignIndicator
boolean

Indicates whether the postal address is from a foreing country.

townName
string (TownName) [ 1 .. 35 ] characters
Example: "Tualatin"

Name of a built-up area, with defined boundaries, and a local government.

townLocationName
string [ 1 .. 35 ] characters
Example: "Clackamas"

Specific location name within the town.

districtName
string [ 1 .. 35 ] characters
Example: "Washington"

Identifies a subdivision within a country sub-division.

countrySubDivision
string (CountrySubdivision) [ 1 .. 35 ] characters
Example: "Oregon"

Name of a country subdivision such as state, region, county.

countrySubDivisionCode
string (CountrySubdivisionCode) ^[A-Z]{2,2}\-[0-9A-Z]{1,3}
Example: "AR-B"

Code to identify a name of a unit resulting from the division of a country, dependency, or other area of special geopolitical interest contained in ISO 3166-1, on the basis of country names obtained from the United Nations (ISO 3166-2: Country subdivision code).

country
string (CountryCode) ^([A-Z]{2,2})?$
Example: "US"

Country name obtained from the United Nations (ISO 3166, Alpha-2 code).

addressLine
Array of strings[ items [ 1 .. 70 ] characters ]
Example: ["11407 Sw Amu st, Suite MY777"]

Information that locates and identifies a specific address, as defined by postal services, presented in free format text.

object

The period of use of the address information.

relationshipId
string [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"

This id gives the ability to view a party’s total relationship with the bank. The relationship Id ties multiple parties together. This code is also used to reduce mailing costs during marketing campaigns to avoid sending duplicate materials to parties residing at the same address.

relationshipLeadIndicator
boolean

The relationship lead is often the primary account owner or the party with whom the bank have the most contact.

residenceType
string [ 1 .. 35 ] characters
Example: "Domestic"

Specifies the type of residence where the party has its permanent home or principal establishment. Possible ISO Complaian values are: Domestic, Foreign, Mixed

object (TaxPartyInformation)

Taxation parameters which apply to an individual person or to an organization.

tIN
string
Example: "778-62-8144"

A Taxpayer Identification Number

taxIdType
string [ 1 .. 50 ] characters
Example: "SocialSecurityNumber"

Identifies what type of tax ID is in the TIN field. Possible Values: SocialSecurityNumber, EmployerIdentificationNumber, IndividualTaxpayerIdentificationNumber, AdoptionTaxpayerIdentificationNumber, PreparerTaxpayerIdentificationNumber, ForeignTaxID

financialReportingIndicator
boolean

Whether the financial income for this party should be reported to the U.S. government (IRS) when related to an account in a way which requires reporting (for example, primary, joint ownership). Defaults to true if not specified.

tINStatus
string
Example: "Valid"

'The tax ID has been verified by the IRS. Possible values: Valid, NotValid, NotVerified, IRSWarning, TINApplied.

object (TINVerification)

IRS information about the TIN provided.

verificationAttemps
integer <= 10
Example: 1

The Tax Identification Verification Attempts is the number of times attempts have been made to verify the tax ID number.

bNoticeDates
Array of strings <date> (Date)
Example: ["2022-04-17"]
tINResultCode
string <= 3

TIN matching result codes

taxStatus
string
Example: "Valid"

Exempt, Retain, ExemptExpired, VoluntaryWithholding, Chapter3, Chapter4, C-Corp, S-Corp.

Array of objects (TaxForm)

Forms applied by the party

Array
formName
required
string [ 1 .. 10 ] characters
Example: "W-8"

Form name requested. Possible Values: W-8BEN, W-8BEN-E, W-8ECI, W-8EXP, W-8IMY, W-9, W-8, 1042-S, 1099-INT, 1099-OID.

taxRate
string <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Indicates the tax rate provided by the IRS on the form.

Array of objects (TaxFormCode)

Codes provided by the IRS on the form.

recipientGIIN
string (GIIN) [ 1 .. 34 ] characters ^([A-N,P-Z,0-9]){6}\.([A-N,P-Z,0-9]){5}\.(LE|...
Example: "ADN123.FG4FE3.LE.999"

Global intermediary identification number (GIIN).

recipientPostCode
string (PostCode) [ 1 .. 16 ] characters
Example: "97062-68"

Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.

recipientTownName
string (TownName) [ 1 .. 35 ] characters
Example: "Tualatin"

Name of a built-up area, with defined boundaries, and a local government.

certificationDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

expirationDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

Array of objects (TaxRegulation)
Array
name
required
string [ 1 .. 35 ] characters
Example: "Chapter4"
section
string [ 1 .. 10 ] characters
Example: "1471"

String that represent the section number.

Array of objects (WithholdingTax)
Array
withholdingTaxType
required
string (WithholdingTaxType) [ 1 .. 35 ] characters
Example: "NonResidentAlienTax"

Type of Withholding. Possible Values: ForeignAccountTaxComplianceAct, NonResidentAlienTax, BackUpWithholding, VoluntaryWithholding, Federal, State, Local, W-4.

withholdingRate
string <= 23 characters ^100|(([1-9][0-9]{0,1})([.][0-9]{0,8}){0,1})$...
Example: "25"

Rate applied on a basis amount to calculate the withholding.

withholdingAmount
string <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Withholding amount.

foreignIndicator
boolean

Indicates whether the party is a non-residen alien or a foreign entity.

countrySubDivision
string (CountrySubdivision) [ 1 .. 35 ] characters
Example: "Oregon"

Name of a country subdivision such as state, region, county.

countrySubDivisionCode
string (CountrySubdivisionCode) ^[A-Z]{2,2}\-[0-9A-Z]{1,3}
Example: "AR-B"

Code to identify a name of a unit resulting from the division of a country, dependency, or other area of special geopolitical interest contained in ISO 3166-1, on the basis of country names obtained from the United Nations (ISO 3166-2: Country subdivision code).

country
string (CountryCode) ^([A-Z]{2,2})?$
Example: "US"

Country name obtained from the United Nations (ISO 3166, Alpha-2 code).

supplementaryData
object (SupplementaryData)

Additional information that cannot be captured in the structured elements and/or any other specific block. If this information need to be converted in ISO Messages, must be ISO 20022 compliant: it requires development of a compliant message extension model and its components must be registered in the ISO 20022 Data Dictionary. https://www.iso20022.org/catalogue-messages/additional-content-messages/supplementary-data

object (PowerOfAttorney)

Document that transfers specific rights from a party to a person.

documentId
string (Id) [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"
documentReference
string [ 1 .. 35 ] characters

Document location.

version
string [ 1 .. 18 ] characters

Document version indentification.

signOffDate
string <date>
Example: "2022-04-17"

Signoff date of the document.

issueDate
string <date>
Example: "2022-04-17"

Issue date of the document.

purpose
string [ 1 .. 35 ] characters

Specifies the function of the document.

fromDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period starts.

upToDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period ends.

periodNumber
integer

Sequence number of the period.

object (Jurisdiction)

Area with a set of laws under the control of a system which are different from neighbouring areas

countrySubdivision
string (CountrySubdivision) [ 1 .. 35 ] characters
Example: "Oregon"

Name of a country subdivision such as state, region, county.

townName
string (TownName) [ 1 .. 35 ] characters
Example: "Tualatin"

Name of a built-up area, with defined boundaries, and a local government.

country
string (CountryCode) ^([A-Z]{2,2})?$
Example: "US"

Country name obtained from the United Nations (ISO 3166, Alpha-2 code).

authorizedPerson
string [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"

Person which is the holder of the power of attorney.

authorizedAccount
string [ 1 .. 36 ] characters
Example: "0dd926fe-1ca2-11ed-861d-0242ac120002"

Specifies the account on which the power of attorney applies.

supplementaryData
object (SupplementaryData)

Additional information that cannot be captured in the structured elements and/or any other specific block. If this information need to be converted in ISO Messages, must be ISO 20022 compliant: it requires development of a compliant message extension model and its components must be registered in the ISO 20022 Data Dictionary. https://www.iso20022.org/catalogue-messages/additional-content-messages/supplementary-data

excludeMarketingIndicator
boolean
object (Audit)

Resource Audit Information. Captures the creation, modification and maintenance details.

status
string (AuditStatus) [ 1 .. 35 ] characters

Maintenance status of a resource. Possible values: Requested, Created, Changed, Deleted

creationDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

lastModificacionChannel
string (CommunicationChannelName) [ 1 .. 35 ] characters
Example: "Email"

Channel used to communicate with a party. Possible Values: Email, Fax, File, Online, PostalService, LiveSupport, ATM, IVR, Kiosk, Mobile, OnlineBanking, Phone, SMS, Card, InPerson.

lastModificationDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

Array of objects (AuditChannel)

Activity audit throught comunication channles

Array
lastActivityDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

name
string (CommunicationChannelName) [ 1 .. 35 ] characters
Example: "Email"

Channel used to communicate with a party. Possible Values: Email, Fax, File, Online, PostalService, LiveSupport, ATM, IVR, Kiosk, Mobile, OnlineBanking, Phone, SMS, Card, InPerson.

activityType
string (AuditActivityType) [ 1 .. 35 ] characters

Maintenance activity of a resource. Possible values: Transaction, Modification, Deposit, Withdrawal.

amount
string (PositiveAmountInCents) <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: 0

Array of objects (Restriction)

Access and operation restrictions at Party level.

Array
name
required
string [ 1 .. 60 ] characters
Example: "WireTransferIn"

Name of the restriction in PascalCase. Possible values: WireTransferIn, WireTransferOut, ForeignIncomingWires, ForeignOutgoingWires, ACHTransfers, InternetBankingTransfer, InternetView, InternetInquiry, ForeignOutgoingIran, Withdrawals, Renew, Transfers

restrictionPurpose
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
enableIndicator
boolean
Example: true

Indicates whether the capability is allowed or not.

validFrom
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

validUntil
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

object (PlaceAndDateOfBirth)

Date and place of birth of a person.

countrySubdivision
string (CountrySubdivision) [ 1 .. 35 ] characters
Example: "Oregon"

Name of a country subdivision such as state, region, county.

townName
string (TownName) [ 1 .. 35 ] characters
Example: "Tualatin"

Name of a built-up area, with defined boundaries, and a local government.

country
string (CountryCode) ^([A-Z]{2,2})?$
Example: "US"

Country name obtained from the United Nations (ISO 3166, Alpha-2 code).

birthDate
string <date>
Example: "2022-04-17"

Date on which a person is born.

signature
string <byte> (DigitalSignature) [ 1 .. 13654 ] characters
Example: {"0":83,"1":109,"2":70,"3":117,"4":90,"5":83,"6":66,"7":67,"8":97,"9":88,"10":74,"11":114,"12":97,"13":87,"14":52,"15":61}

Binary data of 10K maximum, base64 encoded.

signatureVerificationId
string (SignatureVerificationId) [ 1 .. 36 ] characters
Example: "0dd926fe-1ca2-11ed-861d-0242ac120002"

This field contains the key of the CISA validation record.

object (PersonContactDetails)

Specifies the contact details of a person.

object (StructuredName)

The structured name is used to initialize the person name with the format

firstName
required
string [ 1 .. 200 ] characters
Example: "Mary"

Person given first name.

middleName
string [ 1 .. 200 ] characters
Example: "Joe"

Person given middle name.

lastName
required
string [ 1 .. 200 ] characters
Example: "Smith"

Person surname.

suffix
string [ 1 .. 20 ] characters
Example: "PhD"

A name suffix in the Western English-Language naming tradition, follows a person's full name and provides additional information about the person. Possible Values: PhD, Snr, Jnr. Generation order should be expressed with roman numerals: I, II, III, IV, V.

prefix
string [ 1 .. 20 ] characters
Example: "Dr."

Name prefixes are typically Dr., Mr., Mrs., Ms.

name
string [ 1 .. 350 ] characters
Example: "Jane Birkin"

Preferred name to contact the person

Array of objects (Phone)
Array
number
required
string (PhoneNumber) ^\+[0-9]{1,3}-[0-9()+\-]{1,30}$
Example: "+1-415-731359"

The collection of information which identifies a specific phone or FAX number as defined by telecom services.

extension
string <= 5 characters

Phone Number Extension.

phoneType
string [ 1 .. 35 ] characters

Type of phone address. Possible values are:
Mobile, Landline, Fax, Pager, Modem

phonePurpose
string [ 1 .. 35 ] characters

Purpose of the phone address. Possible values are: Business, Personal, International.

primaryIndicator
boolean (PrimaryContactIndicator)

Indicates whether the contact informacion is primary.

object (HourOfTheDay)
comment
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
object

The period of use of the phone information.

Array of objects (Email)
Array
emailAddress
string [ 1 .. 2048 ] characters

Address for electronic mail (e-mail).

emailPurpose
string [ 1 .. 35 ] characters
Example: "Statements"

Purpose of the e-mail address. Possible values: Marketing, Statements, Business, Administrative

primaryIndicator
boolean (PrimaryContactIndicator)

Indicates whether the contact informacion is primary.

jobTitle
string (JobTitle) [ 1 .. 35 ] characters
Example: "Head of Documentation"

Title of the function in an organization.

department
string [ 1 .. 35 ] characters
Example: "Sales"

Identification of a division of a large Organization or building.

Array of objects (CommunicationChannel)
Array
channel
string (CommunicationChannelName) [ 1 .. 35 ] characters
Example: "Email"

Channel used to communicate with a party. Possible Values: Email, Fax, File, Online, PostalService, LiveSupport, ATM, IVR, Kiosk, Mobile, OnlineBanking, Phone, SMS, Card, InPerson.

channelIdentification
string (CommunicationChannelIdentification) [ 1 .. 128 ] characters
Example: "011-02010020202"

Communication value such as phone number or email address.

channelPurpose
string (CommunicationChannelPurpose) [ 1 .. 40 ] characters
Example: "Alert"

Communication purpose of the channel. Possible values: Alerts, PrivacyNotices

codeWord
string

A party is asked for a codeword to verify their identity trought a communication channel

alertIndicator
any

Indicates whether the channel is used for enterprise alerts

object (CommunicationChannelHistory)
primaryIndicator
boolean (PrimaryContactIndicator)

Indicates whether the contact informacion is primary.

preferredMethod
string (CommunicationChannelName) [ 1 .. 35 ] characters
Example: "Email"

Channel used to communicate with a party. Possible Values: Email, Fax, File, Online, PostalService, LiveSupport, ATM, IVR, Kiosk, Mobile, OnlineBanking, Phone, SMS, Card, InPerson.

preferredLanguage
string (PreferredLanguage) [ 1 .. 35 ] characters
Example: "English"

Language of the contact person. Names according to the language list provided in the ISO 639-1 codes. Some possible values: Chinese, Spanish, French, English, Japanese, Italian, German.

headOfHousehold
boolean
Example: true

Indicates whether the person pay the costs of supporting a house.

civilStatus
string (CivilStatus) [ 1 .. 17 ] characters
Example: "Single"

Specifies the civil status of a person. Possible ISO 20022 compliant values names are: Single, Married, LegallyDivorced, Divorced, Widowed, StableUnion

object (StructuredName)

The structured name is used to initialize the person name with the format

firstName
required
string [ 1 .. 200 ] characters
Example: "Mary"

Person given first name.

middleName
string [ 1 .. 200 ] characters
Example: "Joe"

Person given middle name.

lastName
required
string [ 1 .. 200 ] characters
Example: "Smith"

Person surname.

suffix
string [ 1 .. 20 ] characters
Example: "PhD"

A name suffix in the Western English-Language naming tradition, follows a person's full name and provides additional information about the person. Possible Values: PhD, Snr, Jnr. Generation order should be expressed with roman numerals: I, II, III, IV, V.

prefix
string [ 1 .. 20 ] characters
Example: "Dr."

Name prefixes are typically Dr., Mr., Mrs., Ms.

gender
string (Gender) [ 1 .. 36 ] characters
Example: "Female"

Specifies the gender of the person. Possible Values: Female, Male, NonBinary

race
string (Race) [ 1 .. 35 ] characters
Example: "Director"

Categorization of humans based on shared physical qualities. Possible Values: NativeAmerican, African, Hispanic, White, Asian

profession
string (Profession) <= 35 characters
Example: "Artist"

Professional Designation or name of the occupation of a person.

jobTitle
string (JobTitle) [ 1 .. 35 ] characters
Example: "Head of Documentation"

Title of the function in an organization.

residentialStatus
string (ResidentialStatus) [ 1 .. 35 ] characters
Example: "Permanent"

Residential status of an individual. Possible values: Permanent, Resident, NonResident, Rents, Owns

minorIndicator
boolean (MinorIndicator)

Indicates whether the person is a legal minor.

Array of objects (Citizenship)
Array
fromDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period starts.

upToDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period ends.

periodNumber
integer

Sequence number of the period.

country
string (CountryCode) ^([A-Z]{2,2})?$
Example: "US"

Country name obtained from the United Nations (ISO 3166, Alpha-2 code).

countryOfResidence
string (CountryCode) ^([A-Z]{2,2})?$
Example: "US"

Country name obtained from the United Nations (ISO 3166, Alpha-2 code).

object (PersonProfile)

Information to support Know Your Customer (KYC) processes.

riskLevel
string (RiskLevel) [ 1 .. 35 ] characters
Example: "Permanent"

Specifies the customer’s money laundering risk. Possible values: High, Medium, Low, None.

bSARiskCode
integer (BSARiskCode) <= 10
Example: 0

Used to identify customers that present a risk to the bank as defined by the Bank Secrecy Act. For example, use this code to identify and monitor accounts suspected of fraud, kiting or money laundering.

object (CreditReview)

A credit review is a periodic assessment of an individual’s or businesses' credit profile.

object (Frequency)

Specifies an event frequency

lastReviewDate
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time if the last credit review.

nextReviewDate
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time if the next credit review.

creditQuality
string (CreditQuality) [ 1 .. 35 ] characters
Example: "UpperMediumGrade"

Credit quality rating of an issuer or financial obligation. Possible Values: DefaultImminent, ExtremelySpeculative, HighGrade, HighlySpeculative, InDefault, LowerMediumGrade, NonInvestmentGradeSpeculative, Prime, SubstantialRisk, UpperMediumGrade

creditScore
integer
creditBureauReportCode
string

Code used for reporting to the credit bureaus. This code is used to report the trade line of a credit account to the credit bureau agencies.

oFACReportingIndicator
boolean

Indicates whether the party is to be excluded from OFAC Reporting.

previousFinancialInstitution
string (PartyName) [ 1 .. 350 ] characters
Example: "Jane Birkin"

Name by which a party is known and which is usually used to identify that party.

referredByWhom
string [ 1 .. 350 ] characters
Example: "Jane Birkin"

Name by which a party is known and which is usually used to identify that party.

moneyLaunderingCheck
string (MoneyLaunderingCheck)
Example: "AuthorizedCredit"

Specifies the status of money laundering identification procedures. Possible Values: PassedNotChecked, ExemptBelowLimit, ClientMoneyTypeExempt, AuthorizedCredit, PostalOrElectronicPaymentExempt

knowYourCustomerCheck
string (KnowYourCustomerCheckType) [ 1 .. 36 ] characters
Example: "Ordinary"

Specifies the type of Know Your Customer (KYC) or anti-money laundering due diligence to which the investor has been subjected. Possible Values: Ordinary, Simple, Enhanced.

object (TemporalDuration)

Describes a temporal duration.

unit
required
string [ 1 .. 36 ] characters
Example: "Months"

Unit that describes the duration.

value
required
integer <= 999

Value of the duration in number of units.

dateAtCurrentAddress
string <date>
Example: "2022-04-17"

Date of Residence in the current household.

sourceOfWealth
string [ 1 .. 1025 ] characters
Example: "This is a description."

Indicates the main sources of the money.

politicalAffiliation
string

Indicates the political affiliation of the Party. Possible values could be: Democrat, Independent, Republican.

lostCustomerDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

lostCustomerReason
string (LostCustomerReason) [ 1 .. 35 ] characters
Example: "Deceased"

Used for regulatory purposes by the bank to track how long closed account history has been maintained for a customer. Possible values are: Competition, Deceased, Dissatisfied, Moved, MergedEntity, CeasedOperation

Array of objects (ServicerAlert)

Customer alerts to be received by the account servicer.

Array
alertName
string (AlertName) [ 1 .. 35 ] characters
Example: "CreditBureauAlert"

An alert notification received by the bank. Possible values: CreditBureauAlert, CustomerAlert, PaymentCard

alertType
string (AlertType) [ 1 .. 35 ] characters
Example: "Warning"

An alert notification type. Possible values: Warning, Urgent.

alertCode
string [ 1 .. 36 ] characters
message
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
lastAlertDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

object (CustomerIdentificationProgram)

CIP requires that financial firms must obtain four pieces of identifying information about a client.

certificateDocument
Array of strings (CertificateDocumentName) [ items [ 1 .. 60 ] characters ]
Example: ["IdentityCard"]

Documents used to certify the customer identity

certificationStatus
string (CertificationStatus) [ 1 .. 60 ] characters
Example: "CertifiedLevel1"

Customer Identification Program (CIP) status. Designates the type of verification used for Customer Identification. This status could be obtained from a specific software the bank is using. Possible Values: NotCertified, CertifiedLevel1, CertifiedLevel2, CertifiedLevel3, FraudCheckOnly, Level1Check, Level2FraudCheck.

certificationDate
string <date-time> (DateAndTime)
Example: "2022-04-17T08:00:00Z"
object (Frequency)

Specifies an event frequency

customerConductClassification
string (CustomerConductClassification) [ 1 .. 35 ] characters

Assessment of the customer’s behaviour at the time of the account opening application. Possible Values: Standard, NonStandard, Reluctant.

familyMedicalInsuranceIndicator
boolean
Example: true

Indicates if the person has family medical insurance coverage available.

object (AmountRange)

Range an amount

minAmount
string (PositiveAmountInCents) <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: 0

maxAmount
string (PositiveAmountInCents) <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: 0

residenceValue
string (PositiveAmountInCents) <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: 0

residenceMortage
string (PartyName) [ 1 .. 350 ] characters
Example: "Jane Birkin"

Name by which a party is known and which is usually used to identify that party.

employmentStatus
string (EmploymentStatus)

Represents available individual employment status. Possible Values: Contract, Employed, Homemaker, Retired, SelfEmployed, Student, Temporary, Unemployed.

vIPStatus
string (VIPStatus)
Example: "Elite"

Very Important People Program Status. Possible Values: Novice, Pro, Elite

Array of objects (Employment)
Array
employingPartyName
string (PartyName) [ 1 .. 350 ] characters
Example: "Jane Birkin"

Name by which a party is known and which is usually used to identify that party.

jobTitle
string (JobTitle) [ 1 .. 35 ] characters
Example: "Head of Documentation"

Title of the function in an organization.

employeeTerminationIndicator
boolean
Example: false
object (TemporalDuration)

Describes a temporal duration.

endDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

object (Place)

Town, CountrySubdivision and Country .

object (ServicerMember)

The servicer member information is used to provide info to Regulation 0. The Regulation 0 is a Federal Reserve regulation that places limits and stipulations on the credit extensions a member bank can offer to its executive officers, principal shareholders, and directors.

insider
string (InsiderType) [ 1 .. 35 ] characters
Example: "Director"

Director, Employee, Officer, PrincipalShareholder, Shareholder, Executive.

familyRelationship
string [ 1 .. 40 ] characters
Example: "PrimaryServicerOfficer"

Insider familiar relation. Child, Spouse, Parent, Relative

institutionRelationship
string [ 1 .. 40 ] characters
Example: "PrimaryServicerOfficer"

Relation with the insider financial institution. Possible Values: AffiliateFinancialInstitution, HoldingCompany.

anualIncome
string (PositiveAmountInCents) <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: 0

yearsOfEducation
integer
politicallyExposedPerson
boolean
Example: true

Indicates if the person is a politically exposed person (PEP). Is one who has been entrusted with a prominent public function. A PEP generally presents a higher risk for potential involvement in bribery and corruption.

privacyNoticedIndicator
boolean
Example: true

Indicates whether the person allow distributing personal information to third parties.

identityTheftServiceIndicator
boolean
Example: true

Indicates whether the person has subscribed to an Identity Theft service.

Array of objects (IdentityQuestion)
Array
question
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
answer
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."

Responses

Request samples

Content type
application/json
{
  • "uSDocumentedIndicator": true,
  • "identifiers": [
    ],
  • "name": "Jane Birkin",
  • "shortName": "Jane",
  • "nameTemplateId": "1",
  • "nameSoundExId": "1",
  • "partyBranchId": "SEA_1",
  • "comment": "This is a description.",
  • "relatedParties": [
    ],
  • "postalAddresses": [
    ],
  • "relationshipId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "relationshipLeadIndicator": true,
  • "residenceType": "Domestic",
  • "taxInformation": {
    },
  • "powerOfAttorney": {
    },
  • "supplementaryData": { },
  • "excludeMarketingIndicator": true,
  • "audit": {
    },
  • "restrictions": [
    ],
  • "placeAndDateOfBirth": {
    },
  • "signature": {
    },
  • "signatureVerificationId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "contact": {
    },
  • "headOfHousehold": true,
  • "civilStatus": "Single",
  • "structuredName": {
    },
  • "gender": "Female",
  • "race": "Director",
  • "profession": "Artist",
  • "jobTitle": "Head of Documentation",
  • "residentialStatus": "Permanent",
  • "minorIndicator": true,
  • "citizenships": [
    ],
  • "countryOfResidence": "US",
  • "profile": {
    }
}

Response samples

Content type
application/json
{
  • "uSDocumentedIndicator": true,
  • "identifiers": [
    ],
  • "name": "Jane Birkin",
  • "shortName": "Jane",
  • "nameTemplateId": "1",
  • "nameSoundExId": "1",
  • "partyBranchId": "SEA_1",
  • "comment": "This is a description.",
  • "relatedParties": [
    ],
  • "postalAddresses": [
    ],
  • "relationshipId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "relationshipLeadIndicator": true,
  • "residenceType": "Domestic",
  • "taxInformation": {
    },
  • "powerOfAttorney": {
    },
  • "supplementaryData": { },
  • "excludeMarketingIndicator": true,
  • "audit": {
    },
  • "restrictions": [
    ],
  • "placeAndDateOfBirth": {
    },
  • "signature": {
    },
  • "signatureVerificationId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "contact": {
    },
  • "headOfHousehold": true,
  • "civilStatus": "Single",
  • "structuredName": {
    },
  • "gender": "Female",
  • "race": "Director",
  • "profession": "Artist",
  • "jobTitle": "Head of Documentation",
  • "residentialStatus": "Permanent",
  • "minorIndicator": true,
  • "citizenships": [
    ],
  • "countryOfResidence": "US",
  • "profile": {
    },
  • "personId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "status": "Queued"
}

Retrieves a Person

Authorizations:
jwtopenIdConnect
path Parameters
personId
required
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Person Identification

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Responses

Response samples

Content type
application/json
{
  • "uSDocumentedIndicator": true,
  • "identifiers": [
    ],
  • "name": "Jane Birkin",
  • "shortName": "Jane",
  • "nameTemplateId": "1",
  • "nameSoundExId": "1",
  • "partyBranchId": "SEA_1",
  • "comment": "This is a description.",
  • "relatedParties": [
    ],
  • "postalAddresses": [
    ],
  • "relationshipId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "relationshipLeadIndicator": true,
  • "residenceType": "Domestic",
  • "taxInformation": {
    },
  • "powerOfAttorney": {
    },
  • "supplementaryData": { },
  • "excludeMarketingIndicator": true,
  • "audit": {
    },
  • "restrictions": [
    ],
  • "placeAndDateOfBirth": {
    },
  • "signature": {
    },
  • "signatureVerificationId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "contact": {
    },
  • "headOfHousehold": true,
  • "civilStatus": "Single",
  • "structuredName": {
    },
  • "gender": "Female",
  • "race": "Director",
  • "profession": "Artist",
  • "jobTitle": "Head of Documentation",
  • "residentialStatus": "Permanent",
  • "minorIndicator": true,
  • "citizenships": [
    ],
  • "countryOfResidence": "US",
  • "profile": {
    },
  • "personId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "status": "Queued"
}

Updates a Person

Use the JSON Merge Patch standard https://tools.ietf.org/html/rfc7396

Authorizations:
jwtopenIdConnect
path Parameters
personId
required
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Person Identification

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Request Body schema: application/merge-patch+json
uSDocumentedIndicator
boolean
Array of objects (PersonIdentification)
Array
number
required
string [ 1 .. 35 ] characters
Example: "123-45-6789"

Unique and unambiguous identification of a person.

schemeName
required
string [ 1 .. 35 ] characters
Example: "SocialSecurityNumber"

Name of the identification scheme in PascalCase form. Possible values are: AlienRegistrationNumber, PassportNumber, CustomerIdentificationNumber, DriversLicenseNumber, EmployeeIdentificationNumber, NationalIdentityNumber, SocialSecurityNumber, TelephoneNumber, TaxIdentificationNumber, PersonCommercialIdentification, StateIdentificationNumber, MilitaryIdCard, BirthMarriageCertificateNumber, MarriageCertificateNumber, BirthCertificateNumber, CountryTerritoriIdCard, DriverLicenseNumber, WageTaxStatementFormNumber, GovernmentDocumentNumber, HealthInsuranceCard, CertificateOfIncorporationNumber, CertificateOfOrganizationNumber, CertificateOfPartnershipNumber, ForwardHealthMedicaIdCard, MexicanConsularIdCard, DLNTaxExemptNumber, PhotoIdCard, PermantResidentCard, TribalIdCard, UtilityBillInvoiceNumber, VoterUniqueIdentifier, WisconsinCRISSearch, PropertyTaxBillNumber, MedicareCardId, OrganizationalDocumentNumber, CertificationOfTrustNumber, EstateDomiciliaryLetterNumber, TaxReturnFormNumber, MinorIdCard, EmploymentAuthorizationCard, StateDocumentNumber, TravelDocumentNumber, StateIssuedPermitNumber

issuer
string
Example: "Baltimore"

Entity that assigns the identification.

issueDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

expirationDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

foreingIDIndicator
boolean

Indicates whether the identifications is from a foreing country.

name
string (PartyName) [ 1 .. 350 ] characters
Example: "Jane Birkin"

Name by which a party is known and which is usually used to identify that party.

shortName
string (PartyShortName) [ 1 .. 35 ] characters
Example: "Jane"

Short name or nickname by which a party is known and which is usually used to identify that party.

nameTemplateId
string (NameTemplateId) [ 1 .. 36 ] characters
Example: "1"

Template used to display the party name. This is an external id provided by the account servicer.

nameSoundExId
string (SoundExId) [ 1 .. 36 ] characters
Example: "1"

Identification of a SoundEx method develop for search attribute. SoundEx is a method used to find strings when the sound is known but the precise spelling is not. It searches out words with similar sounds based on phonetic assumptions about how certain letters are pronounced. It can be used to search names in a database, for example, where spellings and pronunciations for similar names may vary.

partyBranchId
string (ServicerBranchId) [ 1 .. 36 ] characters
Example: "SEA_1"

Identification of the account servicer institution at branch level or operation level.

comment
string [ 1 .. 1025 ] characters
Example: "This is a description."

Bank commnent of the party.

Array of objects (RelatedParty)
Array
partyId
required
string (Id) [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"
partyType
required
string (PartyType)
Example: "Person"

Possible values are: Person, Organization. Also other types of servicer internal entities: ServicerOfficer

partyName
string (PartyName) [ 1 .. 350 ] characters
Example: "Jane Birkin"

Name by which a party is known and which is usually used to identify that party.

partyRelationType
required
string (PartyRelationType) [ 1 .. 40 ] characters
Example: "PrimaryServicerOfficer"

Type of relation between parties. Possible values Between Organizations and persons are: ResponsibleParty, OrganizationOwner, ControlPerson, BeneficialOwner, PrimaryContact, SecondaryContact. For Trusts: Trustor, Trustee. Between organizations: ParentOrganization, Branch. Between parties and external entities: AccountOpenningOfficer, CustomerServiceOfficer, PrimaryServicerOfficer, SecondaryServicerOfficer, SalesPerson, ReferralOfficer. Between financial institutions: AffiliateFinancialInstitution, HoldingCompany. Between persons: Spouse.

partyRelationDescription
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
ownershipPercentage
string <= 23 characters ^100|(([1-9][0-9]{0,1})([.][0-9]{0,8}){0,1})$...
Example: "25"

Company Ownership Percentage. If the relation Type is BeneficialOwner the ownership percentage could be added. Ownership means any person with more than 25% equity in the legal entity.

Array of objects (PostalAddress)
Array
addressType
string
Example: "Postal"

Specifies the type of address, in PascalCase form. Possible ISO Compliant values are: PhysicalAddress, Postal, POBox, Residential, Permanent, Temporary, Business.

addressPurpose
string
Example: "Billing"

Specifies the purpose of an address, in PascalCase form. Possible ISO Compliant values are: MailTo, DeliveryTo, Billing, PlaceOfOperation, PlaceOfRegistration

primaryIndicator
boolean (PrimaryContactIndicator)

Indicates whether the contact informacion is primary.

department
string [ 1 .. 70 ] characters
Example: "A"

Identification of a division of a large Organization or building.

subDepartment
string [ 1 .. 70 ] characters
Example: "B"

Identification of a sub-division of a large Organization or building.

streetName
string [ 1 .. 70 ] characters
Example: "First Street"

Name of a street or thoroughfare.

firstCrossStreetName
string [ 1 .. 70 ] characters

Name of a the first cross street.

secondCrossStreetName
string [ 1 .. 70 ] characters
Example: "Second Street"

Name of a the second cross street.

buildingNumber
string [ 1 .. 16 ] characters
Example: "11407"

Number that identifies the position of a building or house on a street.

buildingName
string [ 1 .. 35 ] characters
Example: "Tall Tower"

Name of the building or house.

floor
string [ 1 .. 70 ] characters
Example: "20"

Floor or storey within a building.

postBox
string [ 1 .. 16 ] characters
Example: "MY779"

Numbered box in a post office, assigned to a person or Organization, where letters are kept until called for.

room
string [ 1 .. 70 ] characters
Example: "22"

Building room number.

postCode
string (PostCode) [ 1 .. 16 ] characters
Example: "97062-68"

Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.

censusTrack
string (CensusTrack) = 5 characters
Example: "04013216813"

A census tract, census area, census district or meshblock is a geographic region defined for the purpose of taking a census

cBSACode
string (CBSACode) = 5 characters
Example: "49780"

Core-based statistical area. Metropolitan statistical area (MSA) is the formal definition of a region that consists of a city and surrounding communities that are linked by social and economic factors. Micropolitan Statistical Areas (MISA) are CBSAs associated with at least one urban cluster that has a population of at least 10,000, but less than 50,000. The micropolitan statistical area comprises the central county or counties or equivalent entities containing the core, plus adjacent outlying counties having a high degree of social and economic integration with the central county as measured through commuting.

cBSAType
string (CBSAType) [ 1 .. 10 ] characters
Example: "MSA"

Type of Core-based statistical area. Possible values: MSA, MISA

foreignIndicator
boolean

Indicates whether the postal address is from a foreing country.

townName
string (TownName) [ 1 .. 35 ] characters
Example: "Tualatin"

Name of a built-up area, with defined boundaries, and a local government.

townLocationName
string [ 1 .. 35 ] characters
Example: "Clackamas"

Specific location name within the town.

districtName
string [ 1 .. 35 ] characters
Example: "Washington"

Identifies a subdivision within a country sub-division.

countrySubDivision
string (CountrySubdivision) [ 1 .. 35 ] characters
Example: "Oregon"

Name of a country subdivision such as state, region, county.

countrySubDivisionCode
string (CountrySubdivisionCode) ^[A-Z]{2,2}\-[0-9A-Z]{1,3}
Example: "AR-B"

Code to identify a name of a unit resulting from the division of a country, dependency, or other area of special geopolitical interest contained in ISO 3166-1, on the basis of country names obtained from the United Nations (ISO 3166-2: Country subdivision code).

country
string (CountryCode) ^([A-Z]{2,2})?$
Example: "US"

Country name obtained from the United Nations (ISO 3166, Alpha-2 code).

addressLine
Array of strings[ items [ 1 .. 70 ] characters ]
Example: ["11407 Sw Amu st, Suite MY777"]

Information that locates and identifies a specific address, as defined by postal services, presented in free format text.

object

The period of use of the address information.

relationshipId
string [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"

This id gives the ability to view a party’s total relationship with the bank. The relationship Id ties multiple parties together. This code is also used to reduce mailing costs during marketing campaigns to avoid sending duplicate materials to parties residing at the same address.

relationshipLeadIndicator
boolean

The relationship lead is often the primary account owner or the party with whom the bank have the most contact.

residenceType
string [ 1 .. 35 ] characters
Example: "Domestic"

Specifies the type of residence where the party has its permanent home or principal establishment. Possible ISO Complaian values are: Domestic, Foreign, Mixed

object (TaxPartyInformation)

Taxation parameters which apply to an individual person or to an organization.

tIN
string
Example: "778-62-8144"

A Taxpayer Identification Number

taxIdType
string [ 1 .. 50 ] characters
Example: "SocialSecurityNumber"

Identifies what type of tax ID is in the TIN field. Possible Values: SocialSecurityNumber, EmployerIdentificationNumber, IndividualTaxpayerIdentificationNumber, AdoptionTaxpayerIdentificationNumber, PreparerTaxpayerIdentificationNumber, ForeignTaxID

financialReportingIndicator
boolean

Whether the financial income for this party should be reported to the U.S. government (IRS) when related to an account in a way which requires reporting (for example, primary, joint ownership). Defaults to true if not specified.

tINStatus
string
Example: "Valid"

'The tax ID has been verified by the IRS. Possible values: Valid, NotValid, NotVerified, IRSWarning, TINApplied.

object (TINVerification)

IRS information about the TIN provided.

verificationAttemps
integer <= 10
Example: 1

The Tax Identification Verification Attempts is the number of times attempts have been made to verify the tax ID number.

bNoticeDates
Array of strings <date> (Date)
Example: ["2022-04-17"]
tINResultCode
string <= 3

TIN matching result codes

taxStatus
string
Example: "Valid"

Exempt, Retain, ExemptExpired, VoluntaryWithholding, Chapter3, Chapter4, C-Corp, S-Corp.

Array of objects (TaxForm)

Forms applied by the party

Array
formName
required
string [ 1 .. 10 ] characters
Example: "W-8"

Form name requested. Possible Values: W-8BEN, W-8BEN-E, W-8ECI, W-8EXP, W-8IMY, W-9, W-8, 1042-S, 1099-INT, 1099-OID.

taxRate
string <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Indicates the tax rate provided by the IRS on the form.

Array of objects (TaxFormCode)

Codes provided by the IRS on the form.

recipientGIIN
string (GIIN) [ 1 .. 34 ] characters ^([A-N,P-Z,0-9]){6}\.([A-N,P-Z,0-9]){5}\.(LE|...
Example: "ADN123.FG4FE3.LE.999"

Global intermediary identification number (GIIN).

recipientPostCode
string (PostCode) [ 1 .. 16 ] characters
Example: "97062-68"

Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.

recipientTownName
string (TownName) [ 1 .. 35 ] characters
Example: "Tualatin"

Name of a built-up area, with defined boundaries, and a local government.

certificationDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

expirationDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

Array of objects (TaxRegulation)
Array
name
required
string [ 1 .. 35 ] characters
Example: "Chapter4"
section
string [ 1 .. 10 ] characters
Example: "1471"

String that represent the section number.

Array of objects (WithholdingTax)
Array
withholdingTaxType
required
string (WithholdingTaxType) [ 1 .. 35 ] characters
Example: "NonResidentAlienTax"

Type of Withholding. Possible Values: ForeignAccountTaxComplianceAct, NonResidentAlienTax, BackUpWithholding, VoluntaryWithholding, Federal, State, Local, W-4.

withholdingRate
string <= 23 characters ^100|(([1-9][0-9]{0,1})([.][0-9]{0,8}){0,1})$...
Example: "25"

Rate applied on a basis amount to calculate the withholding.

withholdingAmount
string <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Withholding amount.

foreignIndicator
boolean

Indicates whether the party is a non-residen alien or a foreign entity.

countrySubDivision
string (CountrySubdivision) [ 1 .. 35 ] characters
Example: "Oregon"

Name of a country subdivision such as state, region, county.

countrySubDivisionCode
string (CountrySubdivisionCode) ^[A-Z]{2,2}\-[0-9A-Z]{1,3}
Example: "AR-B"

Code to identify a name of a unit resulting from the division of a country, dependency, or other area of special geopolitical interest contained in ISO 3166-1, on the basis of country names obtained from the United Nations (ISO 3166-2: Country subdivision code).

country
string (CountryCode) ^([A-Z]{2,2})?$
Example: "US"

Country name obtained from the United Nations (ISO 3166, Alpha-2 code).

supplementaryData
object (SupplementaryData)

Additional information that cannot be captured in the structured elements and/or any other specific block. If this information need to be converted in ISO Messages, must be ISO 20022 compliant: it requires development of a compliant message extension model and its components must be registered in the ISO 20022 Data Dictionary. https://www.iso20022.org/catalogue-messages/additional-content-messages/supplementary-data

object (PowerOfAttorney)

Document that transfers specific rights from a party to a person.

documentId
string (Id) [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"
documentReference
string [ 1 .. 35 ] characters

Document location.

version
string [ 1 .. 18 ] characters

Document version indentification.

signOffDate
string <date>
Example: "2022-04-17"

Signoff date of the document.

issueDate
string <date>
Example: "2022-04-17"

Issue date of the document.

purpose
string [ 1 .. 35 ] characters

Specifies the function of the document.

fromDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period starts.

upToDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period ends.

periodNumber
integer

Sequence number of the period.

object (Jurisdiction)

Area with a set of laws under the control of a system which are different from neighbouring areas

countrySubdivision
string (CountrySubdivision) [ 1 .. 35 ] characters
Example: "Oregon"

Name of a country subdivision such as state, region, county.

townName
string (TownName) [ 1 .. 35 ] characters
Example: "Tualatin"

Name of a built-up area, with defined boundaries, and a local government.

country
string (CountryCode) ^([A-Z]{2,2})?$
Example: "US"

Country name obtained from the United Nations (ISO 3166, Alpha-2 code).

authorizedPerson
string [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"

Person which is the holder of the power of attorney.

authorizedAccount
string [ 1 .. 36 ] characters
Example: "0dd926fe-1ca2-11ed-861d-0242ac120002"

Specifies the account on which the power of attorney applies.

supplementaryData
object (SupplementaryData)

Additional information that cannot be captured in the structured elements and/or any other specific block. If this information need to be converted in ISO Messages, must be ISO 20022 compliant: it requires development of a compliant message extension model and its components must be registered in the ISO 20022 Data Dictionary. https://www.iso20022.org/catalogue-messages/additional-content-messages/supplementary-data

excludeMarketingIndicator
boolean
object (Audit)

Resource Audit Information. Captures the creation, modification and maintenance details.

status
string (AuditStatus) [ 1 .. 35 ] characters

Maintenance status of a resource. Possible values: Requested, Created, Changed, Deleted

creationDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

lastModificacionChannel
string (CommunicationChannelName) [ 1 .. 35 ] characters
Example: "Email"

Channel used to communicate with a party. Possible Values: Email, Fax, File, Online, PostalService, LiveSupport, ATM, IVR, Kiosk, Mobile, OnlineBanking, Phone, SMS, Card, InPerson.

lastModificationDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

Array of objects (AuditChannel)

Activity audit throught comunication channles

Array
lastActivityDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

name
string (CommunicationChannelName) [ 1 .. 35 ] characters
Example: "Email"

Channel used to communicate with a party. Possible Values: Email, Fax, File, Online, PostalService, LiveSupport, ATM, IVR, Kiosk, Mobile, OnlineBanking, Phone, SMS, Card, InPerson.

activityType
string (AuditActivityType) [ 1 .. 35 ] characters

Maintenance activity of a resource. Possible values: Transaction, Modification, Deposit, Withdrawal.

amount
string (PositiveAmountInCents) <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: 0

Array of objects (Restriction)

Access and operation restrictions at Party level.

Array
name
required
string [ 1 .. 60 ] characters
Example: "WireTransferIn"

Name of the restriction in PascalCase. Possible values: WireTransferIn, WireTransferOut, ForeignIncomingWires, ForeignOutgoingWires, ACHTransfers, InternetBankingTransfer, InternetView, InternetInquiry, ForeignOutgoingIran, Withdrawals, Renew, Transfers

restrictionPurpose
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
enableIndicator
boolean
Example: true

Indicates whether the capability is allowed or not.

validFrom
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

validUntil
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

object (PlaceAndDateOfBirth)

Date and place of birth of a person.

countrySubdivision
string (CountrySubdivision) [ 1 .. 35 ] characters
Example: "Oregon"

Name of a country subdivision such as state, region, county.

townName
string (TownName) [ 1 .. 35 ] characters
Example: "Tualatin"

Name of a built-up area, with defined boundaries, and a local government.

country
string (CountryCode) ^([A-Z]{2,2})?$
Example: "US"

Country name obtained from the United Nations (ISO 3166, Alpha-2 code).

birthDate
string <date>
Example: "2022-04-17"

Date on which a person is born.

signature
string <byte> (DigitalSignature) [ 1 .. 13654 ] characters
Example: {"0":83,"1":109,"2":70,"3":117,"4":90,"5":83,"6":66,"7":67,"8":97,"9":88,"10":74,"11":114,"12":97,"13":87,"14":52,"15":61}

Binary data of 10K maximum, base64 encoded.

signatureVerificationId
string (SignatureVerificationId) [ 1 .. 36 ] characters
Example: "0dd926fe-1ca2-11ed-861d-0242ac120002"

This field contains the key of the CISA validation record.

object (PersonContactDetails)

Specifies the contact details of a person.

object (StructuredName)

The structured name is used to initialize the person name with the format

firstName
required
string [ 1 .. 200 ] characters
Example: "Mary"

Person given first name.

middleName
string [ 1 .. 200 ] characters
Example: "Joe"

Person given middle name.

lastName
required
string [ 1 .. 200 ] characters
Example: "Smith"

Person surname.

suffix
string [ 1 .. 20 ] characters
Example: "PhD"

A name suffix in the Western English-Language naming tradition, follows a person's full name and provides additional information about the person. Possible Values: PhD, Snr, Jnr. Generation order should be expressed with roman numerals: I, II, III, IV, V.

prefix
string [ 1 .. 20 ] characters
Example: "Dr."

Name prefixes are typically Dr., Mr., Mrs., Ms.

name
string [ 1 .. 350 ] characters
Example: "Jane Birkin"

Preferred name to contact the person

Array of objects (Phone)
Array
number
required
string (PhoneNumber) ^\+[0-9]{1,3}-[0-9()+\-]{1,30}$
Example: "+1-415-731359"

The collection of information which identifies a specific phone or FAX number as defined by telecom services.

extension
string <= 5 characters

Phone Number Extension.

phoneType
string [ 1 .. 35 ] characters

Type of phone address. Possible values are:
Mobile, Landline, Fax, Pager, Modem

phonePurpose
string [ 1 .. 35 ] characters

Purpose of the phone address. Possible values are: Business, Personal, International.

primaryIndicator
boolean (PrimaryContactIndicator)

Indicates whether the contact informacion is primary.

object (HourOfTheDay)
comment
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
object

The period of use of the phone information.

Array of objects (Email)
Array
emailAddress
string [ 1 .. 2048 ] characters

Address for electronic mail (e-mail).

emailPurpose
string [ 1 .. 35 ] characters
Example: "Statements"

Purpose of the e-mail address. Possible values: Marketing, Statements, Business, Administrative

primaryIndicator
boolean (PrimaryContactIndicator)

Indicates whether the contact informacion is primary.

jobTitle
string (JobTitle) [ 1 .. 35 ] characters
Example: "Head of Documentation"

Title of the function in an organization.

department
string [ 1 .. 35 ] characters
Example: "Sales"

Identification of a division of a large Organization or building.

Array of objects (CommunicationChannel)
Array
channel
string (CommunicationChannelName) [ 1 .. 35 ] characters
Example: "Email"

Channel used to communicate with a party. Possible Values: Email, Fax, File, Online, PostalService, LiveSupport, ATM, IVR, Kiosk, Mobile, OnlineBanking, Phone, SMS, Card, InPerson.

channelIdentification
string (CommunicationChannelIdentification) [ 1 .. 128 ] characters
Example: "011-02010020202"

Communication value such as phone number or email address.

channelPurpose
string (CommunicationChannelPurpose) [ 1 .. 40 ] characters
Example: "Alert"

Communication purpose of the channel. Possible values: Alerts, PrivacyNotices

codeWord
string

A party is asked for a codeword to verify their identity trought a communication channel

alertIndicator
any

Indicates whether the channel is used for enterprise alerts

object (CommunicationChannelHistory)
primaryIndicator
boolean (PrimaryContactIndicator)

Indicates whether the contact informacion is primary.

preferredMethod
string (CommunicationChannelName) [ 1 .. 35 ] characters
Example: "Email"

Channel used to communicate with a party. Possible Values: Email, Fax, File, Online, PostalService, LiveSupport, ATM, IVR, Kiosk, Mobile, OnlineBanking, Phone, SMS, Card, InPerson.

preferredLanguage
string (PreferredLanguage) [ 1 .. 35 ] characters
Example: "English"

Language of the contact person. Names according to the language list provided in the ISO 639-1 codes. Some possible values: Chinese, Spanish, French, English, Japanese, Italian, German.

headOfHousehold
boolean
Example: true

Indicates whether the person pay the costs of supporting a house.

civilStatus
string (CivilStatus) [ 1 .. 17 ] characters
Example: "Single"

Specifies the civil status of a person. Possible ISO 20022 compliant values names are: Single, Married, LegallyDivorced, Divorced, Widowed, StableUnion

object (StructuredName)

The structured name is used to initialize the person name with the format

firstName
required
string [ 1 .. 200 ] characters
Example: "Mary"

Person given first name.

middleName
string [ 1 .. 200 ] characters
Example: "Joe"

Person given middle name.

lastName
required
string [ 1 .. 200 ] characters
Example: "Smith"

Person surname.

suffix
string [ 1 .. 20 ] characters
Example: "PhD"

A name suffix in the Western English-Language naming tradition, follows a person's full name and provides additional information about the person. Possible Values: PhD, Snr, Jnr. Generation order should be expressed with roman numerals: I, II, III, IV, V.

prefix
string [ 1 .. 20 ] characters
Example: "Dr."

Name prefixes are typically Dr., Mr., Mrs., Ms.

gender
string (Gender) [ 1 .. 36 ] characters
Example: "Female"

Specifies the gender of the person. Possible Values: Female, Male, NonBinary

race
string (Race) [ 1 .. 35 ] characters
Example: "Director"

Categorization of humans based on shared physical qualities. Possible Values: NativeAmerican, African, Hispanic, White, Asian

profession
string (Profession) <= 35 characters
Example: "Artist"

Professional Designation or name of the occupation of a person.

jobTitle
string (JobTitle) [ 1 .. 35 ] characters
Example: "Head of Documentation"

Title of the function in an organization.

residentialStatus
string (ResidentialStatus) [ 1 .. 35 ] characters
Example: "Permanent"

Residential status of an individual. Possible values: Permanent, Resident, NonResident, Rents, Owns

minorIndicator
boolean (MinorIndicator)

Indicates whether the person is a legal minor.

Array of objects (Citizenship)
Array
fromDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period starts.

upToDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period ends.

periodNumber
integer

Sequence number of the period.

country
string (CountryCode) ^([A-Z]{2,2})?$
Example: "US"

Country name obtained from the United Nations (ISO 3166, Alpha-2 code).

countryOfResidence
string (CountryCode) ^([A-Z]{2,2})?$
Example: "US"

Country name obtained from the United Nations (ISO 3166, Alpha-2 code).

object (PersonProfile)

Information to support Know Your Customer (KYC) processes.

riskLevel
string (RiskLevel) [ 1 .. 35 ] characters
Example: "Permanent"

Specifies the customer’s money laundering risk. Possible values: High, Medium, Low, None.

bSARiskCode
integer (BSARiskCode) <= 10
Example: 0

Used to identify customers that present a risk to the bank as defined by the Bank Secrecy Act. For example, use this code to identify and monitor accounts suspected of fraud, kiting or money laundering.

object (CreditReview)

A credit review is a periodic assessment of an individual’s or businesses' credit profile.

object (Frequency)

Specifies an event frequency

lastReviewDate
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time if the last credit review.

nextReviewDate
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time if the next credit review.

creditQuality
string (CreditQuality) [ 1 .. 35 ] characters
Example: "UpperMediumGrade"

Credit quality rating of an issuer or financial obligation. Possible Values: DefaultImminent, ExtremelySpeculative, HighGrade, HighlySpeculative, InDefault, LowerMediumGrade, NonInvestmentGradeSpeculative, Prime, SubstantialRisk, UpperMediumGrade

creditScore
integer
creditBureauReportCode
string

Code used for reporting to the credit bureaus. This code is used to report the trade line of a credit account to the credit bureau agencies.

oFACReportingIndicator
boolean

Indicates whether the party is to be excluded from OFAC Reporting.

previousFinancialInstitution
string (PartyName) [ 1 .. 350 ] characters
Example: "Jane Birkin"

Name by which a party is known and which is usually used to identify that party.

referredByWhom
string [ 1 .. 350 ] characters
Example: "Jane Birkin"

Name by which a party is known and which is usually used to identify that party.

moneyLaunderingCheck
string (MoneyLaunderingCheck)
Example: "AuthorizedCredit"

Specifies the status of money laundering identification procedures. Possible Values: PassedNotChecked, ExemptBelowLimit, ClientMoneyTypeExempt, AuthorizedCredit, PostalOrElectronicPaymentExempt

knowYourCustomerCheck
string (KnowYourCustomerCheckType) [ 1 .. 36 ] characters
Example: "Ordinary"

Specifies the type of Know Your Customer (KYC) or anti-money laundering due diligence to which the investor has been subjected. Possible Values: Ordinary, Simple, Enhanced.

object (TemporalDuration)

Describes a temporal duration.

unit
required
string [ 1 .. 36 ] characters
Example: "Months"

Unit that describes the duration.

value
required
integer <= 999

Value of the duration in number of units.

dateAtCurrentAddress
string <date>
Example: "2022-04-17"

Date of Residence in the current household.

sourceOfWealth
string [ 1 .. 1025 ] characters
Example: "This is a description."

Indicates the main sources of the money.

politicalAffiliation
string

Indicates the political affiliation of the Party. Possible values could be: Democrat, Independent, Republican.

lostCustomerDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

lostCustomerReason
string (LostCustomerReason) [ 1 .. 35 ] characters
Example: "Deceased"

Used for regulatory purposes by the bank to track how long closed account history has been maintained for a customer. Possible values are: Competition, Deceased, Dissatisfied, Moved, MergedEntity, CeasedOperation

Array of objects (ServicerAlert)

Customer alerts to be received by the account servicer.

Array
alertName
string (AlertName) [ 1 .. 35 ] characters
Example: "CreditBureauAlert"

An alert notification received by the bank. Possible values: CreditBureauAlert, CustomerAlert, PaymentCard

alertType
string (AlertType) [ 1 .. 35 ] characters
Example: "Warning"

An alert notification type. Possible values: Warning, Urgent.

alertCode
string [ 1 .. 36 ] characters
message
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
lastAlertDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

object (CustomerIdentificationProgram)

CIP requires that financial firms must obtain four pieces of identifying information about a client.

certificateDocument
Array of strings (CertificateDocumentName) [ items [ 1 .. 60 ] characters ]
Example: ["IdentityCard"]

Documents used to certify the customer identity

certificationStatus
string (CertificationStatus) [ 1 .. 60 ] characters
Example: "CertifiedLevel1"

Customer Identification Program (CIP) status. Designates the type of verification used for Customer Identification. This status could be obtained from a specific software the bank is using. Possible Values: NotCertified, CertifiedLevel1, CertifiedLevel2, CertifiedLevel3, FraudCheckOnly, Level1Check, Level2FraudCheck.

certificationDate
string <date-time> (DateAndTime)
Example: "2022-04-17T08:00:00Z"
object (Frequency)

Specifies an event frequency

customerConductClassification
string (CustomerConductClassification) [ 1 .. 35 ] characters

Assessment of the customer’s behaviour at the time of the account opening application. Possible Values: Standard, NonStandard, Reluctant.

familyMedicalInsuranceIndicator
boolean
Example: true

Indicates if the person has family medical insurance coverage available.

object (AmountRange)

Range an amount

minAmount
string (PositiveAmountInCents) <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: 0

maxAmount
string (PositiveAmountInCents) <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: 0

residenceValue
string (PositiveAmountInCents) <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: 0

residenceMortage
string (PartyName) [ 1 .. 350 ] characters
Example: "Jane Birkin"

Name by which a party is known and which is usually used to identify that party.

employmentStatus
string (EmploymentStatus)

Represents available individual employment status. Possible Values: Contract, Employed, Homemaker, Retired, SelfEmployed, Student, Temporary, Unemployed.

vIPStatus
string (VIPStatus)
Example: "Elite"

Very Important People Program Status. Possible Values: Novice, Pro, Elite

Array of objects (Employment)
Array
employingPartyName
string (PartyName) [ 1 .. 350 ] characters
Example: "Jane Birkin"

Name by which a party is known and which is usually used to identify that party.

jobTitle
string (JobTitle) [ 1 .. 35 ] characters
Example: "Head of Documentation"

Title of the function in an organization.

employeeTerminationIndicator
boolean
Example: false
object (TemporalDuration)

Describes a temporal duration.

endDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

object (Place)

Town, CountrySubdivision and Country .

object (ServicerMember)

The servicer member information is used to provide info to Regulation 0. The Regulation 0 is a Federal Reserve regulation that places limits and stipulations on the credit extensions a member bank can offer to its executive officers, principal shareholders, and directors.

insider
string (InsiderType) [ 1 .. 35 ] characters
Example: "Director"

Director, Employee, Officer, PrincipalShareholder, Shareholder, Executive.

familyRelationship
string [ 1 .. 40 ] characters
Example: "PrimaryServicerOfficer"

Insider familiar relation. Child, Spouse, Parent, Relative

institutionRelationship
string [ 1 .. 40 ] characters
Example: "PrimaryServicerOfficer"

Relation with the insider financial institution. Possible Values: AffiliateFinancialInstitution, HoldingCompany.

anualIncome
string (PositiveAmountInCents) <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: 0

yearsOfEducation
integer
politicallyExposedPerson
boolean
Example: true

Indicates if the person is a politically exposed person (PEP). Is one who has been entrusted with a prominent public function. A PEP generally presents a higher risk for potential involvement in bribery and corruption.

privacyNoticedIndicator
boolean
Example: true

Indicates whether the person allow distributing personal information to third parties.

identityTheftServiceIndicator
boolean
Example: true

Indicates whether the person has subscribed to an Identity Theft service.

Array of objects (IdentityQuestion)
Array
question
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
answer
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
personId
required
string [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"

Person identifier code assigned by the account service institution.

status
string (InstructionStatus) [ 1 .. 35 ] characters
Example: "Queued"

Details about the processing of a request on party reference data (create, update, delete). Possible ISO compliant values are: Rejected, Completed, Queued.

Responses

Request samples

Content type
application/merge-patch+json
{
  • "uSDocumentedIndicator": true,
  • "identifiers": [
    ],
  • "name": "Jane Birkin",
  • "shortName": "Jane",
  • "nameTemplateId": "1",
  • "nameSoundExId": "1",
  • "partyBranchId": "SEA_1",
  • "comment": "This is a description.",
  • "relatedParties": [
    ],
  • "postalAddresses": [
    ],
  • "relationshipId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "relationshipLeadIndicator": true,
  • "residenceType": "Domestic",
  • "taxInformation": {
    },
  • "powerOfAttorney": {
    },
  • "supplementaryData": { },
  • "excludeMarketingIndicator": true,
  • "audit": {
    },
  • "restrictions": [
    ],
  • "placeAndDateOfBirth": {
    },
  • "signature": {
    },
  • "signatureVerificationId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "contact": {
    },
  • "headOfHousehold": true,
  • "civilStatus": "Single",
  • "structuredName": {
    },
  • "gender": "Female",
  • "race": "Director",
  • "profession": "Artist",
  • "jobTitle": "Head of Documentation",
  • "residentialStatus": "Permanent",
  • "minorIndicator": true,
  • "citizenships": [
    ],
  • "countryOfResidence": "US",
  • "profile": {
    },
  • "personId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "status": "Queued"
}

Response samples

Content type
application/json
{
  • "uSDocumentedIndicator": true,
  • "identifiers": [
    ],
  • "name": "Jane Birkin",
  • "shortName": "Jane",
  • "nameTemplateId": "1",
  • "nameSoundExId": "1",
  • "partyBranchId": "SEA_1",
  • "comment": "This is a description.",
  • "relatedParties": [
    ],
  • "postalAddresses": [
    ],
  • "relationshipId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "relationshipLeadIndicator": true,
  • "residenceType": "Domestic",
  • "taxInformation": {
    },
  • "powerOfAttorney": {
    },
  • "supplementaryData": { },
  • "excludeMarketingIndicator": true,
  • "audit": {
    },
  • "restrictions": [
    ],
  • "placeAndDateOfBirth": {
    },
  • "signature": {
    },
  • "signatureVerificationId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "contact": {
    },
  • "headOfHousehold": true,
  • "civilStatus": "Single",
  • "structuredName": {
    },
  • "gender": "Female",
  • "race": "Director",
  • "profession": "Artist",
  • "jobTitle": "Head of Documentation",
  • "residentialStatus": "Permanent",
  • "minorIndicator": true,
  • "citizenships": [
    ],
  • "countryOfResidence": "US",
  • "profile": {
    },
  • "personId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "status": "Queued"
}

Retrieves Person Accounts

Authorizations:
jwtopenIdConnect
path Parameters
personId
required
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Person Identification

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Responses

Response samples

Content type
application/json
{
  • "personId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "personName": "Jane Birkin",
  • "accounts": [
    ]
}

Retrieves Person Cards

Authorizations:
jwtopenIdConnect
path Parameters
personId
required
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Person Identification

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Responses

Response samples

Content type
application/json
{
  • "personId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "personName": "Jane Birkin",
  • "cards": [
    ]
}

Creates a Card

Creates a personal payment card related to one or multiple accounts. The person may be not an account owner (an additional). For debit cards, the fund account should be provided in the request.

Authorizations:
jwtopenIdConnect
path Parameters
personId
required
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Person Identification

header Parameters
idempotencyId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Idempotency identifier used by the client when making repeated calls

servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Request Body schema: application/json
fundingSourceType
string (CardFundingSourceType) [ 1 .. 35 ] characters
Example: "Credit"

Specifies the funding source type of payment card. Possible Values: Credit, Debit, Prepaid, Charge, DeferredDebit

productId
required
string (Id) [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"
styleId
string (Id) [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"
businessIndicator
boolean

Indicates whether the payment card is business or not.

digitalIndicator
boolean (DigitalCardIndicator)

Indicates whether the payment card is digital or physical.

cardBranchId
string (Id) [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"
number
string (PrimaryAccountNumber) [ 1 .. 19 ] characters
Example: "1234567890123456789"

Primary Account Number (PAN) of the card.

cardHolderType
required
string (CardHolderType) [ 1 .. 35 ] characters
Example: "Primary"

Specifies the card holder type of payment card. Possible Values: Primary, Additional

nameOnCard
string [ 1 .. 350 ] characters
Example: "Jane Birkin"

Specifies the name on the card if overriding the name from the card holder.

businessNameOnCard
string [ 1 .. 350 ] characters
Example: "Jane Birkin"

Specifies the business name on the card.

referenceAccountId
string [ 1 .. 36 ] characters
Example: "0dd926fe-1ca2-11ed-861d-0242ac120002"

Account used as a reference for the card creation. Could be a cash or loan account owned by the primary card holder.

required
Array of objects (RelatedAccount)

Account that provides the payment card transactions. The account is the funding source for the card. Could be a cash or loan account linked to the debit card or a credit card account. A card can have one or many accounts.

Array
accountRelationType
required
string (AccountRelationType)
Example: "Child"

Account relation role. Possible values are: Parent, Child, Group.

accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: "0dd926fe-1ca2-11ed-861d-0242ac120002"

Identification assigned by the account service institution (Servicer).

accountNumber
string (AccountNumber) <= 30 characters
Example: "012345678"

The account number or Basic Bank Account Number (BBAN). A Basic Bank Account Number (BBAN) is a bank account number that includes the domestic bank code, branch identifier, and account number. It is a unique identifier for a bank account within a specific country.

accountType
required
string (RelatedAccountType) [ 1 .. 35 ] characters
Example: "Checking"

Type of the account. Some possible ISO 20022 compliant values are: Checking, CardAccount, CashPayment, Charges, CashIncome, Commission, ClearingParticipantSettlementAccount, LimitedLiquiditySavingsAccount, MarginalLending, MoneyMarket, NonResidentExternal, Overdraft, OverNightDeposit, Settlement, Salary, Savings, Tax, TransactingAccount, CashTrading, VirtualAccount, CreditCard, DebitCard, Universal, Investment, EpurseCard, CertificateOfDeposit, MoneyMarketChecking, RetirementAccount, StockOrBond, PrePaid, FleetCard, Cash, DebitAccount, CreditAccount, Benefit, HealthSavingsAccount, FlexibleSpendingAccount, ForBenefitOf, Estate, ClientTrustAccount, LawyersTrustAccount, KeoghPlanAccount, UniformTransfersToMinorsAct, UniformGiftsToMinorsAct, ReserveFunds, SelfDirectedBrokerage, Loan, Ledger.

name
string (AccountName) [ 1 .. 70 ] characters
Example: "Hermes PD_CA 0002"

Name of the account. It provides an additional means of identification, and is designated by the account servicer in agreement with the account owner.

startDate
string <date>
Example: "2022-04-17"

Year and month the card is available for use.

expiryDate
string <= 7 characters ^\d{4}-([0]\d|1[0-2])$
Example: "2022-12"

Year and month the card expires.

orderedDate
string <date>
Example: "2022-04-17"

Date the card is ordered

securityCode
string <= 35 characters
Example: "103"

Security code written on the card, sometimes called card security code (CSC).

pIN
string <= 35 characters
Example: "1031"

PIN is the 4 digit security code that is used to authenticate the user and allow them access to the associated accounts of the card.

pINRetries
number <= 99
Example: 3

Pin Retries Allowed

sequenceNumber
string <= 20 characters
Example: "1"

Identifies a card inside a set of cards with the same number (or PAN).

brand
string <= 35 characters
Example: "Visa"

Brand name of the card.

Array of objects (Limit)
Array
name
required
string [ 1 .. 60 ] characters
Example: "creditLimit"

Name of the limit in PascalCase. Possible values: Overdraft, CreditLimit, CreditCard, Withdraw, CreditCardWithdraw, ForeignFeesWaived, CreditTransactions, DebitTransactions

limitTypeCode
string (LimitType) <= 35 characters
Example: "DirectDebit"

Specifies the type of risk management limit. Possible ISO 20020 compliant values are: Bilateral, NetBilateral, IndirectBilateral, Global, MandatoryBilateral, DiscretionaryBilateral, DirectDebit, SingleCustomerDirectDebit, SingleFinancialInstitutionDirectDebit, TotalDailyCustomerDirectDebit, TotalDailyFinancialInstitutionDirectDebit, AutoCollateralisation, UnsecuredCredit, ExternalGuarantee

channelType
string [ 1 .. 30 ] characters

Channel type for which this limit applies. Possible values: OnlineATM, OfflineATM, ATM, SaleTerminal

amount
string <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Amount limit

number
integer

Number limit.

percentage
string (Percentage) <= 23 characters ^100|(([1-9][0-9]{0,1})([.][0-9]{0,8}){0,1})$...
Example: "25"

Value expressed as a percentage, rate expressed as a percentage, that is, in hundredths, for example, 0.7 is 7/10 of a percent, and 7.0 is 7%. total number of digits: 11 number of digits in fractional part: 10 Max Value: 100

object (Period)
object (Frequency)

Specifies an event frequency

usedAmount
string <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Amount limit used

usedNumber
integer

Number limit used.

usedPercentage
string (Percentage) <= 23 characters ^100|(([1-9][0-9]{0,1})([.][0-9]{0,8}){0,1})$...
Example: "25"

Value expressed as a percentage, rate expressed as a percentage, that is, in hundredths, for example, 0.7 is 7/10 of a percent, and 7.0 is 7%. total number of digits: 11 number of digits in fractional part: 10 Max Value: 100

status
string (LimitStatus) <= 35 characters
Example: "Requested"

Specifies the current status of a limit. Possible ISO 20020 compliant values are: Enabled, Disabled, Deleted, Requested

object (Frequency)

Specifies an event frequency

Array of objects (InterestCalculation)
Array
name
string (InterestName) [ 1 .. 35 ] characters
Example: "Deposit"

Name of the interest that applies to the account. For instance, Deposit.

code
string <= 50 characters

Interest code used by the account servicer.

dayCountBasis
string (InterestComputationMethod) [ 1 .. 50 ] characters
Example: "30360AmericanBasicRule"

Specifies the method used to compute accruing interest of a financial instrument. Possible Values: 30360AmericanBasicRule, IC30365, IC30Actual, Actual360, Actual365Fixed, ActualActualICMA, IC30E360orEuroBondBasismodel1, ActualActualISDA, Actual365LorActuActubasisRule, ActualActualAFB, IC30360ICMAor30360basicrule, IC30E2360orEurobondbasismodel2, IC30E3360orEurobondbasismodel3, Actual365NL, Narrative, ActualActualUltimo, IC30EPlus360, Actual364, Business252, Actual360NL, OneOne. DateDeposit365365, DateDeposit365360, LastInterest365365, LastInterest365360, EqualPayments365365, EqualPayments365360

accruedDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

nextInterestDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

rate
string <= 23 characters ^100|(([1-9][0-9]{0,1})([.][0-9]{0,8}){0,1})$...
Example: "25"

The actual interest rate.

object

The period funds are earning interest.

rateType
string (InterestRateType) [ 1 .. 35 ] characters
Example: "Fixed"

Specifies the type of interest rate. Some ISO 20022 compliant values are: Fixed, Forfeit, Variable, StepUp, Scheduled, Unscheduled, Discount, FixedRateUnderlyingExposureForLife, FixedRateUnderlyingExposureWithCompulsoryFutureSwitchToFloating, FixedWithFuturePeriodicResets, FloatingLinkedToIndex, FloatingRateUnderlyingExposureForLife, FloatingRateUnderlyingExposureWithCap, FloatingRateUnderlyingExposureWithFloor, FloatingRateUnderlyingExposureWithFloorAndCap, Modular, ObligorSwapped, SwicthOptionality

compoundingMethod
string (InterestCompoundingMethod) [ 1 .. 35 ] characters
Example: "Deposit"

Inteterst compounding method: Possible Values: Simple, Daily, Continuous.

object (Frequency)

Specifies an event frequency

object (VariableInterestCalculation)

Specifies the parameters to be used for variable interest.

dateNextInterest
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

oneDayInterest
string (PositiveAmountInCents) <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: 0

object (InterestPayment)

Set of attributes related to the interest payment.

Array of objects (Balance)

Total amounts related to an interest

object (InterestDetails)

Set of attributes related to the interest calculus.

object (InterestRenewalDetails)

Detailed interest attributes related to rate change and account maturity.

object (InterestDetails)

Set of attributes related to the interest calculus.

object (InterestCycle)

Set of parameters used to calculate an interest cycle.

lastCalculus
string (PositiveAmountInCents) <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: 0

Array of objects (Restriction)
Array
name
required
string [ 1 .. 60 ] characters
Example: "WireTransferIn"

Name of the restriction in PascalCase. Possible values: WireTransferIn, WireTransferOut, ForeignIncomingWires, ForeignOutgoingWires, ACHTransfers, InternetBankingTransfer, InternetView, InternetInquiry, ForeignOutgoingIran, Withdrawals, Renew, Transfers

restrictionPurpose
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
enableIndicator
boolean
Example: true

Indicates whether the capability is allowed or not.

validFrom
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

validUntil
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

Array of objects (ChargeCalculation)
Array
fromDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period starts.

upToDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period ends.

periodNumber
integer

Sequence number of the period.

name
string (ChargeName) [ 1 .. 60 ] characters
Example: "CardLatePayment"

Name of the charge calculation in PascalCase. Possible values: Overdraft, CardLatePayment, CashAdvance, LatePayment, CashWithdrawal, EarlyWithdrawal

amount
string <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Amount charged for the service.

rate
string <= 23 characters ^100|(([1-9][0-9]{0,1})([.][0-9]{0,8}){0,1})$...
Example: "25"

Rate applied on a basis amount to calculate the service charge.

chargeType
string (ChargeType) [ 1 .. 35 ] characters
Example: "ManagementFee"

Type of service for which a charge is asked or paid. Some possible ISO 20022 compliant values are: BrokerageFee, Commission, BackEndLoad, FrontEndLoad, Switch, DilutionLevy, Discount, ManagementFee, TransferFee, MatchingFees, PostageCharge, RegulatoryFee, ShippingCharge, ServiceProvisionFee, SpecialConcessions, PartAcquis, Penalty, ContingencyDeferredSalesCharge, Equalisation, CorrespondentBankCharge, Premium, Initial, AdvisoryFee, CustodyFee, PublicationFee, AccountingFee, SignatureService, StorageAtDestination, StorageAtOrigin, Packaging, PickUp, DangerousGoodsFee, SecurityCharge, InsurancePremium, CollectFreight, ClearanceAndHandlingAtOrigin, ClearanceAndHandlingAtDestination, AirWayBillFee, TransportCharges, UCITSCommission, SpeciallyAgreedFrontEndLoad, ADRFee, IssuanceCancellationFee, MiscellaneousFee, IssuanceFee.

calculationMethodCode
string [ 1 .. 60 ] characters

Servicer charge calculation code

calculationBasis
string (CalculationBasis) [ 1 .. 35 ] characters
Example: "Monthly"

Specifies the calculation basis of a charge or fee. Some possible ISO 20022 compliant values are: Average, Daily, Monthly, Annual, FullTerm, RemainingTerm

bearerType
string (ChargeBearerType) [ 1 .. 35 ] characters
Example: "Shared"

Specifies which party(ies) will pay charges due for processing of the instruction. BorneByDebtor, BorneByCreditor, Shared, FollowingServiceLevel

maximumAmount
string <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Maximum amount of money asked or paid for the charge.

object (InterestCalculation)

Set of parameters used to calculate an interest.

debitIndicator
boolean

Indicates whether the charge is automatically debited from the defined account.

accountToCharge
string (AccountId) [ 1 .. 36 ] characters
Example: "0dd926fe-1ca2-11ed-861d-0242ac120002"

Identification assigned by the account service institution (Servicer).

object (Frequency)

Specifies an event frequency

Array of objects (TotalAmount)

Total amounts related to a charge

Array of objects (Algorithm)
Array
name
string [ 1 .. 35 ] characters

Name to describe the algorithm provided. Possible Values: ICSF

target
string [ 1 .. 35 ] characters

Attribute name of the algorithm. Possible Values: pIN

enableIndicator
boolean

Indicates whether the offset has been calculated.

offset
string [ 1 .. 60 ] characters

An attribute offset is a value that is the difference between two attributes. For example, a PIN offset may be the difference between a PIN that is chosen by the customer and one that is assigned by an institution.

supplementaryData
object (SupplementaryData)

Additional information that cannot be captured in the structured elements and/or any other specific block. If this information need to be converted in ISO Messages, must be ISO 20022 compliant: it requires development of a compliant message extension model and its components must be registered in the ISO 20022 Data Dictionary. https://www.iso20022.org/catalogue-messages/additional-content-messages/supplementary-data

Responses

Request samples

Content type
application/json
{
  • "fundingSourceType": "Credit",
  • "productId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "styleId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "businessIndicator": true,
  • "digitalIndicator": true,
  • "cardBranchId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "number": "1234567890123456789",
  • "cardHolderType": "Primary",
  • "nameOnCard": "Jane Birkin",
  • "businessNameOnCard": "Jane Birkin",
  • "referenceAccountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "relatedAccounts": [
    ],
  • "startDate": "2022-04-17",
  • "expiryDate": "2022-12",
  • "orderedDate": "2022-04-17",
  • "securityCode": "103",
  • "pIN": "1031",
  • "pINRetries": 3,
  • "sequenceNumber": "1",
  • "brand": "Visa",
  • "limits": [
    ],
  • "interests": [
    ],
  • "restrictions": [
    ],
  • "charges": [
    ],
  • "algorithms": [
    ],
  • "supplementaryData": { }
}

Response samples

Content type
application/json
{
  • "fundingSourceType": "Credit",
  • "productId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "styleId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "businessIndicator": true,
  • "digitalIndicator": true,
  • "cardBranchId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "number": "1234567890123456789",
  • "cardHolderType": "Primary",
  • "nameOnCard": "Jane Birkin",
  • "businessNameOnCard": "Jane Birkin",
  • "referenceAccountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "relatedAccounts": [
    ],
  • "startDate": "2022-04-17",
  • "expiryDate": "2022-12",
  • "orderedDate": "2022-04-17",
  • "securityCode": "103",
  • "pIN": "1031",
  • "pINRetries": 3,
  • "sequenceNumber": "1",
  • "brand": "Visa",
  • "limits": [
    ],
  • "interests": [
    ],
  • "restrictions": [
    ],
  • "charges": [
    ],
  • "algorithms": [
    ],
  • "supplementaryData": { },
  • "cardId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "cardHolderId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "statement": {
    },
  • "offers": [
    ],
  • "status": "Active",
  • "statusDate": "2022-04-17T08:00:00Z",
  • "statusReason": "This is a description.",
  • "history": {
    },
  • "servicerAlerts": [
    ]
}

Retrieves a list of organizations matching the parameters.

Authorizations:
jwtopenIdConnect
query Parameters
name.inc
string

The organization name includes the substring provided.

accountNumber.eq
string (AccountNumber) <= 30 characters
Example: accountNumber.eq=012345678

The organization owns an account with the number.

tin.eq
string
email.eq
string

Email equals to

addressLine.inc
string

Any address line of any postal address includes substring

postCode.eq
string

Any postal address with post code equals to

country.eq
string

Any postal address with country code equals to

countrySubDivision.inc
string

Any postal address with country subdivision includes substring

townName.inc
string

Any postal address with town name includes substring

organizationId.eq
string (Id) [ 1 .. 36 ] characters
Example: organizationId.eq=5fb9d4d6-1a3c-11ed-861d-0242ac120002

System id equals to

audit.lastModificationDate.lte
string <date> (Date)
Example: audit.lastModificationDate.lte=2022-04-17

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

audit.lastModificationDate.gte
string <date> (Date)
Example: audit.lastModificationDate.gte=2022-04-17

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Creates an Organization

Authorizations:
jwtopenIdConnect
header Parameters
idempotencyId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Idempotency identifier used by the client when making repeated calls

servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Request Body schema: application/json
Array of objects (OrganizationIdentification)
Array
number
required
string [ 1 .. 35 ] characters
Example: "123-45-6789"

Unique and unambiguous identification of an organization.

schemeName
required
string [ 1 .. 35 ] characters
Example: "TaxIdentificationNumber"

Name of the identification scheme, in PascalCase form. Possible ISO compliant values are: BankPartyIdentification CentralBankIdentificationNumber ClearingIdentificationNumber CertificateOfIncorporationNumber CountryIdentificationCode CustomerNumber DataUniversalNumberingSystem EmployerIdentificationNumber GS1GLNIdentifier SIREN SIRET TaxIdentificationNumber BusinessDomainIdentifier BusinessOtherIdentification EmployerIdentificationNumber BICIdentifier LEIIdentifier

issuer
string
Example: "UnitedStates"

Entity that assigns the identification.

issueDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

expirationDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

name
string (PartyName) [ 1 .. 350 ] characters
Example: "Jane Birkin"

Name by which a party is known and which is usually used to identify that party.

shortName
string (PartyShortName) [ 1 .. 35 ] characters
Example: "Jane"

Short name or nickname by which a party is known and which is usually used to identify that party.

nameTemplateId
string (NameTemplateId) [ 1 .. 36 ] characters
Example: "1"

Template used to display the party name. This is an external id provided by the account servicer.

nameSoundExId
string (SoundExId) [ 1 .. 36 ] characters
Example: "1"

Identification of a SoundEx method develop for search attribute. SoundEx is a method used to find strings when the sound is known but the precise spelling is not. It searches out words with similar sounds based on phonetic assumptions about how certain letters are pronounced. It can be used to search names in a database, for example, where spellings and pronunciations for similar names may vary.

partyBranchId
string (ServicerBranchId) [ 1 .. 36 ] characters
Example: "SEA_1"

Identification of the account servicer institution at branch level or operation level.

comment
string [ 1 .. 1025 ] characters
Example: "This is a description."

Bank commnent of the party.

Array of objects (RelatedParty)
Array
partyId
required
string (Id) [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"
partyType
required
string (PartyType)
Example: "Person"

Possible values are: Person, Organization. Also other types of servicer internal entities: ServicerOfficer

partyName
string (PartyName) [ 1 .. 350 ] characters
Example: "Jane Birkin"

Name by which a party is known and which is usually used to identify that party.

partyRelationType
required
string (PartyRelationType) [ 1 .. 40 ] characters
Example: "PrimaryServicerOfficer"

Type of relation between parties. Possible values Between Organizations and persons are: ResponsibleParty, OrganizationOwner, ControlPerson, BeneficialOwner, PrimaryContact, SecondaryContact. For Trusts: Trustor, Trustee. Between organizations: ParentOrganization, Branch. Between parties and external entities: AccountOpenningOfficer, CustomerServiceOfficer, PrimaryServicerOfficer, SecondaryServicerOfficer, SalesPerson, ReferralOfficer. Between financial institutions: AffiliateFinancialInstitution, HoldingCompany. Between persons: Spouse.

partyRelationDescription
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
ownershipPercentage
string <= 23 characters ^100|(([1-9][0-9]{0,1})([.][0-9]{0,8}){0,1})$...
Example: "25"

Company Ownership Percentage. If the relation Type is BeneficialOwner the ownership percentage could be added. Ownership means any person with more than 25% equity in the legal entity.

Array of objects (PostalAddress)
Array
addressType
string
Example: "Postal"

Specifies the type of address, in PascalCase form. Possible ISO Compliant values are: PhysicalAddress, Postal, POBox, Residential, Permanent, Temporary, Business.

addressPurpose
string
Example: "Billing"

Specifies the purpose of an address, in PascalCase form. Possible ISO Compliant values are: MailTo, DeliveryTo, Billing, PlaceOfOperation, PlaceOfRegistration

primaryIndicator
boolean (PrimaryContactIndicator)

Indicates whether the contact informacion is primary.

department
string [ 1 .. 70 ] characters
Example: "A"

Identification of a division of a large Organization or building.

subDepartment
string [ 1 .. 70 ] characters
Example: "B"

Identification of a sub-division of a large Organization or building.

streetName
string [ 1 .. 70 ] characters
Example: "First Street"

Name of a street or thoroughfare.

firstCrossStreetName
string [ 1 .. 70 ] characters

Name of a the first cross street.

secondCrossStreetName
string [ 1 .. 70 ] characters
Example: "Second Street"

Name of a the second cross street.

buildingNumber
string [ 1 .. 16 ] characters
Example: "11407"

Number that identifies the position of a building or house on a street.

buildingName
string [ 1 .. 35 ] characters
Example: "Tall Tower"

Name of the building or house.

floor
string [ 1 .. 70 ] characters
Example: "20"

Floor or storey within a building.

postBox
string [ 1 .. 16 ] characters
Example: "MY779"

Numbered box in a post office, assigned to a person or Organization, where letters are kept until called for.

room
string [ 1 .. 70 ] characters
Example: "22"

Building room number.

postCode
string (PostCode) [ 1 .. 16 ] characters
Example: "97062-68"

Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.

censusTrack
string (CensusTrack) = 5 characters
Example: "04013216813"

A census tract, census area, census district or meshblock is a geographic region defined for the purpose of taking a census

cBSACode
string (CBSACode) = 5 characters
Example: "49780"

Core-based statistical area. Metropolitan statistical area (MSA) is the formal definition of a region that consists of a city and surrounding communities that are linked by social and economic factors. Micropolitan Statistical Areas (MISA) are CBSAs associated with at least one urban cluster that has a population of at least 10,000, but less than 50,000. The micropolitan statistical area comprises the central county or counties or equivalent entities containing the core, plus adjacent outlying counties having a high degree of social and economic integration with the central county as measured through commuting.

cBSAType
string (CBSAType) [ 1 .. 10 ] characters
Example: "MSA"

Type of Core-based statistical area. Possible values: MSA, MISA

foreignIndicator
boolean

Indicates whether the postal address is from a foreing country.

townName
string (TownName) [ 1 .. 35 ] characters
Example: "Tualatin"

Name of a built-up area, with defined boundaries, and a local government.

townLocationName
string [ 1 .. 35 ] characters
Example: "Clackamas"

Specific location name within the town.

districtName
string [ 1 .. 35 ] characters
Example: "Washington"

Identifies a subdivision within a country sub-division.

countrySubDivision
string (CountrySubdivision) [ 1 .. 35 ] characters
Example: "Oregon"

Name of a country subdivision such as state, region, county.

countrySubDivisionCode
string (CountrySubdivisionCode) ^[A-Z]{2,2}\-[0-9A-Z]{1,3}
Example: "AR-B"

Code to identify a name of a unit resulting from the division of a country, dependency, or other area of special geopolitical interest contained in ISO 3166-1, on the basis of country names obtained from the United Nations (ISO 3166-2: Country subdivision code).

country
string (CountryCode) ^([A-Z]{2,2})?$
Example: "US"

Country name obtained from the United Nations (ISO 3166, Alpha-2 code).

addressLine
Array of strings[ items [ 1 .. 70 ] characters ]
Example: ["11407 Sw Amu st, Suite MY777"]

Information that locates and identifies a specific address, as defined by postal services, presented in free format text.

object

The period of use of the address information.

relationshipId
string [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"

This id gives the ability to view a party’s total relationship with the bank. The relationship Id ties multiple parties together. This code is also used to reduce mailing costs during marketing campaigns to avoid sending duplicate materials to parties residing at the same address.

relationshipLeadIndicator
boolean

The relationship lead is often the primary account owner or the party with whom the bank have the most contact.

residenceType
string [ 1 .. 35 ] characters
Example: "Domestic"

Specifies the type of residence where the party has its permanent home or principal establishment. Possible ISO Complaian values are: Domestic, Foreign, Mixed

object (TaxPartyInformation)

Taxation parameters which apply to an individual person or to an organization.

tIN
string
Example: "778-62-8144"

A Taxpayer Identification Number

taxIdType
string [ 1 .. 50 ] characters
Example: "SocialSecurityNumber"

Identifies what type of tax ID is in the TIN field. Possible Values: SocialSecurityNumber, EmployerIdentificationNumber, IndividualTaxpayerIdentificationNumber, AdoptionTaxpayerIdentificationNumber, PreparerTaxpayerIdentificationNumber, ForeignTaxID

financialReportingIndicator
boolean

Whether the financial income for this party should be reported to the U.S. government (IRS) when related to an account in a way which requires reporting (for example, primary, joint ownership). Defaults to true if not specified.

tINStatus
string
Example: "Valid"

'The tax ID has been verified by the IRS. Possible values: Valid, NotValid, NotVerified, IRSWarning, TINApplied.

object (TINVerification)

IRS information about the TIN provided.

verificationAttemps
integer <= 10
Example: 1

The Tax Identification Verification Attempts is the number of times attempts have been made to verify the tax ID number.

bNoticeDates
Array of strings <date> (Date)
Example: ["2022-04-17"]
tINResultCode
string <= 3

TIN matching result codes

taxStatus
string
Example: "Valid"

Exempt, Retain, ExemptExpired, VoluntaryWithholding, Chapter3, Chapter4, C-Corp, S-Corp.

Array of objects (TaxForm)

Forms applied by the party

Array
formName
required
string [ 1 .. 10 ] characters
Example: "W-8"

Form name requested. Possible Values: W-8BEN, W-8BEN-E, W-8ECI, W-8EXP, W-8IMY, W-9, W-8, 1042-S, 1099-INT, 1099-OID.

taxRate
string <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Indicates the tax rate provided by the IRS on the form.

Array of objects (TaxFormCode)

Codes provided by the IRS on the form.

recipientGIIN
string (GIIN) [ 1 .. 34 ] characters ^([A-N,P-Z,0-9]){6}\.([A-N,P-Z,0-9]){5}\.(LE|...
Example: "ADN123.FG4FE3.LE.999"

Global intermediary identification number (GIIN).

recipientPostCode
string (PostCode) [ 1 .. 16 ] characters
Example: "97062-68"

Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.

recipientTownName
string (TownName) [ 1 .. 35 ] characters
Example: "Tualatin"

Name of a built-up area, with defined boundaries, and a local government.

certificationDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

expirationDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

Array of objects (TaxRegulation)
Array
name
required
string [ 1 .. 35 ] characters
Example: "Chapter4"
section
string [ 1 .. 10 ] characters
Example: "1471"

String that represent the section number.

Array of objects (WithholdingTax)
Array
withholdingTaxType
required
string (WithholdingTaxType) [ 1 .. 35 ] characters
Example: "NonResidentAlienTax"

Type of Withholding. Possible Values: ForeignAccountTaxComplianceAct, NonResidentAlienTax, BackUpWithholding, VoluntaryWithholding, Federal, State, Local, W-4.

withholdingRate
string <= 23 characters ^100|(([1-9][0-9]{0,1})([.][0-9]{0,8}){0,1})$...
Example: "25"

Rate applied on a basis amount to calculate the withholding.

withholdingAmount
string <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Withholding amount.

foreignIndicator
boolean

Indicates whether the party is a non-residen alien or a foreign entity.

countrySubDivision
string (CountrySubdivision) [ 1 .. 35 ] characters
Example: "Oregon"

Name of a country subdivision such as state, region, county.

countrySubDivisionCode
string (CountrySubdivisionCode) ^[A-Z]{2,2}\-[0-9A-Z]{1,3}
Example: "AR-B"

Code to identify a name of a unit resulting from the division of a country, dependency, or other area of special geopolitical interest contained in ISO 3166-1, on the basis of country names obtained from the United Nations (ISO 3166-2: Country subdivision code).

country
string (CountryCode) ^([A-Z]{2,2})?$
Example: "US"

Country name obtained from the United Nations (ISO 3166, Alpha-2 code).

supplementaryData
object (SupplementaryData)

Additional information that cannot be captured in the structured elements and/or any other specific block. If this information need to be converted in ISO Messages, must be ISO 20022 compliant: it requires development of a compliant message extension model and its components must be registered in the ISO 20022 Data Dictionary. https://www.iso20022.org/catalogue-messages/additional-content-messages/supplementary-data

object (PowerOfAttorney)

Document that transfers specific rights from a party to a person.

documentId
string (Id) [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"
documentReference
string [ 1 .. 35 ] characters

Document location.

version
string [ 1 .. 18 ] characters

Document version indentification.

signOffDate
string <date>
Example: "2022-04-17"

Signoff date of the document.

issueDate
string <date>
Example: "2022-04-17"

Issue date of the document.

purpose
string [ 1 .. 35 ] characters

Specifies the function of the document.

fromDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period starts.

upToDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period ends.

periodNumber
integer

Sequence number of the period.

object (Jurisdiction)

Area with a set of laws under the control of a system which are different from neighbouring areas

countrySubdivision
string (CountrySubdivision) [ 1 .. 35 ] characters
Example: "Oregon"

Name of a country subdivision such as state, region, county.

townName
string (TownName) [ 1 .. 35 ] characters
Example: "Tualatin"

Name of a built-up area, with defined boundaries, and a local government.

country
string (CountryCode) ^([A-Z]{2,2})?$
Example: "US"

Country name obtained from the United Nations (ISO 3166, Alpha-2 code).

authorizedPerson
string [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"

Person which is the holder of the power of attorney.

authorizedAccount
string [ 1 .. 36 ] characters
Example: "0dd926fe-1ca2-11ed-861d-0242ac120002"

Specifies the account on which the power of attorney applies.

supplementaryData
object (SupplementaryData)

Additional information that cannot be captured in the structured elements and/or any other specific block. If this information need to be converted in ISO Messages, must be ISO 20022 compliant: it requires development of a compliant message extension model and its components must be registered in the ISO 20022 Data Dictionary. https://www.iso20022.org/catalogue-messages/additional-content-messages/supplementary-data

excludeMarketingIndicator
boolean
object (Audit)

Resource Audit Information. Captures the creation, modification and maintenance details.

status
string (AuditStatus) [ 1 .. 35 ] characters

Maintenance status of a resource. Possible values: Requested, Created, Changed, Deleted

creationDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

lastModificacionChannel
string (CommunicationChannelName) [ 1 .. 35 ] characters
Example: "Email"

Channel used to communicate with a party. Possible Values: Email, Fax, File, Online, PostalService, LiveSupport, ATM, IVR, Kiosk, Mobile, OnlineBanking, Phone, SMS, Card, InPerson.

lastModificationDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

Array of objects (AuditChannel)

Activity audit throught comunication channles

Array
lastActivityDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

name
string (CommunicationChannelName) [ 1 .. 35 ] characters
Example: "Email"

Channel used to communicate with a party. Possible Values: Email, Fax, File, Online, PostalService, LiveSupport, ATM, IVR, Kiosk, Mobile, OnlineBanking, Phone, SMS, Card, InPerson.

activityType
string (AuditActivityType) [ 1 .. 35 ] characters

Maintenance activity of a resource. Possible values: Transaction, Modification, Deposit, Withdrawal.

amount
string (PositiveAmountInCents) <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: 0

Array of objects (Restriction)

Access and operation restrictions at Party level.

Array
name
required
string [ 1 .. 60 ] characters
Example: "WireTransferIn"

Name of the restriction in PascalCase. Possible values: WireTransferIn, WireTransferOut, ForeignIncomingWires, ForeignOutgoingWires, ACHTransfers, InternetBankingTransfer, InternetView, InternetInquiry, ForeignOutgoingIran, Withdrawals, Renew, Transfers

restrictionPurpose
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
enableIndicator
boolean
Example: true

Indicates whether the capability is allowed or not.

validFrom
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

validUntil
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

organizationType
required
string (OrganizationType)
Example: "Corporation"

Specifies the legal standing of the organization. Possible values are: Government, FinancialInstitution SoleProprietorship, UnincorporatedAssociation, LimitedLiabilityPartnership, LimitedLiabilityCompany, LimitedPartnership, FormalPartnership, GeneralPartnership, Business, Corporation, NotForProfit, ForProfit, NonProfit, Club, Supranational, Sovereign, Municipal, Province, State, County, National, ExemptionTrust, LivingTrust, EmployeeTrust, RevocableTrust, IrrovocableTrust, NakedTrust, FamilyTrust, BussinesTrust, CliffordTrust, FormalTrust.

organizationPurpose
string [ 1 .. 1025 ] characters
Example: "This is a description."

Description and purpose of an organization.

legalName
string [ 1 .. 35 ] characters
Example: "Jane"

Official name under which an organization is registered.

tradingName
string [ 1 .. 35 ] characters
Example: "Jane"

Name used by a business for commercial purposes, although its registered legal name, used for contracts and other formal situations, may be another.

registrationDate
string <date>
Example: "2022-04-17"

Date and time at which a given organization was officially registered.

establishmentDate
string <date>
Example: "2022-04-17"

Date when the Organization was established.

merchantCategory
string (MerchantCategoryCode) ^[0-9]{4,4}
Example: "482"

Category code conform to ISO 18245, related to the type of services or goods the merchant provides for the transaction.

nAICSCode
string (NAICSCode) ^[0-9]{2,2}
Example: "54"

The North American Industry Classification System (NAICS) is the standard used by Federal statistical agencies in classifying business establishments for the purpose of collecting, analyzing, and publishing statistical data related to the U.S. business economy.

sector
string (OrganizationSector)

A sector is an area of the economy in which businesses share the same or related business activity, product, or service. Energy, Materials, Industrials, ConsumerDiscretionary, ConsumerStaples, HealthCare, Financials, InformationTechnology, TelecommunicationServices, Utilities, RealEstate.

object (OrganizationProfile)

Information to support Know Your Customer (KYC) processes.

riskLevel
string (RiskLevel) [ 1 .. 35 ] characters
Example: "Permanent"

Specifies the customer’s money laundering risk. Possible values: High, Medium, Low, None.

bSARiskCode
integer (BSARiskCode) <= 10
Example: 0

Used to identify customers that present a risk to the bank as defined by the Bank Secrecy Act. For example, use this code to identify and monitor accounts suspected of fraud, kiting or money laundering.

object (CreditReview)

A credit review is a periodic assessment of an individual’s or businesses' credit profile.

object (Frequency)

Specifies an event frequency

lastReviewDate
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time if the last credit review.

nextReviewDate
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time if the next credit review.

creditQuality
string (CreditQuality) [ 1 .. 35 ] characters
Example: "UpperMediumGrade"

Credit quality rating of an issuer or financial obligation. Possible Values: DefaultImminent, ExtremelySpeculative, HighGrade, HighlySpeculative, InDefault, LowerMediumGrade, NonInvestmentGradeSpeculative, Prime, SubstantialRisk, UpperMediumGrade

creditScore
integer
creditBureauReportCode
string

Code used for reporting to the credit bureaus. This code is used to report the trade line of a credit account to the credit bureau agencies.

oFACReportingIndicator
boolean

Indicates whether the party is to be excluded from OFAC Reporting.

previousFinancialInstitution
string (PartyName) [ 1 .. 350 ] characters
Example: "Jane Birkin"

Name by which a party is known and which is usually used to identify that party.

referredByWhom
string (PartyName) [ 1 .. 350 ] characters
Example: "Jane Birkin"

Name by which a party is known and which is usually used to identify that party.

moneyLaunderingCheck
string (MoneyLaunderingCheck)
Example: "AuthorizedCredit"

Specifies the status of money laundering identification procedures. Possible Values: PassedNotChecked, ExemptBelowLimit, ClientMoneyTypeExempt, AuthorizedCredit, PostalOrElectronicPaymentExempt

knowYourCustomerCheck
string (KnowYourCustomerCheckType) [ 1 .. 36 ] characters
Example: "Ordinary"

Specifies the type of Know Your Customer (KYC) or anti-money laundering due diligence to which the investor has been subjected. Possible Values: Ordinary, Simple, Enhanced.

object (TemporalDuration)

Describes a temporal duration.

unit
required
string [ 1 .. 36 ] characters
Example: "Months"

Unit that describes the duration.

value
required
integer <= 999

Value of the duration in number of units.

dateAtCurrentAddress
string <date>
Example: "2022-04-17"

Date of Residence in the current household.

sourceOfWealth
string [ 1 .. 1025 ] characters
Example: "This is a description."

Indicates the main sources of the money.

politicalAffiliation
string

Indicates the political affiliation of the Party. Possible values could be: Democrat, Independent, Republican.

lostCustomerDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

lostCustomerReason
string (LostCustomerReason) [ 1 .. 35 ] characters
Example: "Deceased"

Used for regulatory purposes by the bank to track how long closed account history has been maintained for a customer. Possible values are: Competition, Deceased, Dissatisfied, Moved, MergedEntity, CeasedOperation

Array of objects (ServicerAlert)

Customer alerts to be received by the account servicer.

Array
alertName
string (AlertName) [ 1 .. 35 ] characters
Example: "CreditBureauAlert"

An alert notification received by the bank. Possible values: CreditBureauAlert, CustomerAlert, PaymentCard

alertType
string (AlertType) [ 1 .. 35 ] characters
Example: "Warning"

An alert notification type. Possible values: Warning, Urgent.

alertCode
string [ 1 .. 36 ] characters
message
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
lastAlertDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

legalEntityReportingIndicator
boolean

Indicates whether the party is required to be reported as a legal entity.

numberOfEmployees
integer
Example: 100

Number of employees of the corporation.

anualSales
string (AmountInCents) <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: -9999999999999.99999999

services
string [ 1 .. 1025 ] characters
Example: "This is a description."

Description of the services that are offered for sale.

goods
string [ 1 .. 1025 ] characters
Example: "This is a description."

Description of the goods that are offered for sale.

Array of objects (Place)

Places where the goods and services are sold.

Array
countrySubdivision
string (CountrySubdivision) [ 1 .. 35 ] characters
Example: "Oregon"

Name of a country subdivision such as state, region, county.

townName
string (TownName) [ 1 .. 35 ] characters
Example: "Tualatin"

Name of a built-up area, with defined boundaries, and a local government.

country
string (CountryCode) ^([A-Z]{2,2})?$
Example: "US"

Country name obtained from the United Nations (ISO 3166, Alpha-2 code).

object

Business e-mails and phone numbers. Configuration of communication channels at organization level.

Array of objects (Phone)
Array
number
required
string (PhoneNumber) ^\+[0-9]{1,3}-[0-9()+\-]{1,30}$
Example: "+1-415-731359"

The collection of information which identifies a specific phone or FAX number as defined by telecom services.

extension
string <= 5 characters

Phone Number Extension.

phoneType
string [ 1 .. 35 ] characters

Type of phone address. Possible values are:
Mobile, Landline, Fax, Pager, Modem

phonePurpose
string [ 1 .. 35 ] characters

Purpose of the phone address. Possible values are: Business, Personal, International.

primaryIndicator
boolean (PrimaryContactIndicator)

Indicates whether the contact informacion is primary.

object (HourOfTheDay)
comment
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
object

The period of use of the phone information.

Array of objects (Email)
Array
emailAddress
string [ 1 .. 2048 ] characters

Address for electronic mail (e-mail).

emailPurpose
string [ 1 .. 35 ] characters
Example: "Statements"

Purpose of the e-mail address. Possible values: Marketing, Statements, Business, Administrative

primaryIndicator
boolean (PrimaryContactIndicator)

Indicates whether the contact informacion is primary.

Array of objects (CommunicationChannel)
Array
channel
string (CommunicationChannelName) [ 1 .. 35 ] characters
Example: "Email"

Channel used to communicate with a party. Possible Values: Email, Fax, File, Online, PostalService, LiveSupport, ATM, IVR, Kiosk, Mobile, OnlineBanking, Phone, SMS, Card, InPerson.

channelIdentification
string (CommunicationChannelIdentification) [ 1 .. 128 ] characters
Example: "011-02010020202"

Communication value such as phone number or email address.

channelPurpose
string (CommunicationChannelPurpose) [ 1 .. 40 ] characters
Example: "Alert"

Communication purpose of the channel. Possible values: Alerts, PrivacyNotices

codeWord
string

A party is asked for a codeword to verify their identity trought a communication channel

alertIndicator
any

Indicates whether the channel is used for enterprise alerts

object (CommunicationChannelHistory)
primaryIndicator
boolean (PrimaryContactIndicator)

Indicates whether the contact informacion is primary.

webPage
string^[(http(s)?):\/\/(www\.)?a-zA-Z0-9@:%._\+~#=]...
Example: "http://portx.io"

Business web page

logo
string <byte> (ComercialLogo) [ 1 .. 32768 ] characters
Example: {"0":105,"1":86,"2":66,"3":79,"4":82,"5":119,"6":48,"7":75,"8":71,"9":103,"10":111,"11":65,"12":65,"13":65,"14":65,"15":78,"16":83,"17":85,"18":104,"19":69,"20":85,"21":103,"22":65,"23":65,"24":65,"25":90,"26":52,"27":65,"28":65,"29":65,"30":66,"31":111,"32":67,"33":65,"34":77,"35":65,"36":65,"37":65,"38":68,"39":50,"40":72,"41":109,"42":97,"43":78,"44":65,"45":65,"46":65,"47":65,"48":66,"49":71,"50":100,"51":66,"52":84,"53":85,"54":69,"55":65,"56":65,"57":76,"58":71,"59":80,"60":67,"61":47,"62":120,"63":104,"64":66,"65":81,"66":65,"67":65,"68":65,"69":65,"70":70,"71":122,"72":85,"73":107,"74":100,"75":67,"76":65,"77":75,"78":55,"79":79,"80":72,"81":79,"82":107,"83":65,"84":65,"85":65,"86":68,"87":56,"88":85,"89":69,"90":120,"91":85,"92":82,"93":81,"94":65,"95":65,"96":65,"97":70,"98":68,"99":80,"100":51,"101":49,"102":67,"103":47,"104":51,"105":119,"106":65,"107":81,"108":77,"109":65,"110":65,"111":81,"112":73,"113":65,"114":65,"115":90,"116":75,"117":86,"118":68,"119":72,"120":53,"121":119,"122":65,"123":89,"124":75,"125":70,"126":68,"127":70,"128":54,"129":108,"130":68,"131":70,"132":53,"133":65,"134":65,"135":86,"136":75,"137":103,"138":65,"139":86,"140":74,"141":86,"142":68,"143":72,"144":53,"145":49,"146":68,"147":72,"148":52,"149":48,"150":122,"151":68,"152":53,"153":119,"154":65,"155":89,"156":76,"157":65,"158":65,"159":89,"160":75,"161":70,"162":68,"163":71,"164":53,"165":85,"166":122,"167":71,"168":53,"169":81,"170":77,"171":87,"172":76,"173":81,"174":65,"175":87,"176":76,"177":81,"178":65,"179":87,"180":75,"181":81,"182":65,"183":89,"184":75,"185":49,"186":68,"187":72,"188":53,"189":49,"190":68,"191":72,"192":53,"193":69,"194":51,"195":70,"196":53,"197":48,"198":51,"199":70,"200":53,"201":65,"202":77,"203":89,"204":75,"205":103,"206":65,"207":89,"208":75,"209":108,"210":68,"211":73,"212":54,"213":65,"214":73,"215":88,"216":76,"217":70,"218":68,"219":73,"220":53,"221":108,"222":68,"223":71,"224":53,"225":107,"226":51,"227":71,"228":53,"229":103,"230":73,"231":90,"232":75,"233":119,"234":73,"235":90,"236":75,"237":81,"238":73,"239":88,"240":75,"241":119,"242":65,"243":88,"244":75,"245":49,"246":68,"247":74,"248":53,"249":119,"250":73,"251":89,"252":76,"253":65,"254":73,"255":89,"256":75,"257":108,"258":68,"259":72,"260":53,"261":85,"262":55,"263":70,"264":53,"265":48,"266":55,"267":70,"268":53,"269":81,"270":73,"271":89,"272":76,"273":65,"274":73,"275":89,"276":75,"277":107,"278":55,"279":73,"280":54,"281":69,"282":55,"283":71,"284":54,"285":65,"286":73,"287":90,"288":75,"289":119,"290":73,"291":88,"292":75,"293":48,"294":55,"295":71,"296":53,"297":103,"298":73,"299":90,"300":76,"301":65,"302":73,"303":90,"304":75,"305":103,"306":73,"307":88,"308":75,"309":107,"310":47,"311":72,"312":54,"313":85,"314":47,"315":72,"316":53,"317":119,"318":73,"319":89,"320":75,"321":119,"322":73,"323":89,"324":75,"325":107,"326":55,"327":71,"328":53,"329":119,"330":73,"331":89,"332":75,"333":119,"334":73,"335":89,"336":75,"337":85,"338":47,"339":73,"340":54,"341":69,"342":47,"343":71,"344":54,"345":65,"346":69,"347":90,"348":76,"349":65,"350":69,"351":88,"352":75,"353":103,"354":69,"355":88,"356":75,"357":107,"358":47,"359":72,"360":53,"361":119,"362":69,"363":89,"364":75,"365":48,"366":47,"367":73,"368":53,"369":107,"370":47,"371":71,"372":53,"373":103,"374":73,"375":90,"376":75,"377":119,"378":69,"379":90,"380":75,"381":119,"382":69,"383":88,"384":75,"385":48,"386":47,"387":72,"388":53,"389":119,"390":73,"391":89,"392":75,"393":119,"394":69,"395":89,"396":75,"397":48,"398":47,"399":73,"400":54,"401":69,"402":47,"403":71,"404":54,"405":65,"406":73,"407":90,"408":75,"409":119,"410":73,"411":88,"412":76,"413":65,"414":73,"415":88,"416":75,"417":119,"418":69,"419":88,"420":76,"421":69,"422":47,"423":72,"424":53,"425":119,"426":73,"427":89,"428":75,"429":54,"430":111,"431":85,"432":72,"433":77,"434":107,"435":65,"436":65,"437":65,"438":66,"439":83,"440":100,"441":70,"442":74,"443":79,"444":85,"445":119,"446":65,"447":81,"448":69,"449":66,"450":65,"451":81,"452":72,"453":121,"454":65,"455":103,"456":77,"457":68,"458":65,"459":119,"460":77,"461":69,"462":66,"463":65,"464":81,"465":69,"466":66,"467":65,"468":85,"469":70,"470":66,"471":81,"472":85,"473":70,"474":66,"475":102,"476":89,"477":71,"478":66,"479":103,"480":89,"481":71,"482":66,"483":103,"484":98,"485":50,"486":57,"487":119,"488":99,"489":72,"490":66,"491":119,"492":99,"493":72,"494":66,"495":119,"496":102,"497":51,"498":57,"499":47,"500":103,"501":73,"502":67,"503":65,"504":103,"505":73,"506":67,"507":80,"508":106,"509":52,"510":43,"511":80,"512":107,"513":74,"514":67,"515":81,"516":107,"517":74,"518":43,"519":102,"520":110,"521":53,"522":43,"523":103,"524":111,"525":75,"526":67,"527":118,"528":114,"529":54,"530":43,"531":118,"532":115,"533":76,"534":43,"535":47,"536":122,"537":56,"538":47,"539":80,"540":122,"541":56,"542":47,"543":102,"544":51,"545":57,"546":47,"547":118,"548":55,"549":43,"550":47,"551":118,"552":55,"553":43,"554":47,"555":77,"556":49,"557":99,"558":87,"559":116,"560":65,"561":65,"562":65,"563":73,"564":49,"565":48,"566":108,"567":69,"568":81,"569":86,"570":82,"571":52,"572":50,"573":117,"574":50,"575":100,"576":102,"577":51,"578":47,"579":84,"580":78,"581":104,"582":68,"583":71,"584":66,"585":81,"586":107,"587":50,"588":84,"589":81,"590":115,"591":50,"592":106,"593":65,"594":74,"595":90,"596":80,"597":68,"598":112,"599":71,"600":70,"601":56,"602":112,"603":111,"604":117,"605":112,"606":73,"607":117,"608":120,"609":81,"610":78,"611":71,"612":73,"613":97,"614":90,"615":76,"616":71,"617":112,"618":80,"619":43,"620":121,"621":118,"622":116,"623":47,"624":76,"625":47,"626":115,"627":65,"628":88,"629":83,"630":80,"631":70,"632":79,"633":117,"634":108,"635":79,"636":80,"637":113,"638":88,"639":57,"640":103,"641":79,"642":55,"643":80,"644":117,"645":110,"646":89,"647":99,"648":80,"649":100,"650":76,"651":112,"652":113,"653":43,"654":100,"655":107,"656":82,"657":51,"658":84,"659":80,"660":116,"661":88,"662":70,"663":48,"664":81,"665":122,"666":66,"667":69,"668":78,"669":78,"670":86,"671":101,"672":102,"673":80,"674":112,"675":85,"676":104,"677":77,"678":67,"679":70,"680":118,"681":103,"682":72,"683":80,"684":122,"685":49,"686":57,"687":121,"688":88,"689":80,"690":119,"691":73,"692":117,"693":80,"694":103,"695":119,"696":116,"697":68,"698":115,"699":121,"700":43,"701":107,"702":65,"703":76,"704":102,"705":111,"706":55,"707":113,"708":88,"709":55,"710":115,"711":78,"712":88,"713":80,"714":118,"715":56,"716":99,"717":87,"718":104,"719":51,"720":90,"721":78,"722":121,"723":99,"724":101,"725":117,"726":118,"727":104,"728":78,"729":54,"730":68,"731":66,"732":56,"733":48,"734":57,"735":111,"736":100,"737":110,"738":82,"739":115,"740":81,"741":70,"742":51,"743":56,"744":98,"745":116,"746":48,"747":114,"748":100,"749":54,"750":69,"751":114,"752":82,"753":54,"754":72,"755":86,"756":56,"757":84,"758":69,"759":69,"760":71,"761":118,"762":71,"763":111,"764":76,"765":104,"766":100,"767":65,"768":54,"769":118,"770":82,"771":68,"772":109,"773":120,"774":78,"775":105,"776":68,"777":87,"778":114,"779":71,"780":109,"781":110,"782":121,"783":49,"784":68,"785":56,"786":107,"787":101,"788":66,"789":103,"790":56,"791":80,"792":72,"793":100,"794":83,"795":67,"796":54,"797":47,"798":117,"799":66,"800":67,"801":122,"802":122,"803":84,"804":119,"805":90,"806":56,"807":43,"808":111,"809":80,"810":112,"811":84,"812":97,"813":80,"814":66,"815":114,"816":81,"817":65,"818":101,"819":47,"820":66,"821":67,"822":53,"823":103,"824":105,"825":48,"826":78,"827":50,"828":117,"829":73,"830":54,"831":103,"832":119,"833":102,"834":77,"835":54,"836":116,"837":68,"838":89,"839":102,"840":72,"841":102,"842":119,"843":99,"844":117,"845":79,"846":65,"847":54,"848":120,"849":74,"850":116,"851":122,"852":88,"853":117,"854":115,"855":116,"856":67,"857":108,"858":121,"859":119,"860":70,"861":68,"862":112,"863":119,"864":116,"865":78,"866":52,"867":79,"868":80,"869":97,"870":50,"871":108,"872":102,"873":116,"874":82,"875":52,"876":119,"877":87,"878":113,"879":57,"880":116,"881":81,"882":77,"883":88,"884":77,"885":65,"886":101,"887":114,"888":117,"889":82,"890":121,"891":52,"892":89,"893":71,"894":108,"895":48,"896":52,"897":65,"898":68,"899":88,"900":51,"901":99,"902":65,"903":70,"904":55,"905":80,"906":71,"907":101,"908":98,"909":82,"910":107,"911":90,"912":117,"913":77,"914":66,"915":68,"916":82,"917":70,"918":77,"919":117,"920":54,"921":50,"922":48,"923":47,"924":99,"925":77,"926":69,"927":121,"928":54,"929":89,"930":65,"931":73,"932":49,"933":54,"934":68,"935":90,"936":116,"937":104,"938":76,"939":97,"940":117,"941":65,"942":53,"943":99,"944":72,"945":47,"946":70,"947":89,"948":98,"949":52,"950":69,"951":76,"952":108,"953":107,"954":119,"955":72,"956":112,"957":71,"958":55,"959":102,"960":68,"961":108,"962":122,"963":103,"964":75,"965":89,"966":89,"967":77,"968":99,"969":65,"970":50,"971":97,"972":98,"973":88,"974":43,"975":69,"976":57,"977":118,"978":86,"979":70,"980":66,"981":47,"982":99,"983":68,"984":70,"985":49,"986":120,"987":110,"988":79,"989":115,"990":66,"991":98,"992":98,"993":121,"994":66,"995":85,"996":51,"997":119,"998":43,"999":116,"1000":54,"1001":52,"1002":56,"1003":79,"1004":48,"1005":78,"1006":98,"1007":98,"1008":77,"1009":72,"1010":68,"1011":66,"1012":70,"1013":100,"1014":65,"1015":66,"1016":49,"1017":110,"1018":111,"1019":76,"1020":90,"1021":116,"1022":118,"1023":86,"1024":48,"1025":65,"1026":70,"1027":121,"1028":97,"1029":57,"1030":111,"1031":49,"1032":52,"1033":111,"1034":74,"1035":109,"1036":110,"1037":71,"1038":90,"1039":90,"1040":116,"1041":112,"1042":55,"1043":71,"1044":51,"1045":120,"1046":85,"1047":100,"1048":49,"1049":76,"1050":76,"1051":101,"1052":117,"1053":106,"1054":120,"1055":99,"1056":107,"1057":70,"1058":97,"1059":68,"1060":49,"1061":115,"1062":106,"1063":78,"1064":122,"1065":98,"1066":121,"1067":99,"1068":47,"1069":82,"1070":56,"1071":110,"1072":120,"1073":97,"1074":118,"1075":85,"1076":102,"1077":107,"1078":112,"1079":99,"1080":47,"1081":99,"1082":120,"1083":86,"1084":56,"1085":52,"1086":101,"1087":117,"1088":112,"1089":115,"1090":104,"1091":111,"1092":76,"1093":72,"1094":81,"1095":98,"1096":75,"1097":90,"1098":114,"1099":86,"1100":84,"1101":109,"1102":85,"1103":52,"1104":97,"1105":75,"1106":67,"1107":68,"1108":89,"1109":82,"1110":49,"1111":116,"1112":105,"1113":87,"1114":98,"1115":98,"1116":84,"1117":66,"1118":101,"1119":106,"1120":68,"1121":120,"1122":50,"1123":107,"1124":82,"1125":109,"1126":108,"1127":82,"1128":79,"1129":88,"1130":109,"1131":83,"1132":50,"1133":56,"1134":55,"1135":116,"1136":54,"1137":84,"1138":56,"1139":48,"1140":88,"1141":50,"1142":57,"1143":67,"1144":90,"1145":120,"1146":81,"1147":122,"1148":90,"1149":75,"1150":105,"1151":100,"1152":111,"1153":49,"1154":70,"1155":75,"1156":104,"1157":52,"1158":52,"1159":88,"1160":98,"1161":50,"1162":116,"1163":88,"1164":79,"1165":104,"1166":104,"1167":84,"1168":54,"1169":65,"1170":66,"1171":104,"1172":118,"1173":101,"1174":48,"1175":122,"1176":99,"1177":81,"1178":72,"1179":52,"1180":82,"1181":88,"1182":79,"1183":69,"1184":81,"1185":74,"1186":50,"1187":74,"1188":48,"1189":55,"1190":107,"1191":57,"1192":54,"1193":68,"1194":78,"1195":80,"1196":111,"1197":66,"1198":77,"1199":100,"1200":53,"1201":82,"1202":71,"1203":74,"1204":102,"1205":75,"1206":120,"1207":89,"1208":71,"1209":77,"1210":80,"1211":83,"1212":111,"1213":90,"1214":55,"1215":50,"1216":85,"1217":120,"1218":56,"1219":53,"1220":87,"1221":50,"1222":57,"1223":51,"1224":117,"1225":76,"1226":106,"1227":65,"1228":56,"1229":70,"1230":86,"1231":116,"1232":65,"1233":114,"1234":85,"1235":77,"1236":106,"1237":98,"1238":98,"1239":108,"1240":74,"1241":65,"1242":57,"1243":52,"1244":111,"1245":113,"1246":115,"1247":56,"1248":89,"1249":107,"1250":56,"1251":43,"1252":43,"1253":69,"1254":119,"1255":53,"1256":74,"1257":72,"1258":87,"1259":116,"1260":69,"1261":90,"1262":69,"1263":79,"1264":114,"1265":78,"1266":89,"1267":98,"1268":71,"1269":120,"1270":101,"1271":89,"1272":118,"1273":117,"1274":118,"1275":69,"1276":113,"1277":77,"1278":43,"1279":84,"1280":109,"1281":101,"1282":117,"1283":53,"1284":74,"1285":110,"1286":108,"1287":109,"1288":111,"1289":53,"1290":104,"1291":84,"1292":72,"1293":106,"1294":71,"1295":71,"1296":48,"1297":116,"1298":118,"1299":122,"1300":43,"1301":100,"1302":47,"1303":80,"1304":111,"1305":72,"1306":117,"1307":57,"1308":55,"1309":87,"1310":105,"1311":57,"1312":116,"1313":100,"1314":110,"1315":56,"1316":65,"1317":117,"1318":99,"1319":50,"1320":122,"1321":105,"1322":48,"1323":78,"1324":78,"1325":85,"1326":110,"1327":100,"1328":53,"1329":78,"1330":70,"1331":43,"1332":113,"1333":76,"1334":115,"1335":56,"1336":56,"1337":97,"1338":107,"1339":43,"1340":118,"1341":99,"1342":109,"1343":112,"1344":55,"1345":84,"1346":102,"1347":119,"1348":84,"1349":118,"1350":116,"1351":79,"1352":100,"1353":65,"1354":67,"1355":97,"1356":98,"1357":89,"1358":57,"1359":53,"1360":53,"1361":90,"1362":108,"1363":78,"1364":71,"1365":104,"1366":67,"1367":118,"1368":73,"1369":82,"1370":114,"1371":115,"1372":111,"1373":90,"1374":115,"1375":56,"1376":117,"1377":108,"1378":84,"1379":106,"1380":76,"1381":111,"1382":47,"1383":52,"1384":88,"1385":90,"1386":47,"1387":101,"1388":112,"1389":78,"1390":83,"1391":87,"1392":71,"1393":55,"1394":121,"1395":68,"1396":113,"1397":81,"1398":116,"1399":99,"1400":55,"1401":47,"1402":77,"1403":57,"1404":122,"1405":71,"1406":80,"1407":53,"1408":117,"1409":116,"1410":67,"1411":116,"1412":72,"1413":50,"1414":68,"1415":97,"1416":54,"1417":113,"1418":71,"1419":98,"1420":80,"1421":74,"1422":113,"1423":74,"1424":117,"1425":111,"1426":89,"1427":56,"1428":121,"1429":113,"1430":49,"1431":101,"1432":112,"1433":106,"1434":99,"1435":112,"1436":77,"1437":53,"1438":101,"1439":109,"1440":70,"1441":76,"1442":55,"1443":104,"1444":89,"1445":76,"1446":49,"1447":70,"1448":106,"1449":72,"1450":54,"1451":66,"1452":119,"1453":47,"1454":100,"1455":86,"1456":69,"1457":55,"1458":99,"1459":104,"1460":106,"1461":108,"1462":116,"1463":117,"1464":56,"1465":104,"1466":119,"1467":51,"1468":79,"1469":79,"1470":86,"1471":82,"1472":54,"1473":80,"1474":111,"1475":105,"1476":118,"1477":99,"1478":85,"1479":110,"1480":56,"1481":122,"1482":57,"1483":108,"1484":84,"1485":116,"1486":54,"1487":66,"1488":119,"1489":88,"1490":112,"1491":55,"1492":122,"1493":43,"1494":103,"1495":88,"1496":122,"1497":71,"1498":43,"1499":122,"1500":99,"1501":51,"1502":72,"1503":110,"1504":121,"1505":86,"1506":118,"1507":53,"1508":43,"1509":119,"1510":54,"1511":48,"1512":81,"1513":75,"1514":50,"1515":50,"1516":121,"1517":100,"1518":110,"1519":103,"1520":119,"1521":90,"1522":99,"1523":101,"1524":50,"1525":71,"1526":120,"1527":108,"1528":66,"1529":83,"1530":111,"1531":51,"1532":57,"1533":113,"1534":82,"1535":53,"1536":53,"1537":108,"1538":115,"1539":107,"1540":50,"1541":89,"1542":70,"1543":120,"1544":43,"1545":65,"1546":119,"1547":75,"1548":74,"1549":97,"1550":81,"1551":71,"1552":72,"1553":54,"1554":116,"1555":72,"1556":100,"1557":66,"1558":48,"1559":105,"1560":113,"1561":97,"1562":97,"1563":51,"1564":72,"1565":74,"1566":88,"1567":97,"1568":51,"1569":75,"1570":121,"1571":51,"1572":78,"1573":117,"1574":99,"1575":50,"1576":48,"1577":52,"1578":111,"1579":56,"1580":88,"1581":120,"1582":81,"1583":113,"1584":84,"1585":84,"1586":49,"1587":90,"1588":105,"1589":70,"1590":104,"1591":90,"1592":55,"1593":112,"1594":122,"1595":74,"1596":51,"1597":83,"1598":57,"1599":87,"1600":116,"1601":74,"1602":51,"1603":116,"1604":50,"1605":117,"1606":83,"1607":90,"1608":47,"1609":122,"1610":69,"1611":55,"1612":66,"1613":86,"1614":99,"1615":111,"1616":112,"1617":117,"1618":70,"1619":51,"1620":67,"1621":47,"1622":69,"1623":100,"1624":57,"1625":120,"1626":98,"1627":84,"1628":87,"1629":119,"1630":101,"1631":90,"1632":50,"1633":107,"1634":120,"1635":48,"1636":56,"1637":74,"1638":111,"1639":75,"1640":49,"1641":85,"1642":54,"1643":98,"1644":99,"1645":51,"1646":84,"1647":121,"1648":105,"1649":74,"1650":89,"1651":53,"1652":88,"1653":83,"1654":106,"1655":81,"1656":57,"1657":110,"1658":90,"1659":104,"1660":113,"1661":83,"1662":56,"1663":51,"1664":77,"1665":53,"1666":65,"1667":98,"1668":116,"1669":102,"1670":75,"1671":73,"1672":66,"1673":57,"1674":74,"1675":112,"1676":68,"1677":86,"1678":90,"1679":53,"1680":71,"1681":109,"1682":77,"1683":49,"1684":118,"1685":99,"1686":110,"1687":100,"1688":75,"1689":55,"1690":70,"1691":87,"1692":70,"1693":111,"1694":104,"1695":48,"1696":48,"1697":71,"1698":86,"1699":57,"1700":109,"1701":69,"1702":99,"1703":114,"1704":106,"1705":47,"1706":103,"1707":76,"1708":87,"1709":115,"1710":115,"1711":116,"1712":77,"1713":113,"1714":108,"1715":109,"1716":71,"1717":111,"1718":47,"1719":76,"1720":109,"1721":87,"1722":85,"1723":99,"1724":54,"1725":79,"1726":87,"1727":82,"1728":74,"1729":53,"1730":105,"1731":85,"1732":86,"1733":82,"1734":54,"1735":86,"1736":114,"1737":112,"1738":47,"1739":74,"1740":51,"1741":87,"1742":116,"1743":103,"1744":80,"1745":51,"1746":109,"1747":68,"1748":66,"1749":78,"1750":99,"1751":82,"1752":98,"1753":120,"1754":49,"1755":66,"1756":76,"1757":52,"1758":43,"1759":85,"1760":114,"1761":118,"1762":56,"1763":50,"1764":68,"1765":104,"1766":54,"1767":100,"1768":71,"1769":57,"1770":73,"1771":54,"1772":116,"1773":81,"1774":119,"1775":102,"1776":81,"1777":74,"1778":53,"1779":78,"1780":47,"1781":98,"1782":48,"1783":119,"1784":121,"1785":75,"1786":80,"1787":81,"1788":57,"1789":102,"1790":71,"1791":87,"1792":108,"1793":78,"1794":114,"1795":113,"1796":86,"1797":66,"1798":97,"1799":101,"1800":85,"1801":113,"1802":68,"1803":97,"1804":56,"1805":83,"1806":70,"1807":102,"1808":102,"1809":90,"1810":77,"1811":48,"1812":53,"1813":110,"1814":47,"1815":43,"1816":97,"1817":66,"1818":111,"1819":56,"1820":112,"1821":98,"1822":85,"1823":120,"1824":66,"1825":110,"1826":104,"1827":53,"1828":102,"1829":118,"1830":73,"1831":110,"1832":68,"1833":52,"1834":82,"1835":43,"1836":75,"1837":79,"1838":78,"1839":51,"1840":106,"1841":87,"1842":67,"1843":57,"1844":114,"1845":84,"1846":66,"1847":118,"1848":122,"1849":103,"1850":71,"1851":97,"1852":120,"1853":74,"1854":67,"1855":101,"1856":90,"1857":71,"1858":120,"1859":114,"1860":87,"1861":82,"1862":116,"1863":68,"1864":104,"1865":120,"1866":97,"1867":65,"1868":80,"1869":73,"1870":108,"1871":72,"1872":101,"1873":82,"1874":83,"1875":54,"1876":116,"1877":106,"1878":105,"1879":104,"1880":108,"1881":88,"1882":105,"1883":68,"1884":104,"1885":50,"1886":116,"1887":87,"1888":76,"1889":110,"1890":65,"1891":97,"1892":80,"1893":89,"1894":87,"1895":100,"1896":115,"1897":66,"1898":74,"1899":122,"1900":100,"1901":114,"1902":77,"1903":110,"1904":116,"1905":51,"1906":86,"1907":117,"1908":101,"1909":86,"1910":83,"1911":54,"1912":112,"1913":113,"1914":81,"1915":50,"1916":69,"1917":120,"1918":49,"1919":69,"1920":47,"1921":115,"1922":119,"1923":50,"1924":55,"1925":78,"1926":121,"1927":122,"1928":109,"1929":74,"1930":48,"1931":107,"1932":53,"1933":101,"1934":66,"1935":87,"1936":110,"1937":66,"1938":105,"1939":122,"1940":71,"1941":121,"1942":68,"1943":80,"1944":66,"1945":50,"1946":57,"1947":111,"1948":85,"1949":80,"1950":71,"1951":117,"1952":67,"1953":97,"1954":109,"1955":78,"1956":81,"1957":103,"1958":101,"1959":103,"1960":50,"1961":82,"1962":98,"1963":120,"1964":121,"1965":112,"1966":80,"1967":68,"1968":53,"1969":67,"1970":90,"1971":51,"1972":81,"1973":47,"1974":67,"1975":113,"1976":69,"1977":118,"1978":109,"1979":78,"1980":115,"1981":102,"1982":75,"1983":107,"1984":51,"1985":115,"1986":65,"1987":97,"1988":83,"1989":71,"1990":56,"1991":57,"1992":102,"1993":67,"1994":115,"1995":100,"1996":52,"1997":117,"1998":66,"1999":54,"2000":104,"2001":51,"2002":49,"2003":122,"2004":106,"2005":108,"2006":89,"2007":101,"2008":117,"2009":86,"2010":97,"2011":119,"2012":117,"2013":110,"2014":68,"2015":67,"2016":74,"2017":109,"2018":98,"2019":49,"2020":75,"2021":77,"2022":51,"2023":121,"2024":120,"2025":48,"2026":104,"2027":53,"2028":87,"2029":104,"2030":78,"2031":118,"2032":121,"2033":49,"2034":73,"2035":78,"2036":85,"2037":67,"2038":73,"2039":43,"2040":66,"2041":69,"2042":77,"2043":72,"2044":113,"2045":104,"2046":77,"2047":81,"2048":56,"2049":87,"2050":47,"2051":97,"2052":49,"2053":99,"2054":110,"2055":122,"2056":120,"2057":74,"2058":83,"2059":102,"2060":101,"2061":53,"2062":104,"2063":70,"2064":81,"2065":50,"2066":119,"2067":99,"2068":67,"2069":86,"2070":86,"2071":53,"2072":109,"2073":117,"2074":109,"2075":87,"2076":51,"2077":72,"2078":75,"2079":90,"2080":68,"2081":51,"2082":108,"2083":85,"2084":55,"2085":57,"2086":112,"2087":117,"2088":70,"2089":54,"2090":66,"2091":56,"2092":116,"2093":74,"2094":101,"2095":89,"2096":102,"2097":54,"2098":114,"2099":120,"2100":77,"2101":73,"2102":57,"2103":107,"2104":80,"2105":109,"2106":88,"2107":102,"2108":52,"2109":116,"2110":87,"2111":74,"2112":115,"2113":97,"2114":88,"2115":101,"2116":109,"2117":86,"2118":97,"2119":115,"2120":79,"2121":113,"2122":102,"2123":49,"2124":70,"2125":116,"2126":107,"2127":83,"2128":116,"2129":85,"2130":55,"2131":90,"2132":98,"2133":118,"2134":75,"2135":111,"2136":100,"2137":74,"2138":50,"2139":82,"2140":109,"2141":103,"2142":110,"2143":97,"2144":49,"2145":67,"2146":118,"2147":68,"2148":78,"2149":84,"2150":115,"2151":88,"2152":50,"2153":66,"2154":51,"2155":114,"2156":97,"2157":107,"2158":117,"2159":57,"2160":81,"2161":43,"2162":72,"2163":118,"2164":113,"2165":87,"2166":109,"2167":97,"2168":116,"2169":56,"2170":109,"2171":84,"2172":101,"2173":90,"2174":73,"2175":110,"2176":104,"2177":105,"2178":118,"2179":98,"2180":49,"2181":110,"2182":104,"2183":104,"2184":110,"2185":49,"2186":97,"2187":79,"2188":80,"2189":79,"2190":119,"2191":55,"2192":74,"2193":76,"2194":101,"2195":85,"2196":102,"2197":51,"2198":108,"2199":121,"2200":52,"2201":85,"2202":109,"2203":101,"2204":88,"2205":85,"2206":83,"2207":112,"2208":66,"2209":65,"2210":122,"2211":73,"2212":114,"2213":76,"2214":110,"2215":56,"2216":104,"2217":122,"2218":115,"2219":43,"2220":88,"2221":116,"2222":90,"2223":72,"2224":76,"2225":89,"2226":122,"2227":82,"2228":107,"2229":57,"2230":115,"2231":113,"2232":85,"2233":90,"2234":54,"2235":121,"2236":54,"2237":85,"2238":109,"2239":101,"2240":70,"2241":70,"2242":107,"2243":74,"2244":74,"2245":106,"2246":109,"2247":100,"2248":56,"2249":57,"2250":69,"2251":68,"2252":55,"2253":114,"2254":117,"2255":54,"2256":54,"2257":48,"2258":115,"2259":101,"2260":51,"2261":100,"2262":122,"2263":47,"2264":68,"2265":111,"2266":77,"2267":71,"2268":68,"2269":102,"2270":101,"2271":53,"2272":90,"2273":52,"2274":83,"2275":89,"2276":115,"2277":112,"2278":51,"2279":107,"2280":105,"2281":82,"2282":100,"2283":51,"2284":102,"2285":101,"2286":48,"2287":121,"2288":122,"2289":68,"2290":48,"2291":121,"2292":108,"2293":75,"2294":49,"2295":53,"2296":101,"2297":80,"2298":71,"2299":85,"2300":113,"2301":97,"2302":87,"2303":48,"2304":87,"2305":121,"2306":82,"2307":81,"2308":89,"2309":71,"2310":49,"2311":101,"2312":72,"2313":74,"2314":110,"2315":107,"2316":71,"2317":84,"2318":83,"2319":70,"2320":74,"2321":51,"2322":108,"2323":121,"2324":47,"2325":71,"2326":89,"2327":73,"2328":118,"2329":78,"2330":80,"2331":53,"2332":75,"2333":52,"2334":98,"2335":99,"2336":110,"2337":118,"2338":113,"2339":81,"2340":112,"2341":57,"2342":65,"2343":98,"2344":97,"2345":104,"2346":50,"2347":122,"2348":110,"2349":48,"2350":90,"2351":98,"2352":108,"2353":108,"2354":98,"2355":75,"2356":50,"2357":65,"2358":110,"2359":113,"2360":112,"2361":108,"2362":51,"2363":107,"2364":54,"2365":87,"2366":103,"2367":43,"2368":68,"2369":99,"2370":51,"2371":87,"2372":79,"2373":67,"2374":103,"2375":68,"2376":56,"2377":83,"2378":55,"2379":105,"2380":108,"2381":117,"2382":101,"2383":115,"2384":83,"2385":66,"2386":68,"2387":52,"2388":107,"2389":121,"2390":74,"2391":77,"2392":110,"2393":89,"2394":43,"2395":107,"2396":48,"2397":90,"2398":80,"2399":54,"2400":107,"2401":105,"2402":102,"2403":87,"2404":98,"2405":87,"2406":104,"2407":70,"2408":114,"2409":48,"2410":121,"2411":82,"2412":85,"2413":76,"2414":98,"2415":66,"2416":47,"2417":114,"2418":53,"2419":100,"2420":83,"2421":90,"2422":72,"2423":121,"2424":73,"2425":115,"2426":89,"2427":72,"2428":103,"2429":54,"2430":83,"2431":74,"2432":103,"2433":106,"2434":75,"2435":77,"2436":74,"2437":90,"2438":111,"2439":90,"2440":88,"2441":89,"2442":79,"2443":118,"2444":79,"2445":119,"2446":50,"2447":107,"2448":57,"2449":88,"2450":122,"2451":104,"2452":83,"2453":120,"2454":55,"2455":57,"2456":116,"2457":106,"2458":119,"2459":107,"2460":88,"2461":88,"2462":101,"2463":120,"2464":90,"2465":115,"2466":50,"2467":81,"2468":109,"2469":119,"2470":55,"2471":81,"2472":74,"2473":114,"2474":52,"2475":117,"2476":99,"2477":85,"2478":71,"2479":100,"2480":102,"2481":87,"2482":122,"2483":50,"2484":72,"2485":83,"2486":117,"2487":117,"2488":119,"2489":84,"2490":98,"2491":120,"2492":76,"2493":117,"2494":106,"2495":121,"2496":83,"2497":69,"2498":98,"2499":73,"2500":50,"2501":99,"2502":120,"2503":101,"2504":69,"2505":99,"2506":70,"2507":86,"2508":81,"2509":75,"2510":116,"2511":109,"2512":122,"2513":82,"2514":114,"2515":110,"2516":78,"2517":104,"2518":65,"2519":51,"2520":101,"2521":82,"2522":74,"2523":114,"2524":100,"2525":112,"2526":68,"2527":84,"2528":47,"2529":66,"2530":104,"2531":84,"2532":106,"2533":109,"2534":117,"2535":99,"2536":73,"2537":117,"2538":97,"2539":122,"2540":79,"2541":118,"2542":76,"2543":73,"2544":71,"2545":54,"2546":102,"2547":105,"2548":65,"2549":121,"2550":112,"2551":100,"2552":69,"2553":56,"2554":121,"2555":97,"2556":80,"2557":118,"2558":79,"2559":76,"2560":47,"2561":117,"2562":110,"2563":121,"2564":105,"2565":78,"2566":73,"2567":67,"2568":112,"2569":51,"2570":74,"2571":98,"2572":97,"2573":66,"2574":50,"2575":65,"2576":113,"2577":117,"2578":101,"2579":50,"2580":84,"2581":102,"2582":79,"2583":82,"2584":121,"2585":102,"2586":76,"2587":56,"2588":75,"2589":49,"2590":43,"2591":47,"2592":99,"2593":85,"2594":113,"2595":106,"2596":54,"2597":122,"2598":90,"2599":104,"2600":118,"2601":88,"2602":109,"2603":84,"2604":109,"2605":81,"2606":52,"2607":99,"2608":53,"2609":77,"2610":110,"2611":77,"2612":84,"2613":120,"2614":81,"2615":111,"2616":107,"2617":51,"2618":65,"2619":112,"2620":85,"2621":80,"2622":76,"2623":73,"2624":119,"2625":56,"2626":102,"2627":68,"2628":117,"2629":117,"2630":101,"2631":53,"2632":101,"2633":107,"2634":80,"2635":121,"2636":110,"2637":105,"2638":66,"2639":98,"2640":53,"2641":89,"2642":57,"2643":97,"2644":120,"2645":72,"2646":110,"2647":69,"2648":54,"2649":120,"2650":48,"2651":52,"2652":121,"2653":75,"2654":77,"2655":77,"2656":110,"2657":52,"2658":111,"2659":43,"2660":114,"2661":89,"2662":110,"2663":86,"2664":80,"2665":116,"2666":77,"2667":85,"2668":70,"2669":76,"2670":90,"2671":74,"2672":79,"2673":69,"2674":87,"2675":85,"2676":74,"2677":49,"2678":54,"2679":99,"2680":67,"2681":103,"2682":56,"2683":111,"2684":100,"2685":76,"2686":49,"2687":68,"2688":50,"2689":47,"2690":81,"2691":53,"2692":90,"2693":72,"2694":49,"2695":99,"2696":51,"2697":107,"2698":87,"2699":101,"2700":66,"2701":72,"2702":52,"2703":85,"2704":111,"2705":98,"2706":109,"2707":70,"2708":56,"2709":74,"2710":52,"2711":49,"2712":56,"2713":115,"2714":106,"2715":70,"2716":115,"2717":112,"2718":82,"2719":98,"2720":110,"2721":115,"2722":108,"2723":105,"2724":54,"2725":109,"2726":121,"2727":85,"2728":101,"2729":76,"2730":113,"2731":79,"2732":105,"2733":68,"2734":53,"2735":48,"2736":120,"2737":69,"2738":111,"2739":72,"2740":76,"2741":118,"2742":73,"2743":115,"2744":98,"2745":111,"2746":65,"2747":118,"2748":79,"2749":113,"2750":115,"2751":88,"2752":86,"2753":82,"2754":117,"2755":49,"2756":71,"2757":65,"2758":71,"2759":86,"2760":105,"2761":51,"2762":88,"2763":108,"2764":79,"2765":67,"2766":108,"2767":106,"2768":84,"2769":112,"2770":106,"2771":108,"2772":101,"2773":86,"2774":55,"2775":116,"2776":76,"2777":103,"2778":109,"2779":101,"2780":114,"2781":115,"2782":109,"2783":98,"2784":79,"2785":49,"2786":53,"2787":119,"2788":118,"2789":113,"2790":110,"2791":99,"2792":83,"2793":90,"2794":53,"2795":113,"2796":89,"2797":102,"2798":104,"2799":107,"2800":86,"2801":73,"2802":120,"2803":75,"2804":55,"2805":69,"2806":52,"2807":89,"2808":98,"2809":98,"2810":87,"2811":48,"2812":74,"2813":75,"2814":120,"2815":71,"2816":83,"2817":80,"2818":76,"2819":69,"2820":117,"2821":117,"2822":54,"2823":121,"2824":104,"2825":54,"2826":88,"2827":114,"2828":78,"2829":114,"2830":107,"2831":43,"2832":68,"2833":86,"2834":113,"2835":106,"2836":75,"2837":56,"2838":117,"2839":83,"2840":112,"2841":49,"2842":73,"2843":89,"2844":49,"2845":115,"2846":100,"2847":98,"2848":81,"2849":90,"2850":65,"2851":110,"2852":109,"2853":101,"2854":72,"2855":104,"2856":109,"2857":105,"2858":74,"2859":80,"2860":85,"2861":55,"2862":115,"2863":116,"2864":82,"2865":101,"2866":108,"2867":103,"2868":66,"2869":114,"2870":113,"2871":71,"2872":117,"2873":71,"2874":66,"2875":113,"2876":73,"2877":76,"2878":69,"2879":49,"2880":82,"2881":106,"2882":112,"2883":119,"2884":107,"2885":119,"2886":101,"2887":108,"2888":122,"2889":48,"2890":104,"2891":81,"2892":53,"2893":74,"2894":70,"2895":114,"2896":109,"2897":98,"2898":117,"2899":77,"2900":56,"2901":117,"2902":122,"2903":113,"2904":83,"2905":120,"2906":85,"2907":74,"2908":122,"2909":114,"2910":118,"2911":101,"2912":100,"2913":51,"2914":107,"2915":89,"2916":90,"2917":77,"2918":104,"2919":110,"2920":106,"2921":84,"2922":114,"2923":75,"2924":73,"2925":49,"2926":113,"2927":108,"2928":100,"2929":101,"2930":119,"2931":48,"2932":97,"2933":102,"2934":73,"2935":107,"2936":101,"2937":79,"2938":117,"2939":78,"2940":73,"2941":73,"2942":43,"2943":56,"2944":82,"2945":70,"2946":90,"2947":115,"2948":120,"2949":68,"2950":48,"2951":77,"2952":88,"2953":97,"2954":56,"2955":52,"2956":49,"2957":97,"2958":99,"2959":120,"2960":108,"2961":87,"2962":47,"2963":80,"2964":56,"2965":113,"2966":103,"2967":55,"2968":51,"2969":87,"2970":107,"2971":55,"2972":77,"2973":79,"2974":49,"2975":98,"2976":52,"2977":65,"2978":115,"2979":117,"2980":101,"2981":87,"2982":76,"2983":119,"2984":73,"2985":85,"2986":88,"2987":122,"2988":79,"2989":119,"2990":56,"2991":115,"2992":88,"2993":71,"2994":67,"2995":90,"2996":82,"2997":118,"2998":106,"2999":111,"3000":119,"3001":70,"3002":107,"3003":101,"3004":48,"3005":100,"3006":103,"3007":122,"3008":108,"3009":84,"3010":119,"3011":84,"3012":81,"3013":90,"3014":89,"3015":110,"3016":81,"3017":83,"3018":56,"3019":87,"3020":56,"3021":102,"3022":76,"3023":107,"3024":56,"3025":78,"3026":97,"3027":99,"3028":120,"3029":79,"3030":53,"3031":100,"3032":100,"3033":49,"3034":51,"3035":51,"3036":114,"3037":82,"3038":49,"3039":121,"3040":87,"3041":97,"3042":80,"3043":117,"3044":56,"3045":104,"3046":103,"3047":71,"3048":48,"3049":78,"3050":108,"3051":50,"3052":85,"3053":57,"3054":68,"3055":108,"3056":107,"3057":89,"3058":101,"3059":80,"3060":50,"3061":81,"3062":116,"3063":68,"3064":121,"3065":57,"3066":77,"3067":120,"3068":114,"3069":90,"3070":68,"3071":51,"3072":98,"3073":72,"3074":83,"3075":78,"3076":75,"3077":90,"3078":72,"3079":83,"3080":54,"3081":79,"3082":68,"3083":84,"3084":77,"3085":117,"3086":85,"3087":82,"3088":73,"3089":105,"3090":118,"3091":111,"3092":52,"3093":115,"3094":68,"3095":121,"3096":116,"3097":76,"3098":66,"3099":98,"3100":79,"3101":76,"3102":72,"3103":121,"3104":120,"3105":77,"3106":98,"3107":110,"3108":114,"3109":57,"3110":88,"3111":108,"3112":81,"3113":81,"3114":118,"3115":80,"3116":66,"3117":89,"3118":104,"3119":57,"3120":97,"3121":51,"3122":48,"3123":109,"3124":79,"3125":115,"3126":103,"3127":118,"3128":73,"3129":120,"3130":85,"3131":117,"3132":69,"3133":81,"3134":47,"3135":71,"3136":113,"3137":106,"3138":89,"3139":72,"3140":109,"3141":98,"3142":85,"3143":99,"3144":118,"3145":88,"3146":55,"3147":53,"3148":109,"3149":81,"3150":118,"3151":73,"3152":116,"3153":74,"3154":108,"3155":68,"3156":82,"3157":54,"3158":65,"3159":76,"3160":53,"3161":77,"3162":90,"3163":82,"3164":49,"3165":112,"3166":110,"3167":47,"3168":110,"3169":43,"3170":52,"3171":86,"3172":74,"3173":121,"3174":51,"3175":112,"3176":99,"3177":78,"3178":53,"3179":68,"3180":76,"3181":51,"3182":107,"3183":119,"3184":43,"3185":57,"3186":90,"3187":117,"3188":56,"3189":104,"3190":100,"3191":79,"3192":88,"3193":83,"3194":78,"3195":43,"3196":48,"3197":77,"3198":117,"3199":47,"3200":80,"3201":110,"3202":101,"3203":98,"3204":68,"3205":55,"3206":75,"3207":87,"3208":43,"3209":72,"3210":54,"3211":105,"3212":49,"3213":114,"3214":52,"3215":49,"3216":47,"3217":115,"3218":74,"3219":112,"3220":67,"3221":66,"3222":81,"3223":88,"3224":73,"3225":74,"3226":57,"3227":47,"3228":72,"3229":51,"3230":114,"3231":89,"3232":86,"3233":104,"3234":87,"3235":67,"3236":122,"3237":100,"3238":113,"3239":56,"3240":122,"3241":86,"3242":48,"3243":52,"3244":68,"3245":83,"3246":70,"3247":72,"3248":55,"3249":102,"3250":51,"3251":115,"3252":51,"3253":73,"3254":88,"3255":84,"3256":69,"3257":76,"3258":87,"3259":115,"3260":85,"3261":75,"3262":119,"3263":49,"3264":43,"3265":106,"3266":109,"3267":56,"3268":54,"3269":55,"3270":86,"3271":43,"3272":97,"3273":109,"3274":80,"3275":89,"3276":122,"3277":51,"3278":55,"3279":80,"3280":50,"3281":121,"3282":43,"3283":107,"3284":47,"3285":47,"3286":67,"3287":120,"3288":85,"3289":52,"3290":56,"3291":76,"3292":122,"3293":72,"3294":81,"3295":81,"3296":51,"3297":106,"3298":80,"3299":117,"3300":105,"3301":119,"3302":116,"3303":111,"3304":86,"3305":53,"3306":107,"3307":71,"3308":79,"3309":108,"3310":106,"3311":113,"3312":107,"3313":111,"3314":102,"3315":89,"3316":55,"3317":49,"3318":107,"3319":76,"3320":112,"3321":121,"3322":72,"3323":52,"3324":117,"3325":77,"3326":65,"3327":105,"3328":99,"3329":47,"3330":104,"3331":53,"3332":74,"3333":81,"3334":57,"3335":99,"3336":81,"3337":72,"3338":43,"3339":69,"3340":100,"3341":121,"3342":51,"3343":81,"3344":65,"3345":88,"3346":47,"3347":115,"3348":49,"3349":49,"3350":51,"3351":121,"3352":122,"3353":79,"3354":77,"3355":78,"3356":47,"3357":122,"3358":77,"3359":108,"3360":80,"3361":51,"3362":113,"3363":115,"3364":115,"3365":72,"3366":68,"3367":66,"3368":120,"3369":101,"3370":75,"3371":72,"3372":114,"3373":51,"3374":65,"3375":97,"3376":119,"3377":106,"3378":120,"3379":104,"3380":79,"3381":67,"3382":48,"3383":110,"3384":78,"3385":119,"3386":73,"3387":100,"3388":56,"3389":69,"3390":97,"3391":88,"3392":57,"3393":53,"3394":86,"3395":102,"3396":119,"3397":82,"3398":114,"3399":108,"3400":53,"3401":89,"3402":73,"3403":112,"3404":70,"3405":120,"3406":101,"3407":89,"3408":54,"3409":101,"3410":66,"3411":84,"3412":97,"3413":79,"3414":111,"3415":114,"3416":53,"3417":111,"3418":74,"3419":118,"3420":48,"3421":81,"3422":57,"3423":48,"3424":52,"3425":72,"3426":47,"3427":74,"3428":52,"3429":49,"3430":53,"3431":71,"3432":117,"3433":48,"3434":97,"3435":70,"3436":48,"3437":56,"3438":65,"3439":70,"3440":109,"3441":114,"3442":103,"3443":88,"3444":67,"3445":113,"3446":101,"3447":43,"3448":117,"3449":97,"3450":68,"3451":87,"3452":84,"3453":52,"3454":111,"3455":70,"3456":79,"3457":117,"3458":68,"3459":105,"3460":65,"3461":105,"3462":56,"3463":47,"3464":78,"3465":82,"3466":113,"3467":115,"3468":85,"3469":97,"3470":98,"3471":119,"3472":56,"3473":77,"3474":111,"3475":118,"3476":89,"3477":98,"3478":66,"3479":71,"3480":81,"3481":43,"3482":71,"3483":85,"3484":104,"3485":81,"3486":118,"3487":113,"3488":47,"3489":116,"3490":82,"3491":111,"3492":75,"3493":74,"3494":121,"3495":121,"3496":112,"3497":68,"3498":97,"3499":72,"3500":112,"3501":48,"3502":88,"3503":113,"3504":76,"3505":88,"3506":54,"3507":67,"3508":78,"3509":85,"3510":113,"3511":73,"3512":72,"3513":99,"3514":121,"3515":76,"3516":99,"3517":51,"3518":105,"3519":122,"3520":90,"3521":105,"3522":105,"3523":99,"3524":88,"3525":106,"3526":69,"3527":88,"3528":109,"3529":79,"3530":107,"3531":103,"3532":87,"3533":75,"3534":80,"3535":111,"3536":79,"3537":80,"3538":84,"3539":53,"3540":75,"3541":56,"3542":111,"3543":98,"3544":103,"3545":81,"3546":53,"3547":113,"3548":120,"3549":116,"3550":84,"3551":114,"3552":84,"3553":53,"3554":65,"3555":102,"3556":104,"3557":116,"3558":109,"3559":110,"3560":88,"3561":116,"3562":120,"3563":55,"3564":114,"3565":89,"3566":115,"3567":43,"3568":85,"3569":47,"3570":113,"3571":74,"3572":43,"3573":116,"3574":114,"3575":76,"3576":66,"3577":51,"3578":90,"3579":68,"3580":120,"3581":110,"3582":47,"3583":122,"3584":121,"3585":111,"3586":52,"3587":115,"3588":74,"3589":103,"3590":103,"3591":90,"3592":53,"3593":65,"3594":65,"3595":65,"3596":65,"3597":65,"3598":66,"3599":74,"3600":82,"3601":85,"3602":53,"3603":69,"3604":114,"3605":107,"3606":74,"3607":103,"3608":103,"3609":103,"3610":61,"3611":61}

Commercial logo of the organization. Max length of 32K, base64 encoded.

Responses

Request samples

Content type
application/json
{
  • "identifiers": [
    ],
  • "name": "Jane Birkin",
  • "shortName": "Jane",
  • "nameTemplateId": "1",
  • "nameSoundExId": "1",
  • "partyBranchId": "SEA_1",
  • "comment": "This is a description.",
  • "relatedParties": [
    ],
  • "postalAddresses": [
    ],
  • "relationshipId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "relationshipLeadIndicator": true,
  • "residenceType": "Domestic",
  • "taxInformation": {
    },
  • "powerOfAttorney": {
    },
  • "supplementaryData": { },
  • "excludeMarketingIndicator": true,
  • "audit": {
    },
  • "restrictions": [
    ],
  • "organizationType": "Corporation",
  • "organizationPurpose": "This is a description.",
  • "legalName": "Jane",
  • "tradingName": "Jane",
  • "registrationDate": "2022-04-17",
  • "establishmentDate": "2022-04-17",
  • "merchantCategory": "482",
  • "nAICSCode": "54",
  • "sector": "string",
  • "organizationProfile": {
    },
  • "contact": {
    },
  • "webPage": "http://portx.io",
  • "logo": {
    }
}

Response samples

Content type
application/json
{
  • "identifiers": [
    ],
  • "name": "Jane Birkin",
  • "shortName": "Jane",
  • "nameTemplateId": "1",
  • "nameSoundExId": "1",
  • "partyBranchId": "SEA_1",
  • "comment": "This is a description.",
  • "relatedParties": [
    ],
  • "postalAddresses": [
    ],
  • "relationshipId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "relationshipLeadIndicator": true,
  • "residenceType": "Domestic",
  • "taxInformation": {
    },
  • "powerOfAttorney": {
    },
  • "supplementaryData": { },
  • "excludeMarketingIndicator": true,
  • "audit": {
    },
  • "restrictions": [
    ],
  • "organizationType": "Corporation",
  • "organizationPurpose": "This is a description.",
  • "legalName": "Jane",
  • "tradingName": "Jane",
  • "registrationDate": "2022-04-17",
  • "establishmentDate": "2022-04-17",
  • "merchantCategory": "482",
  • "nAICSCode": "54",
  • "sector": "string",
  • "organizationProfile": {
    },
  • "contact": {
    },
  • "webPage": "http://portx.io",
  • "logo": {
    },
  • "organizationId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "status": "Queued"
}

Retrieves an Organization

Authorizations:
jwtopenIdConnect
path Parameters
organizationId
required
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Organization Identification

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Responses

Response samples

Content type
application/json
{
  • "identifiers": [
    ],
  • "name": "Jane Birkin",
  • "shortName": "Jane",
  • "nameTemplateId": "1",
  • "nameSoundExId": "1",
  • "partyBranchId": "SEA_1",
  • "comment": "This is a description.",
  • "relatedParties": [
    ],
  • "postalAddresses": [
    ],
  • "relationshipId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "relationshipLeadIndicator": true,
  • "residenceType": "Domestic",
  • "taxInformation": {
    },
  • "powerOfAttorney": {
    },
  • "supplementaryData": { },
  • "excludeMarketingIndicator": true,
  • "audit": {
    },
  • "restrictions": [
    ],
  • "organizationType": "Corporation",
  • "organizationPurpose": "This is a description.",
  • "legalName": "Jane",
  • "tradingName": "Jane",
  • "registrationDate": "2022-04-17",
  • "establishmentDate": "2022-04-17",
  • "merchantCategory": "482",
  • "nAICSCode": "54",
  • "sector": "string",
  • "organizationProfile": {
    },
  • "contact": {
    },
  • "webPage": "http://portx.io",
  • "logo": {
    },
  • "organizationId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "status": "Queued"
}

Updates an Organization

Use the JSON Merge Patch standard https://tools.ietf.org/html/rfc7396

Authorizations:
jwtopenIdConnect
path Parameters
organizationId
required
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Organization Identification

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Request Body schema: application/merge-patch+json
Array of objects (OrganizationIdentification)
Array
number
required
string [ 1 .. 35 ] characters
Example: "123-45-6789"

Unique and unambiguous identification of an organization.

schemeName
required
string [ 1 .. 35 ] characters
Example: "TaxIdentificationNumber"

Name of the identification scheme, in PascalCase form. Possible ISO compliant values are: BankPartyIdentification CentralBankIdentificationNumber ClearingIdentificationNumber CertificateOfIncorporationNumber CountryIdentificationCode CustomerNumber DataUniversalNumberingSystem EmployerIdentificationNumber GS1GLNIdentifier SIREN SIRET TaxIdentificationNumber BusinessDomainIdentifier BusinessOtherIdentification EmployerIdentificationNumber BICIdentifier LEIIdentifier

issuer
string
Example: "UnitedStates"

Entity that assigns the identification.

issueDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

expirationDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

name
string (PartyName) [ 1 .. 350 ] characters
Example: "Jane Birkin"

Name by which a party is known and which is usually used to identify that party.

shortName
string (PartyShortName) [ 1 .. 35 ] characters
Example: "Jane"

Short name or nickname by which a party is known and which is usually used to identify that party.

nameTemplateId
string (NameTemplateId) [ 1 .. 36 ] characters
Example: "1"

Template used to display the party name. This is an external id provided by the account servicer.

nameSoundExId
string (SoundExId) [ 1 .. 36 ] characters
Example: "1"

Identification of a SoundEx method develop for search attribute. SoundEx is a method used to find strings when the sound is known but the precise spelling is not. It searches out words with similar sounds based on phonetic assumptions about how certain letters are pronounced. It can be used to search names in a database, for example, where spellings and pronunciations for similar names may vary.

partyBranchId
string (ServicerBranchId) [ 1 .. 36 ] characters
Example: "SEA_1"

Identification of the account servicer institution at branch level or operation level.

comment
string [ 1 .. 1025 ] characters
Example: "This is a description."

Bank commnent of the party.

Array of objects (RelatedParty)
Array
partyId
required
string (Id) [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"
partyType
required
string (PartyType)
Example: "Person"

Possible values are: Person, Organization. Also other types of servicer internal entities: ServicerOfficer

partyName
string (PartyName) [ 1 .. 350 ] characters
Example: "Jane Birkin"

Name by which a party is known and which is usually used to identify that party.

partyRelationType
required
string (PartyRelationType) [ 1 .. 40 ] characters
Example: "PrimaryServicerOfficer"

Type of relation between parties. Possible values Between Organizations and persons are: ResponsibleParty, OrganizationOwner, ControlPerson, BeneficialOwner, PrimaryContact, SecondaryContact. For Trusts: Trustor, Trustee. Between organizations: ParentOrganization, Branch. Between parties and external entities: AccountOpenningOfficer, CustomerServiceOfficer, PrimaryServicerOfficer, SecondaryServicerOfficer, SalesPerson, ReferralOfficer. Between financial institutions: AffiliateFinancialInstitution, HoldingCompany. Between persons: Spouse.

partyRelationDescription
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
ownershipPercentage
string <= 23 characters ^100|(([1-9][0-9]{0,1})([.][0-9]{0,8}){0,1})$...
Example: "25"

Company Ownership Percentage. If the relation Type is BeneficialOwner the ownership percentage could be added. Ownership means any person with more than 25% equity in the legal entity.

Array of objects (PostalAddress)
Array
addressType
string
Example: "Postal"

Specifies the type of address, in PascalCase form. Possible ISO Compliant values are: PhysicalAddress, Postal, POBox, Residential, Permanent, Temporary, Business.

addressPurpose
string
Example: "Billing"

Specifies the purpose of an address, in PascalCase form. Possible ISO Compliant values are: MailTo, DeliveryTo, Billing, PlaceOfOperation, PlaceOfRegistration

primaryIndicator
boolean (PrimaryContactIndicator)

Indicates whether the contact informacion is primary.

department
string [ 1 .. 70 ] characters
Example: "A"

Identification of a division of a large Organization or building.

subDepartment
string [ 1 .. 70 ] characters
Example: "B"

Identification of a sub-division of a large Organization or building.

streetName
string [ 1 .. 70 ] characters
Example: "First Street"

Name of a street or thoroughfare.

firstCrossStreetName
string [ 1 .. 70 ] characters

Name of a the first cross street.

secondCrossStreetName
string [ 1 .. 70 ] characters
Example: "Second Street"

Name of a the second cross street.

buildingNumber
string [ 1 .. 16 ] characters
Example: "11407"

Number that identifies the position of a building or house on a street.

buildingName
string [ 1 .. 35 ] characters
Example: "Tall Tower"

Name of the building or house.

floor
string [ 1 .. 70 ] characters
Example: "20"

Floor or storey within a building.

postBox
string [ 1 .. 16 ] characters
Example: "MY779"

Numbered box in a post office, assigned to a person or Organization, where letters are kept until called for.

room
string [ 1 .. 70 ] characters
Example: "22"

Building room number.

postCode
string (PostCode) [ 1 .. 16 ] characters
Example: "97062-68"

Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.

censusTrack
string (CensusTrack) = 5 characters
Example: "04013216813"

A census tract, census area, census district or meshblock is a geographic region defined for the purpose of taking a census

cBSACode
string (CBSACode) = 5 characters
Example: "49780"

Core-based statistical area. Metropolitan statistical area (MSA) is the formal definition of a region that consists of a city and surrounding communities that are linked by social and economic factors. Micropolitan Statistical Areas (MISA) are CBSAs associated with at least one urban cluster that has a population of at least 10,000, but less than 50,000. The micropolitan statistical area comprises the central county or counties or equivalent entities containing the core, plus adjacent outlying counties having a high degree of social and economic integration with the central county as measured through commuting.

cBSAType
string (CBSAType) [ 1 .. 10 ] characters
Example: "MSA"

Type of Core-based statistical area. Possible values: MSA, MISA

foreignIndicator
boolean

Indicates whether the postal address is from a foreing country.

townName
string (TownName) [ 1 .. 35 ] characters
Example: "Tualatin"

Name of a built-up area, with defined boundaries, and a local government.

townLocationName
string [ 1 .. 35 ] characters
Example: "Clackamas"

Specific location name within the town.

districtName
string [ 1 .. 35 ] characters
Example: "Washington"

Identifies a subdivision within a country sub-division.

countrySubDivision
string (CountrySubdivision) [ 1 .. 35 ] characters
Example: "Oregon"

Name of a country subdivision such as state, region, county.

countrySubDivisionCode
string (CountrySubdivisionCode) ^[A-Z]{2,2}\-[0-9A-Z]{1,3}
Example: "AR-B"

Code to identify a name of a unit resulting from the division of a country, dependency, or other area of special geopolitical interest contained in ISO 3166-1, on the basis of country names obtained from the United Nations (ISO 3166-2: Country subdivision code).

country
string (CountryCode) ^([A-Z]{2,2})?$
Example: "US"

Country name obtained from the United Nations (ISO 3166, Alpha-2 code).

addressLine
Array of strings[ items [ 1 .. 70 ] characters ]
Example: ["11407 Sw Amu st, Suite MY777"]

Information that locates and identifies a specific address, as defined by postal services, presented in free format text.

object

The period of use of the address information.

relationshipId
string [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"

This id gives the ability to view a party’s total relationship with the bank. The relationship Id ties multiple parties together. This code is also used to reduce mailing costs during marketing campaigns to avoid sending duplicate materials to parties residing at the same address.

relationshipLeadIndicator
boolean

The relationship lead is often the primary account owner or the party with whom the bank have the most contact.

residenceType
string [ 1 .. 35 ] characters
Example: "Domestic"

Specifies the type of residence where the party has its permanent home or principal establishment. Possible ISO Complaian values are: Domestic, Foreign, Mixed

object (TaxPartyInformation)

Taxation parameters which apply to an individual person or to an organization.

tIN
string
Example: "778-62-8144"

A Taxpayer Identification Number

taxIdType
string [ 1 .. 50 ] characters
Example: "SocialSecurityNumber"

Identifies what type of tax ID is in the TIN field. Possible Values: SocialSecurityNumber, EmployerIdentificationNumber, IndividualTaxpayerIdentificationNumber, AdoptionTaxpayerIdentificationNumber, PreparerTaxpayerIdentificationNumber, ForeignTaxID

financialReportingIndicator
boolean

Whether the financial income for this party should be reported to the U.S. government (IRS) when related to an account in a way which requires reporting (for example, primary, joint ownership). Defaults to true if not specified.

tINStatus
string
Example: "Valid"

'The tax ID has been verified by the IRS. Possible values: Valid, NotValid, NotVerified, IRSWarning, TINApplied.

object (TINVerification)

IRS information about the TIN provided.

verificationAttemps
integer <= 10
Example: 1

The Tax Identification Verification Attempts is the number of times attempts have been made to verify the tax ID number.

bNoticeDates
Array of strings <date> (Date)
Example: ["2022-04-17"]
tINResultCode
string <= 3

TIN matching result codes

taxStatus
string
Example: "Valid"

Exempt, Retain, ExemptExpired, VoluntaryWithholding, Chapter3, Chapter4, C-Corp, S-Corp.

Array of objects (TaxForm)

Forms applied by the party

Array
formName
required
string [ 1 .. 10 ] characters
Example: "W-8"

Form name requested. Possible Values: W-8BEN, W-8BEN-E, W-8ECI, W-8EXP, W-8IMY, W-9, W-8, 1042-S, 1099-INT, 1099-OID.

taxRate
string <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Indicates the tax rate provided by the IRS on the form.

Array of objects (TaxFormCode)

Codes provided by the IRS on the form.

recipientGIIN
string (GIIN) [ 1 .. 34 ] characters ^([A-N,P-Z,0-9]){6}\.([A-N,P-Z,0-9]){5}\.(LE|...
Example: "ADN123.FG4FE3.LE.999"

Global intermediary identification number (GIIN).

recipientPostCode
string (PostCode) [ 1 .. 16 ] characters
Example: "97062-68"

Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.

recipientTownName
string (TownName) [ 1 .. 35 ] characters
Example: "Tualatin"

Name of a built-up area, with defined boundaries, and a local government.

certificationDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

expirationDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

Array of objects (TaxRegulation)
Array
name
required
string [ 1 .. 35 ] characters
Example: "Chapter4"
section
string [ 1 .. 10 ] characters
Example: "1471"

String that represent the section number.

Array of objects (WithholdingTax)
Array
withholdingTaxType
required
string (WithholdingTaxType) [ 1 .. 35 ] characters
Example: "NonResidentAlienTax"

Type of Withholding. Possible Values: ForeignAccountTaxComplianceAct, NonResidentAlienTax, BackUpWithholding, VoluntaryWithholding, Federal, State, Local, W-4.

withholdingRate
string <= 23 characters ^100|(([1-9][0-9]{0,1})([.][0-9]{0,8}){0,1})$...
Example: "25"

Rate applied on a basis amount to calculate the withholding.

withholdingAmount
string <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Withholding amount.

foreignIndicator
boolean

Indicates whether the party is a non-residen alien or a foreign entity.

countrySubDivision
string (CountrySubdivision) [ 1 .. 35 ] characters
Example: "Oregon"

Name of a country subdivision such as state, region, county.

countrySubDivisionCode
string (CountrySubdivisionCode) ^[A-Z]{2,2}\-[0-9A-Z]{1,3}
Example: "AR-B"

Code to identify a name of a unit resulting from the division of a country, dependency, or other area of special geopolitical interest contained in ISO 3166-1, on the basis of country names obtained from the United Nations (ISO 3166-2: Country subdivision code).

country
string (CountryCode) ^([A-Z]{2,2})?$
Example: "US"

Country name obtained from the United Nations (ISO 3166, Alpha-2 code).

supplementaryData
object (SupplementaryData)

Additional information that cannot be captured in the structured elements and/or any other specific block. If this information need to be converted in ISO Messages, must be ISO 20022 compliant: it requires development of a compliant message extension model and its components must be registered in the ISO 20022 Data Dictionary. https://www.iso20022.org/catalogue-messages/additional-content-messages/supplementary-data

object (PowerOfAttorney)

Document that transfers specific rights from a party to a person.

documentId
string (Id) [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"
documentReference
string [ 1 .. 35 ] characters

Document location.

version
string [ 1 .. 18 ] characters

Document version indentification.

signOffDate
string <date>
Example: "2022-04-17"

Signoff date of the document.

issueDate
string <date>
Example: "2022-04-17"

Issue date of the document.

purpose
string [ 1 .. 35 ] characters

Specifies the function of the document.

fromDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period starts.

upToDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period ends.

periodNumber
integer

Sequence number of the period.

object (Jurisdiction)

Area with a set of laws under the control of a system which are different from neighbouring areas

countrySubdivision
string (CountrySubdivision) [ 1 .. 35 ] characters
Example: "Oregon"

Name of a country subdivision such as state, region, county.

townName
string (TownName) [ 1 .. 35 ] characters
Example: "Tualatin"

Name of a built-up area, with defined boundaries, and a local government.

country
string (CountryCode) ^([A-Z]{2,2})?$
Example: "US"

Country name obtained from the United Nations (ISO 3166, Alpha-2 code).

authorizedPerson
string [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"

Person which is the holder of the power of attorney.

authorizedAccount
string [ 1 .. 36 ] characters
Example: "0dd926fe-1ca2-11ed-861d-0242ac120002"

Specifies the account on which the power of attorney applies.

supplementaryData
object (SupplementaryData)

Additional information that cannot be captured in the structured elements and/or any other specific block. If this information need to be converted in ISO Messages, must be ISO 20022 compliant: it requires development of a compliant message extension model and its components must be registered in the ISO 20022 Data Dictionary. https://www.iso20022.org/catalogue-messages/additional-content-messages/supplementary-data

excludeMarketingIndicator
boolean
object (Audit)

Resource Audit Information. Captures the creation, modification and maintenance details.

status
string (AuditStatus) [ 1 .. 35 ] characters

Maintenance status of a resource. Possible values: Requested, Created, Changed, Deleted

creationDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

lastModificacionChannel
string (CommunicationChannelName) [ 1 .. 35 ] characters
Example: "Email"

Channel used to communicate with a party. Possible Values: Email, Fax, File, Online, PostalService, LiveSupport, ATM, IVR, Kiosk, Mobile, OnlineBanking, Phone, SMS, Card, InPerson.

lastModificationDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

Array of objects (AuditChannel)

Activity audit throught comunication channles

Array
lastActivityDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

name
string (CommunicationChannelName) [ 1 .. 35 ] characters
Example: "Email"

Channel used to communicate with a party. Possible Values: Email, Fax, File, Online, PostalService, LiveSupport, ATM, IVR, Kiosk, Mobile, OnlineBanking, Phone, SMS, Card, InPerson.

activityType
string (AuditActivityType) [ 1 .. 35 ] characters

Maintenance activity of a resource. Possible values: Transaction, Modification, Deposit, Withdrawal.

amount
string (PositiveAmountInCents) <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: 0

Array of objects (Restriction)

Access and operation restrictions at Party level.

Array
name
required
string [ 1 .. 60 ] characters
Example: "WireTransferIn"

Name of the restriction in PascalCase. Possible values: WireTransferIn, WireTransferOut, ForeignIncomingWires, ForeignOutgoingWires, ACHTransfers, InternetBankingTransfer, InternetView, InternetInquiry, ForeignOutgoingIran, Withdrawals, Renew, Transfers

restrictionPurpose
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
enableIndicator
boolean
Example: true

Indicates whether the capability is allowed or not.

validFrom
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

validUntil
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

organizationType
required
string (OrganizationType)
Example: "Corporation"

Specifies the legal standing of the organization. Possible values are: Government, FinancialInstitution SoleProprietorship, UnincorporatedAssociation, LimitedLiabilityPartnership, LimitedLiabilityCompany, LimitedPartnership, FormalPartnership, GeneralPartnership, Business, Corporation, NotForProfit, ForProfit, NonProfit, Club, Supranational, Sovereign, Municipal, Province, State, County, National, ExemptionTrust, LivingTrust, EmployeeTrust, RevocableTrust, IrrovocableTrust, NakedTrust, FamilyTrust, BussinesTrust, CliffordTrust, FormalTrust.

organizationPurpose
string [ 1 .. 1025 ] characters
Example: "This is a description."

Description and purpose of an organization.

legalName
string [ 1 .. 35 ] characters
Example: "Jane"

Official name under which an organization is registered.

tradingName
string [ 1 .. 35 ] characters
Example: "Jane"

Name used by a business for commercial purposes, although its registered legal name, used for contracts and other formal situations, may be another.

registrationDate
string <date>
Example: "2022-04-17"

Date and time at which a given organization was officially registered.

establishmentDate
string <date>
Example: "2022-04-17"

Date when the Organization was established.

merchantCategory
string (MerchantCategoryCode) ^[0-9]{4,4}
Example: "482"

Category code conform to ISO 18245, related to the type of services or goods the merchant provides for the transaction.

nAICSCode
string (NAICSCode) ^[0-9]{2,2}
Example: "54"

The North American Industry Classification System (NAICS) is the standard used by Federal statistical agencies in classifying business establishments for the purpose of collecting, analyzing, and publishing statistical data related to the U.S. business economy.

sector
string (OrganizationSector)

A sector is an area of the economy in which businesses share the same or related business activity, product, or service. Energy, Materials, Industrials, ConsumerDiscretionary, ConsumerStaples, HealthCare, Financials, InformationTechnology, TelecommunicationServices, Utilities, RealEstate.

object (OrganizationProfile)

Information to support Know Your Customer (KYC) processes.

riskLevel
string (RiskLevel) [ 1 .. 35 ] characters
Example: "Permanent"

Specifies the customer’s money laundering risk. Possible values: High, Medium, Low, None.

bSARiskCode
integer (BSARiskCode) <= 10
Example: 0

Used to identify customers that present a risk to the bank as defined by the Bank Secrecy Act. For example, use this code to identify and monitor accounts suspected of fraud, kiting or money laundering.

object (CreditReview)

A credit review is a periodic assessment of an individual’s or businesses' credit profile.

object (Frequency)

Specifies an event frequency

lastReviewDate
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time if the last credit review.

nextReviewDate
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time if the next credit review.

creditQuality
string (CreditQuality) [ 1 .. 35 ] characters
Example: "UpperMediumGrade"

Credit quality rating of an issuer or financial obligation. Possible Values: DefaultImminent, ExtremelySpeculative, HighGrade, HighlySpeculative, InDefault, LowerMediumGrade, NonInvestmentGradeSpeculative, Prime, SubstantialRisk, UpperMediumGrade

creditScore
integer
creditBureauReportCode
string

Code used for reporting to the credit bureaus. This code is used to report the trade line of a credit account to the credit bureau agencies.

oFACReportingIndicator
boolean

Indicates whether the party is to be excluded from OFAC Reporting.

previousFinancialInstitution
string (PartyName) [ 1 .. 350 ] characters
Example: "Jane Birkin"

Name by which a party is known and which is usually used to identify that party.

referredByWhom
string (PartyName) [ 1 .. 350 ] characters
Example: "Jane Birkin"

Name by which a party is known and which is usually used to identify that party.

moneyLaunderingCheck
string (MoneyLaunderingCheck)
Example: "AuthorizedCredit"

Specifies the status of money laundering identification procedures. Possible Values: PassedNotChecked, ExemptBelowLimit, ClientMoneyTypeExempt, AuthorizedCredit, PostalOrElectronicPaymentExempt

knowYourCustomerCheck
string (KnowYourCustomerCheckType) [ 1 .. 36 ] characters
Example: "Ordinary"

Specifies the type of Know Your Customer (KYC) or anti-money laundering due diligence to which the investor has been subjected. Possible Values: Ordinary, Simple, Enhanced.

object (TemporalDuration)

Describes a temporal duration.

unit
required
string [ 1 .. 36 ] characters
Example: "Months"

Unit that describes the duration.

value
required
integer <= 999

Value of the duration in number of units.

dateAtCurrentAddress
string <date>
Example: "2022-04-17"

Date of Residence in the current household.

sourceOfWealth
string [ 1 .. 1025 ] characters
Example: "This is a description."

Indicates the main sources of the money.

politicalAffiliation
string

Indicates the political affiliation of the Party. Possible values could be: Democrat, Independent, Republican.

lostCustomerDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

lostCustomerReason
string (LostCustomerReason) [ 1 .. 35 ] characters
Example: "Deceased"

Used for regulatory purposes by the bank to track how long closed account history has been maintained for a customer. Possible values are: Competition, Deceased, Dissatisfied, Moved, MergedEntity, CeasedOperation

Array of objects (ServicerAlert)

Customer alerts to be received by the account servicer.

Array
alertName
string (AlertName) [ 1 .. 35 ] characters
Example: "CreditBureauAlert"

An alert notification received by the bank. Possible values: CreditBureauAlert, CustomerAlert, PaymentCard

alertType
string (AlertType) [ 1 .. 35 ] characters
Example: "Warning"

An alert notification type. Possible values: Warning, Urgent.

alertCode
string [ 1 .. 36 ] characters
message
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
lastAlertDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

legalEntityReportingIndicator
boolean

Indicates whether the party is required to be reported as a legal entity.

numberOfEmployees
integer
Example: 100

Number of employees of the corporation.

anualSales
string (AmountInCents) <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: -9999999999999.99999999

services
string [ 1 .. 1025 ] characters
Example: "This is a description."

Description of the services that are offered for sale.

goods
string [ 1 .. 1025 ] characters
Example: "This is a description."

Description of the goods that are offered for sale.

Array of objects (Place)

Places where the goods and services are sold.

Array
countrySubdivision
string (CountrySubdivision) [ 1 .. 35 ] characters
Example: "Oregon"

Name of a country subdivision such as state, region, county.

townName
string (TownName) [ 1 .. 35 ] characters
Example: "Tualatin"

Name of a built-up area, with defined boundaries, and a local government.

country
string (CountryCode) ^([A-Z]{2,2})?$
Example: "US"

Country name obtained from the United Nations (ISO 3166, Alpha-2 code).

object

Business e-mails and phone numbers. Configuration of communication channels at organization level.

Array of objects (Phone)
Array
number
required
string (PhoneNumber) ^\+[0-9]{1,3}-[0-9()+\-]{1,30}$
Example: "+1-415-731359"

The collection of information which identifies a specific phone or FAX number as defined by telecom services.

extension
string <= 5 characters

Phone Number Extension.

phoneType
string [ 1 .. 35 ] characters

Type of phone address. Possible values are:
Mobile, Landline, Fax, Pager, Modem

phonePurpose
string [ 1 .. 35 ] characters

Purpose of the phone address. Possible values are: Business, Personal, International.

primaryIndicator
boolean (PrimaryContactIndicator)

Indicates whether the contact informacion is primary.

object (HourOfTheDay)
comment
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
object

The period of use of the phone information.

Array of objects (Email)
Array
emailAddress
string [ 1 .. 2048 ] characters

Address for electronic mail (e-mail).

emailPurpose
string [ 1 .. 35 ] characters
Example: "Statements"

Purpose of the e-mail address. Possible values: Marketing, Statements, Business, Administrative

primaryIndicator
boolean (PrimaryContactIndicator)

Indicates whether the contact informacion is primary.

Array of objects (CommunicationChannel)
Array
channel
string (CommunicationChannelName) [ 1 .. 35 ] characters
Example: "Email"

Channel used to communicate with a party. Possible Values: Email, Fax, File, Online, PostalService, LiveSupport, ATM, IVR, Kiosk, Mobile, OnlineBanking, Phone, SMS, Card, InPerson.

channelIdentification
string (CommunicationChannelIdentification) [ 1 .. 128 ] characters
Example: "011-02010020202"

Communication value such as phone number or email address.

channelPurpose
string (CommunicationChannelPurpose) [ 1 .. 40 ] characters
Example: "Alert"

Communication purpose of the channel. Possible values: Alerts, PrivacyNotices

codeWord
string

A party is asked for a codeword to verify their identity trought a communication channel

alertIndicator
any

Indicates whether the channel is used for enterprise alerts

object (CommunicationChannelHistory)
primaryIndicator
boolean (PrimaryContactIndicator)

Indicates whether the contact informacion is primary.

webPage
string^[(http(s)?):\/\/(www\.)?a-zA-Z0-9@:%._\+~#=]...
Example: "http://portx.io"

Business web page

logo
string <byte> (ComercialLogo) [ 1 .. 32768 ] characters
Example: {"0":105,"1":86,"2":66,"3":79,"4":82,"5":119,"6":48,"7":75,"8":71,"9":103,"10":111,"11":65,"12":65,"13":65,"14":65,"15":78,"16":83,"17":85,"18":104,"19":69,"20":85,"21":103,"22":65,"23":65,"24":65,"25":90,"26":52,"27":65,"28":65,"29":65,"30":66,"31":111,"32":67,"33":65,"34":77,"35":65,"36":65,"37":65,"38":68,"39":50,"40":72,"41":109,"42":97,"43":78,"44":65,"45":65,"46":65,"47":65,"48":66,"49":71,"50":100,"51":66,"52":84,"53":85,"54":69,"55":65,"56":65,"57":76,"58":71,"59":80,"60":67,"61":47,"62":120,"63":104,"64":66,"65":81,"66":65,"67":65,"68":65,"69":65,"70":70,"71":122,"72":85,"73":107,"74":100,"75":67,"76":65,"77":75,"78":55,"79":79,"80":72,"81":79,"82":107,"83":65,"84":65,"85":65,"86":68,"87":56,"88":85,"89":69,"90":120,"91":85,"92":82,"93":81,"94":65,"95":65,"96":65,"97":70,"98":68,"99":80,"100":51,"101":49,"102":67,"103":47,"104":51,"105":119,"106":65,"107":81,"108":77,"109":65,"110":65,"111":81,"112":73,"113":65,"114":65,"115":90,"116":75,"117":86,"118":68,"119":72,"120":53,"121":119,"122":65,"123":89,"124":75,"125":70,"126":68,"127":70,"128":54,"129":108,"130":68,"131":70,"132":53,"133":65,"134":65,"135":86,"136":75,"137":103,"138":65,"139":86,"140":74,"141":86,"142":68,"143":72,"144":53,"145":49,"146":68,"147":72,"148":52,"149":48,"150":122,"151":68,"152":53,"153":119,"154":65,"155":89,"156":76,"157":65,"158":65,"159":89,"160":75,"161":70,"162":68,"163":71,"164":53,"165":85,"166":122,"167":71,"168":53,"169":81,"170":77,"171":87,"172":76,"173":81,"174":65,"175":87,"176":76,"177":81,"178":65,"179":87,"180":75,"181":81,"182":65,"183":89,"184":75,"185":49,"186":68,"187":72,"188":53,"189":49,"190":68,"191":72,"192":53,"193":69,"194":51,"195":70,"196":53,"197":48,"198":51,"199":70,"200":53,"201":65,"202":77,"203":89,"204":75,"205":103,"206":65,"207":89,"208":75,"209":108,"210":68,"211":73,"212":54,"213":65,"214":73,"215":88,"216":76,"217":70,"218":68,"219":73,"220":53,"221":108,"222":68,"223":71,"224":53,"225":107,"226":51,"227":71,"228":53,"229":103,"230":73,"231":90,"232":75,"233":119,"234":73,"235":90,"236":75,"237":81,"238":73,"239":88,"240":75,"241":119,"242":65,"243":88,"244":75,"245":49,"246":68,"247":74,"248":53,"249":119,"250":73,"251":89,"252":76,"253":65,"254":73,"255":89,"256":75,"257":108,"258":68,"259":72,"260":53,"261":85,"262":55,"263":70,"264":53,"265":48,"266":55,"267":70,"268":53,"269":81,"270":73,"271":89,"272":76,"273":65,"274":73,"275":89,"276":75,"277":107,"278":55,"279":73,"280":54,"281":69,"282":55,"283":71,"284":54,"285":65,"286":73,"287":90,"288":75,"289":119,"290":73,"291":88,"292":75,"293":48,"294":55,"295":71,"296":53,"297":103,"298":73,"299":90,"300":76,"301":65,"302":73,"303":90,"304":75,"305":103,"306":73,"307":88,"308":75,"309":107,"310":47,"311":72,"312":54,"313":85,"314":47,"315":72,"316":53,"317":119,"318":73,"319":89,"320":75,"321":119,"322":73,"323":89,"324":75,"325":107,"326":55,"327":71,"328":53,"329":119,"330":73,"331":89,"332":75,"333":119,"334":73,"335":89,"336":75,"337":85,"338":47,"339":73,"340":54,"341":69,"342":47,"343":71,"344":54,"345":65,"346":69,"347":90,"348":76,"349":65,"350":69,"351":88,"352":75,"353":103,"354":69,"355":88,"356":75,"357":107,"358":47,"359":72,"360":53,"361":119,"362":69,"363":89,"364":75,"365":48,"366":47,"367":73,"368":53,"369":107,"370":47,"371":71,"372":53,"373":103,"374":73,"375":90,"376":75,"377":119,"378":69,"379":90,"380":75,"381":119,"382":69,"383":88,"384":75,"385":48,"386":47,"387":72,"388":53,"389":119,"390":73,"391":89,"392":75,"393":119,"394":69,"395":89,"396":75,"397":48,"398":47,"399":73,"400":54,"401":69,"402":47,"403":71,"404":54,"405":65,"406":73,"407":90,"408":75,"409":119,"410":73,"411":88,"412":76,"413":65,"414":73,"415":88,"416":75,"417":119,"418":69,"419":88,"420":76,"421":69,"422":47,"423":72,"424":53,"425":119,"426":73,"427":89,"428":75,"429":54,"430":111,"431":85,"432":72,"433":77,"434":107,"435":65,"436":65,"437":65,"438":66,"439":83,"440":100,"441":70,"442":74,"443":79,"444":85,"445":119,"446":65,"447":81,"448":69,"449":66,"450":65,"451":81,"452":72,"453":121,"454":65,"455":103,"456":77,"457":68,"458":65,"459":119,"460":77,"461":69,"462":66,"463":65,"464":81,"465":69,"466":66,"467":65,"468":85,"469":70,"470":66,"471":81,"472":85,"473":70,"474":66,"475":102,"476":89,"477":71,"478":66,"479":103,"480":89,"481":71,"482":66,"483":103,"484":98,"485":50,"486":57,"487":119,"488":99,"489":72,"490":66,"491":119,"492":99,"493":72,"494":66,"495":119,"496":102,"497":51,"498":57,"499":47,"500":103,"501":73,"502":67,"503":65,"504":103,"505":73,"506":67,"507":80,"508":106,"509":52,"510":43,"511":80,"512":107,"513":74,"514":67,"515":81,"516":107,"517":74,"518":43,"519":102,"520":110,"521":53,"522":43,"523":103,"524":111,"525":75,"526":67,"527":118,"528":114,"529":54,"530":43,"531":118,"532":115,"533":76,"534":43,"535":47,"536":122,"537":56,"538":47,"539":80,"540":122,"541":56,"542":47,"543":102,"544":51,"545":57,"546":47,"547":118,"548":55,"549":43,"550":47,"551":118,"552":55,"553":43,"554":47,"555":77,"556":49,"557":99,"558":87,"559":116,"560":65,"561":65,"562":65,"563":73,"564":49,"565":48,"566":108,"567":69,"568":81,"569":86,"570":82,"571":52,"572":50,"573":117,"574":50,"575":100,"576":102,"577":51,"578":47,"579":84,"580":78,"581":104,"582":68,"583":71,"584":66,"585":81,"586":107,"587":50,"588":84,"589":81,"590":115,"591":50,"592":106,"593":65,"594":74,"595":90,"596":80,"597":68,"598":112,"599":71,"600":70,"601":56,"602":112,"603":111,"604":117,"605":112,"606":73,"607":117,"608":120,"609":81,"610":78,"611":71,"612":73,"613":97,"614":90,"615":76,"616":71,"617":112,"618":80,"619":43,"620":121,"621":118,"622":116,"623":47,"624":76,"625":47,"626":115,"627":65,"628":88,"629":83,"630":80,"631":70,"632":79,"633":117,"634":108,"635":79,"636":80,"637":113,"638":88,"639":57,"640":103,"641":79,"642":55,"643":80,"644":117,"645":110,"646":89,"647":99,"648":80,"649":100,"650":76,"651":112,"652":113,"653":43,"654":100,"655":107,"656":82,"657":51,"658":84,"659":80,"660":116,"661":88,"662":70,"663":48,"664":81,"665":122,"666":66,"667":69,"668":78,"669":78,"670":86,"671":101,"672":102,"673":80,"674":112,"675":85,"676":104,"677":77,"678":67,"679":70,"680":118,"681":103,"682":72,"683":80,"684":122,"685":49,"686":57,"687":121,"688":88,"689":80,"690":119,"691":73,"692":117,"693":80,"694":103,"695":119,"696":116,"697":68,"698":115,"699":121,"700":43,"701":107,"702":65,"703":76,"704":102,"705":111,"706":55,"707":113,"708":88,"709":55,"710":115,"711":78,"712":88,"713":80,"714":118,"715":56,"716":99,"717":87,"718":104,"719":51,"720":90,"721":78,"722":121,"723":99,"724":101,"725":117,"726":118,"727":104,"728":78,"729":54,"730":68,"731":66,"732":56,"733":48,"734":57,"735":111,"736":100,"737":110,"738":82,"739":115,"740":81,"741":70,"742":51,"743":56,"744":98,"745":116,"746":48,"747":114,"748":100,"749":54,"750":69,"751":114,"752":82,"753":54,"754":72,"755":86,"756":56,"757":84,"758":69,"759":69,"760":71,"761":118,"762":71,"763":111,"764":76,"765":104,"766":100,"767":65,"768":54,"769":118,"770":82,"771":68,"772":109,"773":120,"774":78,"775":105,"776":68,"777":87,"778":114,"779":71,"780":109,"781":110,"782":121,"783":49,"784":68,"785":56,"786":107,"787":101,"788":66,"789":103,"790":56,"791":80,"792":72,"793":100,"794":83,"795":67,"796":54,"797":47,"798":117,"799":66,"800":67,"801":122,"802":122,"803":84,"804":119,"805":90,"806":56,"807":43,"808":111,"809":80,"810":112,"811":84,"812":97,"813":80,"814":66,"815":114,"816":81,"817":65,"818":101,"819":47,"820":66,"821":67,"822":53,"823":103,"824":105,"825":48,"826":78,"827":50,"828":117,"829":73,"830":54,"831":103,"832":119,"833":102,"834":77,"835":54,"836":116,"837":68,"838":89,"839":102,"840":72,"841":102,"842":119,"843":99,"844":117,"845":79,"846":65,"847":54,"848":120,"849":74,"850":116,"851":122,"852":88,"853":117,"854":115,"855":116,"856":67,"857":108,"858":121,"859":119,"860":70,"861":68,"862":112,"863":119,"864":116,"865":78,"866":52,"867":79,"868":80,"869":97,"870":50,"871":108,"872":102,"873":116,"874":82,"875":52,"876":119,"877":87,"878":113,"879":57,"880":116,"881":81,"882":77,"883":88,"884":77,"885":65,"886":101,"887":114,"888":117,"889":82,"890":121,"891":52,"892":89,"893":71,"894":108,"895":48,"896":52,"897":65,"898":68,"899":88,"900":51,"901":99,"902":65,"903":70,"904":55,"905":80,"906":71,"907":101,"908":98,"909":82,"910":107,"911":90,"912":117,"913":77,"914":66,"915":68,"916":82,"917":70,"918":77,"919":117,"920":54,"921":50,"922":48,"923":47,"924":99,"925":77,"926":69,"927":121,"928":54,"929":89,"930":65,"931":73,"932":49,"933":54,"934":68,"935":90,"936":116,"937":104,"938":76,"939":97,"940":117,"941":65,"942":53,"943":99,"944":72,"945":47,"946":70,"947":89,"948":98,"949":52,"950":69,"951":76,"952":108,"953":107,"954":119,"955":72,"956":112,"957":71,"958":55,"959":102,"960":68,"961":108,"962":122,"963":103,"964":75,"965":89,"966":89,"967":77,"968":99,"969":65,"970":50,"971":97,"972":98,"973":88,"974":43,"975":69,"976":57,"977":118,"978":86,"979":70,"980":66,"981":47,"982":99,"983":68,"984":70,"985":49,"986":120,"987":110,"988":79,"989":115,"990":66,"991":98,"992":98,"993":121,"994":66,"995":85,"996":51,"997":119,"998":43,"999":116,"1000":54,"1001":52,"1002":56,"1003":79,"1004":48,"1005":78,"1006":98,"1007":98,"1008":77,"1009":72,"1010":68,"1011":66,"1012":70,"1013":100,"1014":65,"1015":66,"1016":49,"1017":110,"1018":111,"1019":76,"1020":90,"1021":116,"1022":118,"1023":86,"1024":48,"1025":65,"1026":70,"1027":121,"1028":97,"1029":57,"1030":111,"1031":49,"1032":52,"1033":111,"1034":74,"1035":109,"1036":110,"1037":71,"1038":90,"1039":90,"1040":116,"1041":112,"1042":55,"1043":71,"1044":51,"1045":120,"1046":85,"1047":100,"1048":49,"1049":76,"1050":76,"1051":101,"1052":117,"1053":106,"1054":120,"1055":99,"1056":107,"1057":70,"1058":97,"1059":68,"1060":49,"1061":115,"1062":106,"1063":78,"1064":122,"1065":98,"1066":121,"1067":99,"1068":47,"1069":82,"1070":56,"1071":110,"1072":120,"1073":97,"1074":118,"1075":85,"1076":102,"1077":107,"1078":112,"1079":99,"1080":47,"1081":99,"1082":120,"1083":86,"1084":56,"1085":52,"1086":101,"1087":117,"1088":112,"1089":115,"1090":104,"1091":111,"1092":76,"1093":72,"1094":81,"1095":98,"1096":75,"1097":90,"1098":114,"1099":86,"1100":84,"1101":109,"1102":85,"1103":52,"1104":97,"1105":75,"1106":67,"1107":68,"1108":89,"1109":82,"1110":49,"1111":116,"1112":105,"1113":87,"1114":98,"1115":98,"1116":84,"1117":66,"1118":101,"1119":106,"1120":68,"1121":120,"1122":50,"1123":107,"1124":82,"1125":109,"1126":108,"1127":82,"1128":79,"1129":88,"1130":109,"1131":83,"1132":50,"1133":56,"1134":55,"1135":116,"1136":54,"1137":84,"1138":56,"1139":48,"1140":88,"1141":50,"1142":57,"1143":67,"1144":90,"1145":120,"1146":81,"1147":122,"1148":90,"1149":75,"1150":105,"1151":100,"1152":111,"1153":49,"1154":70,"1155":75,"1156":104,"1157":52,"1158":52,"1159":88,"1160":98,"1161":50,"1162":116,"1163":88,"1164":79,"1165":104,"1166":104,"1167":84,"1168":54,"1169":65,"1170":66,"1171":104,"1172":118,"1173":101,"1174":48,"1175":122,"1176":99,"1177":81,"1178":72,"1179":52,"1180":82,"1181":88,"1182":79,"1183":69,"1184":81,"1185":74,"1186":50,"1187":74,"1188":48,"1189":55,"1190":107,"1191":57,"1192":54,"1193":68,"1194":78,"1195":80,"1196":111,"1197":66,"1198":77,"1199":100,"1200":53,"1201":82,"1202":71,"1203":74,"1204":102,"1205":75,"1206":120,"1207":89,"1208":71,"1209":77,"1210":80,"1211":83,"1212":111,"1213":90,"1214":55,"1215":50,"1216":85,"1217":120,"1218":56,"1219":53,"1220":87,"1221":50,"1222":57,"1223":51,"1224":117,"1225":76,"1226":106,"1227":65,"1228":56,"1229":70,"1230":86,"1231":116,"1232":65,"1233":114,"1234":85,"1235":77,"1236":106,"1237":98,"1238":98,"1239":108,"1240":74,"1241":65,"1242":57,"1243":52,"1244":111,"1245":113,"1246":115,"1247":56,"1248":89,"1249":107,"1250":56,"1251":43,"1252":43,"1253":69,"1254":119,"1255":53,"1256":74,"1257":72,"1258":87,"1259":116,"1260":69,"1261":90,"1262":69,"1263":79,"1264":114,"1265":78,"1266":89,"1267":98,"1268":71,"1269":120,"1270":101,"1271":89,"1272":118,"1273":117,"1274":118,"1275":69,"1276":113,"1277":77,"1278":43,"1279":84,"1280":109,"1281":101,"1282":117,"1283":53,"1284":74,"1285":110,"1286":108,"1287":109,"1288":111,"1289":53,"1290":104,"1291":84,"1292":72,"1293":106,"1294":71,"1295":71,"1296":48,"1297":116,"1298":118,"1299":122,"1300":43,"1301":100,"1302":47,"1303":80,"1304":111,"1305":72,"1306":117,"1307":57,"1308":55,"1309":87,"1310":105,"1311":57,"1312":116,"1313":100,"1314":110,"1315":56,"1316":65,"1317":117,"1318":99,"1319":50,"1320":122,"1321":105,"1322":48,"1323":78,"1324":78,"1325":85,"1326":110,"1327":100,"1328":53,"1329":78,"1330":70,"1331":43,"1332":113,"1333":76,"1334":115,"1335":56,"1336":56,"1337":97,"1338":107,"1339":43,"1340":118,"1341":99,"1342":109,"1343":112,"1344":55,"1345":84,"1346":102,"1347":119,"1348":84,"1349":118,"1350":116,"1351":79,"1352":100,"1353":65,"1354":67,"1355":97,"1356":98,"1357":89,"1358":57,"1359":53,"1360":53,"1361":90,"1362":108,"1363":78,"1364":71,"1365":104,"1366":67,"1367":118,"1368":73,"1369":82,"1370":114,"1371":115,"1372":111,"1373":90,"1374":115,"1375":56,"1376":117,"1377":108,"1378":84,"1379":106,"1380":76,"1381":111,"1382":47,"1383":52,"1384":88,"1385":90,"1386":47,"1387":101,"1388":112,"1389":78,"1390":83,"1391":87,"1392":71,"1393":55,"1394":121,"1395":68,"1396":113,"1397":81,"1398":116,"1399":99,"1400":55,"1401":47,"1402":77,"1403":57,"1404":122,"1405":71,"1406":80,"1407":53,"1408":117,"1409":116,"1410":67,"1411":116,"1412":72,"1413":50,"1414":68,"1415":97,"1416":54,"1417":113,"1418":71,"1419":98,"1420":80,"1421":74,"1422":113,"1423":74,"1424":117,"1425":111,"1426":89,"1427":56,"1428":121,"1429":113,"1430":49,"1431":101,"1432":112,"1433":106,"1434":99,"1435":112,"1436":77,"1437":53,"1438":101,"1439":109,"1440":70,"1441":76,"1442":55,"1443":104,"1444":89,"1445":76,"1446":49,"1447":70,"1448":106,"1449":72,"1450":54,"1451":66,"1452":119,"1453":47,"1454":100,"1455":86,"1456":69,"1457":55,"1458":99,"1459":104,"1460":106,"1461":108,"1462":116,"1463":117,"1464":56,"1465":104,"1466":119,"1467":51,"1468":79,"1469":79,"1470":86,"1471":82,"1472":54,"1473":80,"1474":111,"1475":105,"1476":118,"1477":99,"1478":85,"1479":110,"1480":56,"1481":122,"1482":57,"1483":108,"1484":84,"1485":116,"1486":54,"1487":66,"1488":119,"1489":88,"1490":112,"1491":55,"1492":122,"1493":43,"1494":103,"1495":88,"1496":122,"1497":71,"1498":43,"1499":122,"1500":99,"1501":51,"1502":72,"1503":110,"1504":121,"1505":86,"1506":118,"1507":53,"1508":43,"1509":119,"1510":54,"1511":48,"1512":81,"1513":75,"1514":50,"1515":50,"1516":121,"1517":100,"1518":110,"1519":103,"1520":119,"1521":90,"1522":99,"1523":101,"1524":50,"1525":71,"1526":120,"1527":108,"1528":66,"1529":83,"1530":111,"1531":51,"1532":57,"1533":113,"1534":82,"1535":53,"1536":53,"1537":108,"1538":115,"1539":107,"1540":50,"1541":89,"1542":70,"1543":120,"1544":43,"1545":65,"1546":119,"1547":75,"1548":74,"1549":97,"1550":81,"1551":71,"1552":72,"1553":54,"1554":116,"1555":72,"1556":100,"1557":66,"1558":48,"1559":105,"1560":113,"1561":97,"1562":97,"1563":51,"1564":72,"1565":74,"1566":88,"1567":97,"1568":51,"1569":75,"1570":121,"1571":51,"1572":78,"1573":117,"1574":99,"1575":50,"1576":48,"1577":52,"1578":111,"1579":56,"1580":88,"1581":120,"1582":81,"1583":113,"1584":84,"1585":84,"1586":49,"1587":90,"1588":105,"1589":70,"1590":104,"1591":90,"1592":55,"1593":112,"1594":122,"1595":74,"1596":51,"1597":83,"1598":57,"1599":87,"1600":116,"1601":74,"1602":51,"1603":116,"1604":50,"1605":117,"1606":83,"1607":90,"1608":47,"1609":122,"1610":69,"1611":55,"1612":66,"1613":86,"1614":99,"1615":111,"1616":112,"1617":117,"1618":70,"1619":51,"1620":67,"1621":47,"1622":69,"1623":100,"1624":57,"1625":120,"1626":98,"1627":84,"1628":87,"1629":119,"1630":101,"1631":90,"1632":50,"1633":107,"1634":120,"1635":48,"1636":56,"1637":74,"1638":111,"1639":75,"1640":49,"1641":85,"1642":54,"1643":98,"1644":99,"1645":51,"1646":84,"1647":121,"1648":105,"1649":74,"1650":89,"1651":53,"1652":88,"1653":83,"1654":106,"1655":81,"1656":57,"1657":110,"1658":90,"1659":104,"1660":113,"1661":83,"1662":56,"1663":51,"1664":77,"1665":53,"1666":65,"1667":98,"1668":116,"1669":102,"1670":75,"1671":73,"1672":66,"1673":57,"1674":74,"1675":112,"1676":68,"1677":86,"1678":90,"1679":53,"1680":71,"1681":109,"1682":77,"1683":49,"1684":118,"1685":99,"1686":110,"1687":100,"1688":75,"1689":55,"1690":70,"1691":87,"1692":70,"1693":111,"1694":104,"1695":48,"1696":48,"1697":71,"1698":86,"1699":57,"1700":109,"1701":69,"1702":99,"1703":114,"1704":106,"1705":47,"1706":103,"1707":76,"1708":87,"1709":115,"1710":115,"1711":116,"1712":77,"1713":113,"1714":108,"1715":109,"1716":71,"1717":111,"1718":47,"1719":76,"1720":109,"1721":87,"1722":85,"1723":99,"1724":54,"1725":79,"1726":87,"1727":82,"1728":74,"1729":53,"1730":105,"1731":85,"1732":86,"1733":82,"1734":54,"1735":86,"1736":114,"1737":112,"1738":47,"1739":74,"1740":51,"1741":87,"1742":116,"1743":103,"1744":80,"1745":51,"1746":109,"1747":68,"1748":66,"1749":78,"1750":99,"1751":82,"1752":98,"1753":120,"1754":49,"1755":66,"1756":76,"1757":52,"1758":43,"1759":85,"1760":114,"1761":118,"1762":56,"1763":50,"1764":68,"1765":104,"1766":54,"1767":100,"1768":71,"1769":57,"1770":73,"1771":54,"1772":116,"1773":81,"1774":119,"1775":102,"1776":81,"1777":74,"1778":53,"1779":78,"1780":47,"1781":98,"1782":48,"1783":119,"1784":121,"1785":75,"1786":80,"1787":81,"1788":57,"1789":102,"1790":71,"1791":87,"1792":108,"1793":78,"1794":114,"1795":113,"1796":86,"1797":66,"1798":97,"1799":101,"1800":85,"1801":113,"1802":68,"1803":97,"1804":56,"1805":83,"1806":70,"1807":102,"1808":102,"1809":90,"1810":77,"1811":48,"1812":53,"1813":110,"1814":47,"1815":43,"1816":97,"1817":66,"1818":111,"1819":56,"1820":112,"1821":98,"1822":85,"1823":120,"1824":66,"1825":110,"1826":104,"1827":53,"1828":102,"1829":118,"1830":73,"1831":110,"1832":68,"1833":52,"1834":82,"1835":43,"1836":75,"1837":79,"1838":78,"1839":51,"1840":106,"1841":87,"1842":67,"1843":57,"1844":114,"1845":84,"1846":66,"1847":118,"1848":122,"1849":103,"1850":71,"1851":97,"1852":120,"1853":74,"1854":67,"1855":101,"1856":90,"1857":71,"1858":120,"1859":114,"1860":87,"1861":82,"1862":116,"1863":68,"1864":104,"1865":120,"1866":97,"1867":65,"1868":80,"1869":73,"1870":108,"1871":72,"1872":101,"1873":82,"1874":83,"1875":54,"1876":116,"1877":106,"1878":105,"1879":104,"1880":108,"1881":88,"1882":105,"1883":68,"1884":104,"1885":50,"1886":116,"1887":87,"1888":76,"1889":110,"1890":65,"1891":97,"1892":80,"1893":89,"1894":87,"1895":100,"1896":115,"1897":66,"1898":74,"1899":122,"1900":100,"1901":114,"1902":77,"1903":110,"1904":116,"1905":51,"1906":86,"1907":117,"1908":101,"1909":86,"1910":83,"1911":54,"1912":112,"1913":113,"1914":81,"1915":50,"1916":69,"1917":120,"1918":49,"1919":69,"1920":47,"1921":115,"1922":119,"1923":50,"1924":55,"1925":78,"1926":121,"1927":122,"1928":109,"1929":74,"1930":48,"1931":107,"1932":53,"1933":101,"1934":66,"1935":87,"1936":110,"1937":66,"1938":105,"1939":122,"1940":71,"1941":121,"1942":68,"1943":80,"1944":66,"1945":50,"1946":57,"1947":111,"1948":85,"1949":80,"1950":71,"1951":117,"1952":67,"1953":97,"1954":109,"1955":78,"1956":81,"1957":103,"1958":101,"1959":103,"1960":50,"1961":82,"1962":98,"1963":120,"1964":121,"1965":112,"1966":80,"1967":68,"1968":53,"1969":67,"1970":90,"1971":51,"1972":81,"1973":47,"1974":67,"1975":113,"1976":69,"1977":118,"1978":109,"1979":78,"1980":115,"1981":102,"1982":75,"1983":107,"1984":51,"1985":115,"1986":65,"1987":97,"1988":83,"1989":71,"1990":56,"1991":57,"1992":102,"1993":67,"1994":115,"1995":100,"1996":52,"1997":117,"1998":66,"1999":54,"2000":104,"2001":51,"2002":49,"2003":122,"2004":106,"2005":108,"2006":89,"2007":101,"2008":117,"2009":86,"2010":97,"2011":119,"2012":117,"2013":110,"2014":68,"2015":67,"2016":74,"2017":109,"2018":98,"2019":49,"2020":75,"2021":77,"2022":51,"2023":121,"2024":120,"2025":48,"2026":104,"2027":53,"2028":87,"2029":104,"2030":78,"2031":118,"2032":121,"2033":49,"2034":73,"2035":78,"2036":85,"2037":67,"2038":73,"2039":43,"2040":66,"2041":69,"2042":77,"2043":72,"2044":113,"2045":104,"2046":77,"2047":81,"2048":56,"2049":87,"2050":47,"2051":97,"2052":49,"2053":99,"2054":110,"2055":122,"2056":120,"2057":74,"2058":83,"2059":102,"2060":101,"2061":53,"2062":104,"2063":70,"2064":81,"2065":50,"2066":119,"2067":99,"2068":67,"2069":86,"2070":86,"2071":53,"2072":109,"2073":117,"2074":109,"2075":87,"2076":51,"2077":72,"2078":75,"2079":90,"2080":68,"2081":51,"2082":108,"2083":85,"2084":55,"2085":57,"2086":112,"2087":117,"2088":70,"2089":54,"2090":66,"2091":56,"2092":116,"2093":74,"2094":101,"2095":89,"2096":102,"2097":54,"2098":114,"2099":120,"2100":77,"2101":73,"2102":57,"2103":107,"2104":80,"2105":109,"2106":88,"2107":102,"2108":52,"2109":116,"2110":87,"2111":74,"2112":115,"2113":97,"2114":88,"2115":101,"2116":109,"2117":86,"2118":97,"2119":115,"2120":79,"2121":113,"2122":102,"2123":49,"2124":70,"2125":116,"2126":107,"2127":83,"2128":116,"2129":85,"2130":55,"2131":90,"2132":98,"2133":118,"2134":75,"2135":111,"2136":100,"2137":74,"2138":50,"2139":82,"2140":109,"2141":103,"2142":110,"2143":97,"2144":49,"2145":67,"2146":118,"2147":68,"2148":78,"2149":84,"2150":115,"2151":88,"2152":50,"2153":66,"2154":51,"2155":114,"2156":97,"2157":107,"2158":117,"2159":57,"2160":81,"2161":43,"2162":72,"2163":118,"2164":113,"2165":87,"2166":109,"2167":97,"2168":116,"2169":56,"2170":109,"2171":84,"2172":101,"2173":90,"2174":73,"2175":110,"2176":104,"2177":105,"2178":118,"2179":98,"2180":49,"2181":110,"2182":104,"2183":104,"2184":110,"2185":49,"2186":97,"2187":79,"2188":80,"2189":79,"2190":119,"2191":55,"2192":74,"2193":76,"2194":101,"2195":85,"2196":102,"2197":51,"2198":108,"2199":121,"2200":52,"2201":85,"2202":109,"2203":101,"2204":88,"2205":85,"2206":83,"2207":112,"2208":66,"2209":65,"2210":122,"2211":73,"2212":114,"2213":76,"2214":110,"2215":56,"2216":104,"2217":122,"2218":115,"2219":43,"2220":88,"2221":116,"2222":90,"2223":72,"2224":76,"2225":89,"2226":122,"2227":82,"2228":107,"2229":57,"2230":115,"2231":113,"2232":85,"2233":90,"2234":54,"2235":121,"2236":54,"2237":85,"2238":109,"2239":101,"2240":70,"2241":70,"2242":107,"2243":74,"2244":74,"2245":106,"2246":109,"2247":100,"2248":56,"2249":57,"2250":69,"2251":68,"2252":55,"2253":114,"2254":117,"2255":54,"2256":54,"2257":48,"2258":115,"2259":101,"2260":51,"2261":100,"2262":122,"2263":47,"2264":68,"2265":111,"2266":77,"2267":71,"2268":68,"2269":102,"2270":101,"2271":53,"2272":90,"2273":52,"2274":83,"2275":89,"2276":115,"2277":112,"2278":51,"2279":107,"2280":105,"2281":82,"2282":100,"2283":51,"2284":102,"2285":101,"2286":48,"2287":121,"2288":122,"2289":68,"2290":48,"2291":121,"2292":108,"2293":75,"2294":49,"2295":53,"2296":101,"2297":80,"2298":71,"2299":85,"2300":113,"2301":97,"2302":87,"2303":48,"2304":87,"2305":121,"2306":82,"2307":81,"2308":89,"2309":71,"2310":49,"2311":101,"2312":72,"2313":74,"2314":110,"2315":107,"2316":71,"2317":84,"2318":83,"2319":70,"2320":74,"2321":51,"2322":108,"2323":121,"2324":47,"2325":71,"2326":89,"2327":73,"2328":118,"2329":78,"2330":80,"2331":53,"2332":75,"2333":52,"2334":98,"2335":99,"2336":110,"2337":118,"2338":113,"2339":81,"2340":112,"2341":57,"2342":65,"2343":98,"2344":97,"2345":104,"2346":50,"2347":122,"2348":110,"2349":48,"2350":90,"2351":98,"2352":108,"2353":108,"2354":98,"2355":75,"2356":50,"2357":65,"2358":110,"2359":113,"2360":112,"2361":108,"2362":51,"2363":107,"2364":54,"2365":87,"2366":103,"2367":43,"2368":68,"2369":99,"2370":51,"2371":87,"2372":79,"2373":67,"2374":103,"2375":68,"2376":56,"2377":83,"2378":55,"2379":105,"2380":108,"2381":117,"2382":101,"2383":115,"2384":83,"2385":66,"2386":68,"2387":52,"2388":107,"2389":121,"2390":74,"2391":77,"2392":110,"2393":89,"2394":43,"2395":107,"2396":48,"2397":90,"2398":80,"2399":54,"2400":107,"2401":105,"2402":102,"2403":87,"2404":98,"2405":87,"2406":104,"2407":70,"2408":114,"2409":48,"2410":121,"2411":82,"2412":85,"2413":76,"2414":98,"2415":66,"2416":47,"2417":114,"2418":53,"2419":100,"2420":83,"2421":90,"2422":72,"2423":121,"2424":73,"2425":115,"2426":89,"2427":72,"2428":103,"2429":54,"2430":83,"2431":74,"2432":103,"2433":106,"2434":75,"2435":77,"2436":74,"2437":90,"2438":111,"2439":90,"2440":88,"2441":89,"2442":79,"2443":118,"2444":79,"2445":119,"2446":50,"2447":107,"2448":57,"2449":88,"2450":122,"2451":104,"2452":83,"2453":120,"2454":55,"2455":57,"2456":116,"2457":106,"2458":119,"2459":107,"2460":88,"2461":88,"2462":101,"2463":120,"2464":90,"2465":115,"2466":50,"2467":81,"2468":109,"2469":119,"2470":55,"2471":81,"2472":74,"2473":114,"2474":52,"2475":117,"2476":99,"2477":85,"2478":71,"2479":100,"2480":102,"2481":87,"2482":122,"2483":50,"2484":72,"2485":83,"2486":117,"2487":117,"2488":119,"2489":84,"2490":98,"2491":120,"2492":76,"2493":117,"2494":106,"2495":121,"2496":83,"2497":69,"2498":98,"2499":73,"2500":50,"2501":99,"2502":120,"2503":101,"2504":69,"2505":99,"2506":70,"2507":86,"2508":81,"2509":75,"2510":116,"2511":109,"2512":122,"2513":82,"2514":114,"2515":110,"2516":78,"2517":104,"2518":65,"2519":51,"2520":101,"2521":82,"2522":74,"2523":114,"2524":100,"2525":112,"2526":68,"2527":84,"2528":47,"2529":66,"2530":104,"2531":84,"2532":106,"2533":109,"2534":117,"2535":99,"2536":73,"2537":117,"2538":97,"2539":122,"2540":79,"2541":118,"2542":76,"2543":73,"2544":71,"2545":54,"2546":102,"2547":105,"2548":65,"2549":121,"2550":112,"2551":100,"2552":69,"2553":56,"2554":121,"2555":97,"2556":80,"2557":118,"2558":79,"2559":76,"2560":47,"2561":117,"2562":110,"2563":121,"2564":105,"2565":78,"2566":73,"2567":67,"2568":112,"2569":51,"2570":74,"2571":98,"2572":97,"2573":66,"2574":50,"2575":65,"2576":113,"2577":117,"2578":101,"2579":50,"2580":84,"2581":102,"2582":79,"2583":82,"2584":121,"2585":102,"2586":76,"2587":56,"2588":75,"2589":49,"2590":43,"2591":47,"2592":99,"2593":85,"2594":113,"2595":106,"2596":54,"2597":122,"2598":90,"2599":104,"2600":118,"2601":88,"2602":109,"2603":84,"2604":109,"2605":81,"2606":52,"2607":99,"2608":53,"2609":77,"2610":110,"2611":77,"2612":84,"2613":120,"2614":81,"2615":111,"2616":107,"2617":51,"2618":65,"2619":112,"2620":85,"2621":80,"2622":76,"2623":73,"2624":119,"2625":56,"2626":102,"2627":68,"2628":117,"2629":117,"2630":101,"2631":53,"2632":101,"2633":107,"2634":80,"2635":121,"2636":110,"2637":105,"2638":66,"2639":98,"2640":53,"2641":89,"2642":57,"2643":97,"2644":120,"2645":72,"2646":110,"2647":69,"2648":54,"2649":120,"2650":48,"2651":52,"2652":121,"2653":75,"2654":77,"2655":77,"2656":110,"2657":52,"2658":111,"2659":43,"2660":114,"2661":89,"2662":110,"2663":86,"2664":80,"2665":116,"2666":77,"2667":85,"2668":70,"2669":76,"2670":90,"2671":74,"2672":79,"2673":69,"2674":87,"2675":85,"2676":74,"2677":49,"2678":54,"2679":99,"2680":67,"2681":103,"2682":56,"2683":111,"2684":100,"2685":76,"2686":49,"2687":68,"2688":50,"2689":47,"2690":81,"2691":53,"2692":90,"2693":72,"2694":49,"2695":99,"2696":51,"2697":107,"2698":87,"2699":101,"2700":66,"2701":72,"2702":52,"2703":85,"2704":111,"2705":98,"2706":109,"2707":70,"2708":56,"2709":74,"2710":52,"2711":49,"2712":56,"2713":115,"2714":106,"2715":70,"2716":115,"2717":112,"2718":82,"2719":98,"2720":110,"2721":115,"2722":108,"2723":105,"2724":54,"2725":109,"2726":121,"2727":85,"2728":101,"2729":76,"2730":113,"2731":79,"2732":105,"2733":68,"2734":53,"2735":48,"2736":120,"2737":69,"2738":111,"2739":72,"2740":76,"2741":118,"2742":73,"2743":115,"2744":98,"2745":111,"2746":65,"2747":118,"2748":79,"2749":113,"2750":115,"2751":88,"2752":86,"2753":82,"2754":117,"2755":49,"2756":71,"2757":65,"2758":71,"2759":86,"2760":105,"2761":51,"2762":88,"2763":108,"2764":79,"2765":67,"2766":108,"2767":106,"2768":84,"2769":112,"2770":106,"2771":108,"2772":101,"2773":86,"2774":55,"2775":116,"2776":76,"2777":103,"2778":109,"2779":101,"2780":114,"2781":115,"2782":109,"2783":98,"2784":79,"2785":49,"2786":53,"2787":119,"2788":118,"2789":113,"2790":110,"2791":99,"2792":83,"2793":90,"2794":53,"2795":113,"2796":89,"2797":102,"2798":104,"2799":107,"2800":86,"2801":73,"2802":120,"2803":75,"2804":55,"2805":69,"2806":52,"2807":89,"2808":98,"2809":98,"2810":87,"2811":48,"2812":74,"2813":75,"2814":120,"2815":71,"2816":83,"2817":80,"2818":76,"2819":69,"2820":117,"2821":117,"2822":54,"2823":121,"2824":104,"2825":54,"2826":88,"2827":114,"2828":78,"2829":114,"2830":107,"2831":43,"2832":68,"2833":86,"2834":113,"2835":106,"2836":75,"2837":56,"2838":117,"2839":83,"2840":112,"2841":49,"2842":73,"2843":89,"2844":49,"2845":115,"2846":100,"2847":98,"2848":81,"2849":90,"2850":65,"2851":110,"2852":109,"2853":101,"2854":72,"2855":104,"2856":109,"2857":105,"2858":74,"2859":80,"2860":85,"2861":55,"2862":115,"2863":116,"2864":82,"2865":101,"2866":108,"2867":103,"2868":66,"2869":114,"2870":113,"2871":71,"2872":117,"2873":71,"2874":66,"2875":113,"2876":73,"2877":76,"2878":69,"2879":49,"2880":82,"2881":106,"2882":112,"2883":119,"2884":107,"2885":119,"2886":101,"2887":108,"2888":122,"2889":48,"2890":104,"2891":81,"2892":53,"2893":74,"2894":70,"2895":114,"2896":109,"2897":98,"2898":117,"2899":77,"2900":56,"2901":117,"2902":122,"2903":113,"2904":83,"2905":120,"2906":85,"2907":74,"2908":122,"2909":114,"2910":118,"2911":101,"2912":100,"2913":51,"2914":107,"2915":89,"2916":90,"2917":77,"2918":104,"2919":110,"2920":106,"2921":84,"2922":114,"2923":75,"2924":73,"2925":49,"2926":113,"2927":108,"2928":100,"2929":101,"2930":119,"2931":48,"2932":97,"2933":102,"2934":73,"2935":107,"2936":101,"2937":79,"2938":117,"2939":78,"2940":73,"2941":73,"2942":43,"2943":56,"2944":82,"2945":70,"2946":90,"2947":115,"2948":120,"2949":68,"2950":48,"2951":77,"2952":88,"2953":97,"2954":56,"2955":52,"2956":49,"2957":97,"2958":99,"2959":120,"2960":108,"2961":87,"2962":47,"2963":80,"2964":56,"2965":113,"2966":103,"2967":55,"2968":51,"2969":87,"2970":107,"2971":55,"2972":77,"2973":79,"2974":49,"2975":98,"2976":52,"2977":65,"2978":115,"2979":117,"2980":101,"2981":87,"2982":76,"2983":119,"2984":73,"2985":85,"2986":88,"2987":122,"2988":79,"2989":119,"2990":56,"2991":115,"2992":88,"2993":71,"2994":67,"2995":90,"2996":82,"2997":118,"2998":106,"2999":111,"3000":119,"3001":70,"3002":107,"3003":101,"3004":48,"3005":100,"3006":103,"3007":122,"3008":108,"3009":84,"3010":119,"3011":84,"3012":81,"3013":90,"3014":89,"3015":110,"3016":81,"3017":83,"3018":56,"3019":87,"3020":56,"3021":102,"3022":76,"3023":107,"3024":56,"3025":78,"3026":97,"3027":99,"3028":120,"3029":79,"3030":53,"3031":100,"3032":100,"3033":49,"3034":51,"3035":51,"3036":114,"3037":82,"3038":49,"3039":121,"3040":87,"3041":97,"3042":80,"3043":117,"3044":56,"3045":104,"3046":103,"3047":71,"3048":48,"3049":78,"3050":108,"3051":50,"3052":85,"3053":57,"3054":68,"3055":108,"3056":107,"3057":89,"3058":101,"3059":80,"3060":50,"3061":81,"3062":116,"3063":68,"3064":121,"3065":57,"3066":77,"3067":120,"3068":114,"3069":90,"3070":68,"3071":51,"3072":98,"3073":72,"3074":83,"3075":78,"3076":75,"3077":90,"3078":72,"3079":83,"3080":54,"3081":79,"3082":68,"3083":84,"3084":77,"3085":117,"3086":85,"3087":82,"3088":73,"3089":105,"3090":118,"3091":111,"3092":52,"3093":115,"3094":68,"3095":121,"3096":116,"3097":76,"3098":66,"3099":98,"3100":79,"3101":76,"3102":72,"3103":121,"3104":120,"3105":77,"3106":98,"3107":110,"3108":114,"3109":57,"3110":88,"3111":108,"3112":81,"3113":81,"3114":118,"3115":80,"3116":66,"3117":89,"3118":104,"3119":57,"3120":97,"3121":51,"3122":48,"3123":109,"3124":79,"3125":115,"3126":103,"3127":118,"3128":73,"3129":120,"3130":85,"3131":117,"3132":69,"3133":81,"3134":47,"3135":71,"3136":113,"3137":106,"3138":89,"3139":72,"3140":109,"3141":98,"3142":85,"3143":99,"3144":118,"3145":88,"3146":55,"3147":53,"3148":109,"3149":81,"3150":118,"3151":73,"3152":116,"3153":74,"3154":108,"3155":68,"3156":82,"3157":54,"3158":65,"3159":76,"3160":53,"3161":77,"3162":90,"3163":82,"3164":49,"3165":112,"3166":110,"3167":47,"3168":110,"3169":43,"3170":52,"3171":86,"3172":74,"3173":121,"3174":51,"3175":112,"3176":99,"3177":78,"3178":53,"3179":68,"3180":76,"3181":51,"3182":107,"3183":119,"3184":43,"3185":57,"3186":90,"3187":117,"3188":56,"3189":104,"3190":100,"3191":79,"3192":88,"3193":83,"3194":78,"3195":43,"3196":48,"3197":77,"3198":117,"3199":47,"3200":80,"3201":110,"3202":101,"3203":98,"3204":68,"3205":55,"3206":75,"3207":87,"3208":43,"3209":72,"3210":54,"3211":105,"3212":49,"3213":114,"3214":52,"3215":49,"3216":47,"3217":115,"3218":74,"3219":112,"3220":67,"3221":66,"3222":81,"3223":88,"3224":73,"3225":74,"3226":57,"3227":47,"3228":72,"3229":51,"3230":114,"3231":89,"3232":86,"3233":104,"3234":87,"3235":67,"3236":122,"3237":100,"3238":113,"3239":56,"3240":122,"3241":86,"3242":48,"3243":52,"3244":68,"3245":83,"3246":70,"3247":72,"3248":55,"3249":102,"3250":51,"3251":115,"3252":51,"3253":73,"3254":88,"3255":84,"3256":69,"3257":76,"3258":87,"3259":115,"3260":85,"3261":75,"3262":119,"3263":49,"3264":43,"3265":106,"3266":109,"3267":56,"3268":54,"3269":55,"3270":86,"3271":43,"3272":97,"3273":109,"3274":80,"3275":89,"3276":122,"3277":51,"3278":55,"3279":80,"3280":50,"3281":121,"3282":43,"3283":107,"3284":47,"3285":47,"3286":67,"3287":120,"3288":85,"3289":52,"3290":56,"3291":76,"3292":122,"3293":72,"3294":81,"3295":81,"3296":51,"3297":106,"3298":80,"3299":117,"3300":105,"3301":119,"3302":116,"3303":111,"3304":86,"3305":53,"3306":107,"3307":71,"3308":79,"3309":108,"3310":106,"3311":113,"3312":107,"3313":111,"3314":102,"3315":89,"3316":55,"3317":49,"3318":107,"3319":76,"3320":112,"3321":121,"3322":72,"3323":52,"3324":117,"3325":77,"3326":65,"3327":105,"3328":99,"3329":47,"3330":104,"3331":53,"3332":74,"3333":81,"3334":57,"3335":99,"3336":81,"3337":72,"3338":43,"3339":69,"3340":100,"3341":121,"3342":51,"3343":81,"3344":65,"3345":88,"3346":47,"3347":115,"3348":49,"3349":49,"3350":51,"3351":121,"3352":122,"3353":79,"3354":77,"3355":78,"3356":47,"3357":122,"3358":77,"3359":108,"3360":80,"3361":51,"3362":113,"3363":115,"3364":115,"3365":72,"3366":68,"3367":66,"3368":120,"3369":101,"3370":75,"3371":72,"3372":114,"3373":51,"3374":65,"3375":97,"3376":119,"3377":106,"3378":120,"3379":104,"3380":79,"3381":67,"3382":48,"3383":110,"3384":78,"3385":119,"3386":73,"3387":100,"3388":56,"3389":69,"3390":97,"3391":88,"3392":57,"3393":53,"3394":86,"3395":102,"3396":119,"3397":82,"3398":114,"3399":108,"3400":53,"3401":89,"3402":73,"3403":112,"3404":70,"3405":120,"3406":101,"3407":89,"3408":54,"3409":101,"3410":66,"3411":84,"3412":97,"3413":79,"3414":111,"3415":114,"3416":53,"3417":111,"3418":74,"3419":118,"3420":48,"3421":81,"3422":57,"3423":48,"3424":52,"3425":72,"3426":47,"3427":74,"3428":52,"3429":49,"3430":53,"3431":71,"3432":117,"3433":48,"3434":97,"3435":70,"3436":48,"3437":56,"3438":65,"3439":70,"3440":109,"3441":114,"3442":103,"3443":88,"3444":67,"3445":113,"3446":101,"3447":43,"3448":117,"3449":97,"3450":68,"3451":87,"3452":84,"3453":52,"3454":111,"3455":70,"3456":79,"3457":117,"3458":68,"3459":105,"3460":65,"3461":105,"3462":56,"3463":47,"3464":78,"3465":82,"3466":113,"3467":115,"3468":85,"3469":97,"3470":98,"3471":119,"3472":56,"3473":77,"3474":111,"3475":118,"3476":89,"3477":98,"3478":66,"3479":71,"3480":81,"3481":43,"3482":71,"3483":85,"3484":104,"3485":81,"3486":118,"3487":113,"3488":47,"3489":116,"3490":82,"3491":111,"3492":75,"3493":74,"3494":121,"3495":121,"3496":112,"3497":68,"3498":97,"3499":72,"3500":112,"3501":48,"3502":88,"3503":113,"3504":76,"3505":88,"3506":54,"3507":67,"3508":78,"3509":85,"3510":113,"3511":73,"3512":72,"3513":99,"3514":121,"3515":76,"3516":99,"3517":51,"3518":105,"3519":122,"3520":90,"3521":105,"3522":105,"3523":99,"3524":88,"3525":106,"3526":69,"3527":88,"3528":109,"3529":79,"3530":107,"3531":103,"3532":87,"3533":75,"3534":80,"3535":111,"3536":79,"3537":80,"3538":84,"3539":53,"3540":75,"3541":56,"3542":111,"3543":98,"3544":103,"3545":81,"3546":53,"3547":113,"3548":120,"3549":116,"3550":84,"3551":114,"3552":84,"3553":53,"3554":65,"3555":102,"3556":104,"3557":116,"3558":109,"3559":110,"3560":88,"3561":116,"3562":120,"3563":55,"3564":114,"3565":89,"3566":115,"3567":43,"3568":85,"3569":47,"3570":113,"3571":74,"3572":43,"3573":116,"3574":114,"3575":76,"3576":66,"3577":51,"3578":90,"3579":68,"3580":120,"3581":110,"3582":47,"3583":122,"3584":121,"3585":111,"3586":52,"3587":115,"3588":74,"3589":103,"3590":103,"3591":90,"3592":53,"3593":65,"3594":65,"3595":65,"3596":65,"3597":65,"3598":66,"3599":74,"3600":82,"3601":85,"3602":53,"3603":69,"3604":114,"3605":107,"3606":74,"3607":103,"3608":103,"3609":103,"3610":61,"3611":61}

Commercial logo of the organization. Max length of 32K, base64 encoded.

organizationId
string [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"

Organization identifier code assigned by the account service institution.

status
string (InstructionStatus) [ 1 .. 35 ] characters
Example: "Queued"

Details about the processing of a request on party reference data (create, update, delete). Possible ISO compliant values are: Rejected, Completed, Queued.

Responses

Request samples

Content type
application/merge-patch+json
{
  • "identifiers": [
    ],
  • "name": "Jane Birkin",
  • "shortName": "Jane",
  • "nameTemplateId": "1",
  • "nameSoundExId": "1",
  • "partyBranchId": "SEA_1",
  • "comment": "This is a description.",
  • "relatedParties": [
    ],
  • "postalAddresses": [
    ],
  • "relationshipId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "relationshipLeadIndicator": true,
  • "residenceType": "Domestic",
  • "taxInformation": {
    },
  • "powerOfAttorney": {
    },
  • "supplementaryData": { },
  • "excludeMarketingIndicator": true,
  • "audit": {
    },
  • "restrictions": [
    ],
  • "organizationType": "Corporation",
  • "organizationPurpose": "This is a description.",
  • "legalName": "Jane",
  • "tradingName": "Jane",
  • "registrationDate": "2022-04-17",
  • "establishmentDate": "2022-04-17",
  • "merchantCategory": "482",
  • "nAICSCode": "54",
  • "sector": "string",
  • "organizationProfile": {
    },
  • "contact": {
    },
  • "webPage": "http://portx.io",
  • "logo": {
    },
  • "organizationId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "status": "Queued"
}

Response samples

Content type
application/json
{
  • "identifiers": [
    ],
  • "name": "Jane Birkin",
  • "shortName": "Jane",
  • "nameTemplateId": "1",
  • "nameSoundExId": "1",
  • "partyBranchId": "SEA_1",
  • "comment": "This is a description.",
  • "relatedParties": [
    ],
  • "postalAddresses": [
    ],
  • "relationshipId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "relationshipLeadIndicator": true,
  • "residenceType": "Domestic",
  • "taxInformation": {
    },
  • "powerOfAttorney": {
    },
  • "supplementaryData": { },
  • "excludeMarketingIndicator": true,
  • "audit": {
    },
  • "restrictions": [
    ],
  • "organizationType": "Corporation",
  • "organizationPurpose": "This is a description.",
  • "legalName": "Jane",
  • "tradingName": "Jane",
  • "registrationDate": "2022-04-17",
  • "establishmentDate": "2022-04-17",
  • "merchantCategory": "482",
  • "nAICSCode": "54",
  • "sector": "string",
  • "organizationProfile": {
    },
  • "contact": {
    },
  • "webPage": "http://portx.io",
  • "logo": {
    },
  • "organizationId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "status": "Queued"
}

Retrieves Organization Accounts

Authorizations:
jwtopenIdConnect
path Parameters
organizationId
required
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Organization Identification

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Responses

Response samples

Content type
application/json
{
  • "organizationId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "organizationName": "Jane Birkin",
  • "organizationType": "Corporation",
  • "accounts": [
    ]
}

Transactions

Account Transactions Management

Creates a Credit Transaction

Authorizations:
jwtopenIdConnect
path Parameters
accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: 0dd926fe-1ca2-11ed-861d-0242ac120002

Account Identification

header Parameters
idempotencyId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Idempotency identifier used by the client when making repeated calls

servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

Request Body schema: application/json
transactionType
required
string (DepositTransactionType) [ 1 .. 35 ] characters
Example: "Cash"

Type of Credit Transaction: Cash, Check, Merchandise

amount
required
string (AmountInCents) <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: -9999999999999.99999999

object (Exchange)
currency
string = 3 characters ^([A-Z]{3})?$
Example: "USD"

Currency in which the rate of exchange is expressed in a currency exchange.

exchangeFactor
string (BaseOneRate) [ 1 .. 35 ] characters
Example: "0.7"

Rate expressed as a decimal, for example, 0.7 is 7/10 and 70%. total number of digits: 11 number of digits in fractional part: 10 base value: 1

object (Check)

Characteristics of a check

checkType
string

Specifies the type of the check. Possible ISO compliant values are: CustomerCheque, CertifiedCustomerCheque, BankCheque, Draft, ElectronicDraft.

checkNumber
string <= 35 characters

The number on the face of the check indicating the id of that check in a series.

availabilityDate
string <date-time>
Example: "2022-04-17T08:00:00Z"

Indicates when the amount of money will become available. Usage: This type of information is used in the US and is linked to particular instruments such as cheques. Example: When a cheque is deposited, it will be booked on the deposit day, but the amount of money will only be accessible as of the indicated availability day (according to national banking regulations).

Responses

Request samples

Content type
application/json
{
  • "transactionType": "Cash",
  • "amount": "100",
  • "exchange": {
    },
  • "check": {
    }
}

Response samples

Content type
application/json
{
  • "transactionId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "amount": "100",
  • "creditDebitIndicator": "Credit",
  • "domain": "Payments",
  • "family": "CustomerCardTransactions",
  • "subfamily": "CreditCardPayment",
  • "description": "This is a description.",
  • "status": "Booked",
  • "reversalIndicator": true,
  • "creationDate": "2022-04-17T08:00:00Z",
  • "valueDate": "2022-04-17T08:00:00Z",
  • "bookingDate": "2022-04-17T08:00:00Z",
  • "charges": [
    ],
  • "codes": [
    ],
  • "interests": [
    ],
  • "currentBalance": "100",
  • "payment": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "check": {
    },
  • "card": {
    },
  • "remittanceInformation": {
    },
  • "supplementaryData": { }
}

Creates a Debit Transaction

Authorizations:
jwtopenIdConnect
path Parameters
accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: 0dd926fe-1ca2-11ed-861d-0242ac120002

Account Identification

header Parameters
idempotencyId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Idempotency identifier used by the client when making repeated calls

servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

Request Body schema: application/json
transactionType
string (WithdrawalTransactionType) [ 1 .. 35 ] characters
Example: "Cash"

Type of Debit Transaction: Cash

amount
required
string (AmountInCents) <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: -9999999999999.99999999

object (Check)

Characteristics of a check

checkType
string

Specifies the type of the check. Possible ISO compliant values are: CustomerCheque, CertifiedCustomerCheque, BankCheque, Draft, ElectronicDraft.

checkNumber
string <= 35 characters

The number on the face of the check indicating the id of that check in a series.

availabilityDate
string <date-time>
Example: "2022-04-17T08:00:00Z"

Indicates when the amount of money will become available. Usage: This type of information is used in the US and is linked to particular instruments such as cheques. Example: When a cheque is deposited, it will be booked on the deposit day, but the amount of money will only be accessible as of the indicated availability day (according to national banking regulations).

Responses

Request samples

Content type
application/json
{
  • "transactionType": "Cash",
  • "amount": "100",
  • "check": {
    }
}

Response samples

Content type
application/json
{
  • "transactionId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "amount": "100",
  • "creditDebitIndicator": "Credit",
  • "domain": "Payments",
  • "family": "CustomerCardTransactions",
  • "subfamily": "CreditCardPayment",
  • "description": "This is a description.",
  • "status": "Booked",
  • "reversalIndicator": true,
  • "creationDate": "2022-04-17T08:00:00Z",
  • "valueDate": "2022-04-17T08:00:00Z",
  • "bookingDate": "2022-04-17T08:00:00Z",
  • "charges": [
    ],
  • "codes": [
    ],
  • "interests": [
    ],
  • "currentBalance": "100",
  • "payment": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "check": {
    },
  • "card": {
    },
  • "remittanceInformation": {
    },
  • "supplementaryData": { }
}

Retrieves Account Transactions

Authorizations:
jwtopenIdConnect
path Parameters
accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: 0dd926fe-1ca2-11ed-861d-0242ac120002

Account Identification

query Parameters
transactionId.eq
string (TransactionId) [ 1 .. 36 ] characters
Example: transactionId.eq=0dd926fe-1ca2-11ed-861d-0242ac120002

Unique reference as assigned by the account servicing institution to unambiguously identify the transaction.

status.eq
string (TransactionStatus) [ 1 .. 35 ] characters
Example: status.eq=Booked

Specifies the status of an entry on the books of the account servicer. Some possible ISO 20022 compliant values are: Booked, Future, Information, Pending.

amount.lte
string (AmountInCents) <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: amount.lte=100

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: -9999999999999.99999999

amount.gte
string (AmountInCents) <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: amount.gte=100

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: -9999999999999.99999999

creationDate.lte
string <date> (Date)
Example: creationDate.lte=2022-04-17

Input cycle date less than or equal

creationDate.gte
string <date> (Date)
Example: creationDate.gte=2022-04-17

Input cycle date greater than or equal

cursor
string

Specifies an opaque string value ( "no meaning" string value) at which start retrieving transactions. For instance, limit=5&cursor=62aef884fbe3470ce7d9a92140b09b17

limit
string

Specifies the number of resources to return in one request, specified as an integer from 1 to 100.

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

Pagination-Cursor
required
string

Pagination Cursor

Pagination-Total
required
string

Total number of resources.

Responses

Response samples

Content type
application/json
{
  • "accountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "accountNumber": "012345678",
  • "accountType": "Checking",
  • "ownershipType": "SingleOwnerAccount",
  • "currency": "USD",
  • "currentBalance": "100",
  • "availableBalance": "100",
  • "transactions": [
    ]
}

Products

Financial Product Management

Retrieves Financial Products

Authorizations:
jwtopenIdConnect
header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

Responses

Response samples

Content type
application/json
{
  • "productId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "name": "Visa Business Card",
  • "description": "This is a description.",
  • "productType": "PaymentCard",
  • "productSubType": "BusinessCard",
  • "restrictions": [
    ],
  • "limits": [
    ],
  • "supplementaryData": { }
}

Cards

Card Management

Retrieves Cards

Authorizations:
jwtopenIdConnect
query Parameters
number.eq
string (PrimaryAccountNumber) [ 1 .. 19 ] characters
Example: number.eq=1234567890123456789

Primary Account Number (PAN) of the card.

sourceType.eq
string (CardFundingSourceType) [ 1 .. 35 ] characters
Example: sourceType.eq=Credit

Specifies the funding source type of payment card. Possible Values: Credit, Debit, Prepaid, Charge, DeferredDebit

productName.eq
string (CardProductName) [ 1 .. 60 ] characters
Example: productName.eq=Visa Classic

Specifies the product name of payment card.

brand.inc
string (PartyName) [ 1 .. 350 ] characters
Example: brand.inc=Jane Birkin

Name by which a party is known and which is usually used to identify that party.

name.inc
string (PartyName) [ 1 .. 350 ] characters
Example: name.inc=Jane Birkin

Name by which a party is known and which is usually used to identify that party.

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Retrieves a Card

Authorizations:
jwtopenIdConnect
path Parameters
cardId
required
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Card Identification

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Updates a Card

Use the JSON Merge Patch standard https://tools.ietf.org/html/rfc7396

Authorizations:
jwtopenIdConnect
path Parameters
cardId
required
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Card Identification

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Request Body schema: application/merge-patch+json
fundingSourceType
string (CardFundingSourceType) [ 1 .. 35 ] characters
Example: "Credit"

Specifies the funding source type of payment card. Possible Values: Credit, Debit, Prepaid, Charge, DeferredDebit

productId
required
string (Id) [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"
styleId
string (Id) [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"
businessIndicator
boolean

Indicates whether the payment card is business or not.

digitalIndicator
boolean (DigitalCardIndicator)

Indicates whether the payment card is digital or physical.

cardBranchId
string (Id) [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"
number
required
string (PrimaryAccountNumber) [ 1 .. 19 ] characters
Example: "1234567890123456789"

Primary Account Number (PAN) of the card.

cardHolderType
required
string (CardHolderType) [ 1 .. 35 ] characters
Example: "Primary"

Specifies the card holder type of payment card. Possible Values: Primary, Additional

nameOnCard
string [ 1 .. 350 ] characters
Example: "Jane Birkin"

Specifies the name on the card if overriding the name from the card holder.

businessNameOnCard
string [ 1 .. 350 ] characters
Example: "Jane Birkin"

Specifies the business name on the card.

referenceAccountId
string [ 1 .. 36 ] characters
Example: "0dd926fe-1ca2-11ed-861d-0242ac120002"

Account used as a reference for the card creation. Could be a cash or loan account owned by the primary card holder.

required
Array of objects (RelatedAccount)

Account that provides the payment card transactions. The account is the funding source for the card. Could be a cash or loan account linked to the debit card or a credit card account. A card can have one or many accounts.

Array
accountRelationType
required
string (AccountRelationType)
Example: "Child"

Account relation role. Possible values are: Parent, Child, Group.

accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: "0dd926fe-1ca2-11ed-861d-0242ac120002"

Identification assigned by the account service institution (Servicer).

accountNumber
string (AccountNumber) <= 30 characters
Example: "012345678"

The account number or Basic Bank Account Number (BBAN). A Basic Bank Account Number (BBAN) is a bank account number that includes the domestic bank code, branch identifier, and account number. It is a unique identifier for a bank account within a specific country.

accountType
required
string (RelatedAccountType) [ 1 .. 35 ] characters
Example: "Checking"

Type of the account. Some possible ISO 20022 compliant values are: Checking, CardAccount, CashPayment, Charges, CashIncome, Commission, ClearingParticipantSettlementAccount, LimitedLiquiditySavingsAccount, MarginalLending, MoneyMarket, NonResidentExternal, Overdraft, OverNightDeposit, Settlement, Salary, Savings, Tax, TransactingAccount, CashTrading, VirtualAccount, CreditCard, DebitCard, Universal, Investment, EpurseCard, CertificateOfDeposit, MoneyMarketChecking, RetirementAccount, StockOrBond, PrePaid, FleetCard, Cash, DebitAccount, CreditAccount, Benefit, HealthSavingsAccount, FlexibleSpendingAccount, ForBenefitOf, Estate, ClientTrustAccount, LawyersTrustAccount, KeoghPlanAccount, UniformTransfersToMinorsAct, UniformGiftsToMinorsAct, ReserveFunds, SelfDirectedBrokerage, Loan, Ledger.

name
string (AccountName) [ 1 .. 70 ] characters
Example: "Hermes PD_CA 0002"

Name of the account. It provides an additional means of identification, and is designated by the account servicer in agreement with the account owner.

startDate
required
string <date>
Example: "2022-04-17"

Year and month the card is available for use.

expiryDate
required
string <= 7 characters ^\d{4}-([0]\d|1[0-2])$
Example: "2022-12"

Year and month the card expires.

orderedDate
string <date>
Example: "2022-04-17"

Date the card is ordered

securityCode
string <= 35 characters
Example: "103"

Security code written on the card, sometimes called card security code (CSC).

pIN
string <= 35 characters
Example: "1031"

PIN is the 4 digit security code that is used to authenticate the user and allow them access to the associated accounts of the card.

pINRetries
number <= 99
Example: 3

Pin Retries Allowed

sequenceNumber
string <= 20 characters
Example: "1"

Identifies a card inside a set of cards with the same number (or PAN).

brand
string <= 35 characters
Example: "Visa"

Brand name of the card.

Array of objects (Limit)
Array
name
required
string [ 1 .. 60 ] characters
Example: "creditLimit"

Name of the limit in PascalCase. Possible values: Overdraft, CreditLimit, CreditCard, Withdraw, CreditCardWithdraw, ForeignFeesWaived, CreditTransactions, DebitTransactions

limitTypeCode
string (LimitType) <= 35 characters
Example: "DirectDebit"

Specifies the type of risk management limit. Possible ISO 20020 compliant values are: Bilateral, NetBilateral, IndirectBilateral, Global, MandatoryBilateral, DiscretionaryBilateral, DirectDebit, SingleCustomerDirectDebit, SingleFinancialInstitutionDirectDebit, TotalDailyCustomerDirectDebit, TotalDailyFinancialInstitutionDirectDebit, AutoCollateralisation, UnsecuredCredit, ExternalGuarantee

channelType
string [ 1 .. 30 ] characters

Channel type for which this limit applies. Possible values: OnlineATM, OfflineATM, ATM, SaleTerminal

amount
string <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Amount limit

number
integer

Number limit.

percentage
string (Percentage) <= 23 characters ^100|(([1-9][0-9]{0,1})([.][0-9]{0,8}){0,1})$...
Example: "25"

Value expressed as a percentage, rate expressed as a percentage, that is, in hundredths, for example, 0.7 is 7/10 of a percent, and 7.0 is 7%. total number of digits: 11 number of digits in fractional part: 10 Max Value: 100

object (Period)
object (Frequency)

Specifies an event frequency

usedAmount
string <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Amount limit used

usedNumber
integer

Number limit used.

usedPercentage
string (Percentage) <= 23 characters ^100|(([1-9][0-9]{0,1})([.][0-9]{0,8}){0,1})$...
Example: "25"

Value expressed as a percentage, rate expressed as a percentage, that is, in hundredths, for example, 0.7 is 7/10 of a percent, and 7.0 is 7%. total number of digits: 11 number of digits in fractional part: 10 Max Value: 100

status
string (LimitStatus) <= 35 characters
Example: "Requested"

Specifies the current status of a limit. Possible ISO 20020 compliant values are: Enabled, Disabled, Deleted, Requested

object (Frequency)

Specifies an event frequency

Array of objects (InterestCalculation)
Array
name
string (InterestName) [ 1 .. 35 ] characters
Example: "Deposit"

Name of the interest that applies to the account. For instance, Deposit.

code
string <= 50 characters

Interest code used by the account servicer.

dayCountBasis
string (InterestComputationMethod) [ 1 .. 50 ] characters
Example: "30360AmericanBasicRule"

Specifies the method used to compute accruing interest of a financial instrument. Possible Values: 30360AmericanBasicRule, IC30365, IC30Actual, Actual360, Actual365Fixed, ActualActualICMA, IC30E360orEuroBondBasismodel1, ActualActualISDA, Actual365LorActuActubasisRule, ActualActualAFB, IC30360ICMAor30360basicrule, IC30E2360orEurobondbasismodel2, IC30E3360orEurobondbasismodel3, Actual365NL, Narrative, ActualActualUltimo, IC30EPlus360, Actual364, Business252, Actual360NL, OneOne. DateDeposit365365, DateDeposit365360, LastInterest365365, LastInterest365360, EqualPayments365365, EqualPayments365360

accruedDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

nextInterestDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

rate
string <= 23 characters ^100|(([1-9][0-9]{0,1})([.][0-9]{0,8}){0,1})$...
Example: "25"

The actual interest rate.

object

The period funds are earning interest.

rateType
string (InterestRateType) [ 1 .. 35 ] characters
Example: "Fixed"

Specifies the type of interest rate. Some ISO 20022 compliant values are: Fixed, Forfeit, Variable, StepUp, Scheduled, Unscheduled, Discount, FixedRateUnderlyingExposureForLife, FixedRateUnderlyingExposureWithCompulsoryFutureSwitchToFloating, FixedWithFuturePeriodicResets, FloatingLinkedToIndex, FloatingRateUnderlyingExposureForLife, FloatingRateUnderlyingExposureWithCap, FloatingRateUnderlyingExposureWithFloor, FloatingRateUnderlyingExposureWithFloorAndCap, Modular, ObligorSwapped, SwicthOptionality

compoundingMethod
string (InterestCompoundingMethod) [ 1 .. 35 ] characters
Example: "Deposit"

Inteterst compounding method: Possible Values: Simple, Daily, Continuous.

object (Frequency)

Specifies an event frequency

object (VariableInterestCalculation)

Specifies the parameters to be used for variable interest.

dateNextInterest
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

oneDayInterest
string (PositiveAmountInCents) <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: 0

object (InterestPayment)

Set of attributes related to the interest payment.

Array of objects (Balance)

Total amounts related to an interest

object (InterestDetails)

Set of attributes related to the interest calculus.

object (InterestRenewalDetails)

Detailed interest attributes related to rate change and account maturity.

object (InterestDetails)

Set of attributes related to the interest calculus.

object (InterestCycle)

Set of parameters used to calculate an interest cycle.

lastCalculus
string (PositiveAmountInCents) <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: 0

Array of objects (Restriction)
Array
name
required
string [ 1 .. 60 ] characters
Example: "WireTransferIn"

Name of the restriction in PascalCase. Possible values: WireTransferIn, WireTransferOut, ForeignIncomingWires, ForeignOutgoingWires, ACHTransfers, InternetBankingTransfer, InternetView, InternetInquiry, ForeignOutgoingIran, Withdrawals, Renew, Transfers

restrictionPurpose
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
enableIndicator
boolean
Example: true

Indicates whether the capability is allowed or not.

validFrom
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

validUntil
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

Array of objects (ChargeCalculation)
Array
fromDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period starts.

upToDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period ends.

periodNumber
integer

Sequence number of the period.

name
string (ChargeName) [ 1 .. 60 ] characters
Example: "CardLatePayment"

Name of the charge calculation in PascalCase. Possible values: Overdraft, CardLatePayment, CashAdvance, LatePayment, CashWithdrawal, EarlyWithdrawal

amount
string <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Amount charged for the service.

rate
string <= 23 characters ^100|(([1-9][0-9]{0,1})([.][0-9]{0,8}){0,1})$...
Example: "25"

Rate applied on a basis amount to calculate the service charge.

chargeType
string (ChargeType) [ 1 .. 35 ] characters
Example: "ManagementFee"

Type of service for which a charge is asked or paid. Some possible ISO 20022 compliant values are: BrokerageFee, Commission, BackEndLoad, FrontEndLoad, Switch, DilutionLevy, Discount, ManagementFee, TransferFee, MatchingFees, PostageCharge, RegulatoryFee, ShippingCharge, ServiceProvisionFee, SpecialConcessions, PartAcquis, Penalty, ContingencyDeferredSalesCharge, Equalisation, CorrespondentBankCharge, Premium, Initial, AdvisoryFee, CustodyFee, PublicationFee, AccountingFee, SignatureService, StorageAtDestination, StorageAtOrigin, Packaging, PickUp, DangerousGoodsFee, SecurityCharge, InsurancePremium, CollectFreight, ClearanceAndHandlingAtOrigin, ClearanceAndHandlingAtDestination, AirWayBillFee, TransportCharges, UCITSCommission, SpeciallyAgreedFrontEndLoad, ADRFee, IssuanceCancellationFee, MiscellaneousFee, IssuanceFee.

calculationMethodCode
string [ 1 .. 60 ] characters

Servicer charge calculation code

calculationBasis
string (CalculationBasis) [ 1 .. 35 ] characters
Example: "Monthly"

Specifies the calculation basis of a charge or fee. Some possible ISO 20022 compliant values are: Average, Daily, Monthly, Annual, FullTerm, RemainingTerm

bearerType
string (ChargeBearerType) [ 1 .. 35 ] characters
Example: "Shared"

Specifies which party(ies) will pay charges due for processing of the instruction. BorneByDebtor, BorneByCreditor, Shared, FollowingServiceLevel

maximumAmount
string <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Maximum amount of money asked or paid for the charge.

object (InterestCalculation)

Set of parameters used to calculate an interest.

debitIndicator
boolean

Indicates whether the charge is automatically debited from the defined account.

accountToCharge
string (AccountId) [ 1 .. 36 ] characters
Example: "0dd926fe-1ca2-11ed-861d-0242ac120002"

Identification assigned by the account service institution (Servicer).

object (Frequency)

Specifies an event frequency

Array of objects (TotalAmount)

Total amounts related to a charge

Array of objects (Algorithm)
Array
name
string [ 1 .. 35 ] characters

Name to describe the algorithm provided. Possible Values: ICSF

target
string [ 1 .. 35 ] characters

Attribute name of the algorithm. Possible Values: pIN

enableIndicator
boolean

Indicates whether the offset has been calculated.

offset
string [ 1 .. 60 ] characters

An attribute offset is a value that is the difference between two attributes. For example, a PIN offset may be the difference between a PIN that is chosen by the customer and one that is assigned by an institution.

supplementaryData
object (SupplementaryData)

Additional information that cannot be captured in the structured elements and/or any other specific block. If this information need to be converted in ISO Messages, must be ISO 20022 compliant: it requires development of a compliant message extension model and its components must be registered in the ISO 20022 Data Dictionary. https://www.iso20022.org/catalogue-messages/additional-content-messages/supplementary-data

cardId
string (PaymentCardId) [ 1 .. 36 ] characters
Example: "0dd926fe-1ca2-11ed-861d-0242ac120002"

Identification assigned by the card provider. A cardId is a unique identifier associated with a specific cardholder. Establishing the card ID is the first step. The card ID is used as the card reference. When a card is replaced, a new card ID must be requested for the new PAN.

cardHolderId
required
string [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"

Card holder person identifier

object (CreditCardStatement)

Credit Card statement details.

object (Frequency)

Specifies an event frequency

cycleType
string [ 1 .. 35 ] characters

Specifies a cycle type. Possible values: Temporal, AtMaturity, InterestCycle, FromLastStatement, LastDay.

cycle
string [ 1 .. 35 ] characters
Example: "Monthly"

Specifies a temporal cycle. Possible values: Annual, Monthly, Quarterly, SemiAnnual, Weekly, Daily, Once, IntraDay, Overnight, TenDays, Fortnightly, TriggeredByMovement, Never, Rate, OnCreditEvent, Upfront, OnExpiry, Hourly, TriAnnual, Bimonthly, OnDemand, Shift, TwiceAWeek, XDays, XMonths, XYears.

every
integer <= 999
Example: 15

Custom cycle definition. Number of XDays, XMonths, XYears.

weekDay
string <= 3
Example: "Tuesday"

Day of the week. Possible Values: Monday, Tuesday, Wednesday, Thursday, Friday.

weekNumbers
Array of strings[ items <= 3 ]
Example: ["1st"]
days
Array of integers[ items <= 31 ]
Example: [30]
startDay
string (MonthDay) ([0-9]{2})-([0-9]{2})
Example: "04-17"

A particular point in the year expressed in the MM-DD format.

communicationMethod
string (CommunicationChannelName) [ 1 .. 35 ] characters
Example: "Email"

Channel used to communicate with a party. Possible Values: Email, Fax, File, Online, PostalService, LiveSupport, ATM, IVR, Kiosk, Mobile, OnlineBanking, Phone, SMS, Card, InPerson.

format
string (DocumentFormat) [ 1 .. 35 ] characters
Example: "PDF"

Specifies a choice of format for a document. Possible Values: PDF, HTML

templateCode
string (StatementTemplateId) [ 1 .. 36 ] characters
Example: "1"

Template used to create the statement document. This is an external code provided by the account servicer.

object (Period)
fromDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period starts.

upToDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period ends.

periodNumber
integer

Sequence number of the period.

lastStatementDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

lastRegularStatementDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

accountNameIndicator
boolean

Indicates whether the account name is printed on the statement.

Array of objects (Balance)

Statement total amounts

Array
balanceName
required
string (BalanceName) [ 1 .. 17 ] characters
Example: "Available"

Specifies the nature of the balance. Possible values: Current, Available, Pending, Blocked, Previous, PendingLedger, LastAnniversary, CurrentAccrued, PreviousAccrued, CurrentWithLastCalculus, CarriedAdjustment, PaidWithPenalties, Accrued, Penalty, CollectionLedger, LastLedger, CurrentLedger, Withheld.

amount
required
string (AmountInCents) <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: -9999999999999.99999999

currency
string (CurrencyCode) = 3 characters ^([A-Z]{3})?$
Example: "USD"

Three contiguous letters for the representation of currencies and funds. Valid currency codes are registered with the ISO 4217 Maintenance Agency.

calculationDate
string <date-time>
Example: "2022-04-17T08:00:00Z"

Specifies the date and time at which the balance is calculated.

preferredLanguage
string (PreferredLanguage) [ 1 .. 35 ] characters
Example: "English"

Language of the contact person. Names according to the language list provided in the ISO 639-1 codes. Some possible values: Chinese, Spanish, French, English, Japanese, Italian, German.

combineType
string [ 1 .. 36 ] characters
Example: "SavingsSatement"

Indicates whether account transactions are printed on a combined statement. Possible combinations: CheckingStatement, SavingsSatement.

statementBalance
string <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

The balance calculated at the end of the billing cycle up to the payment closing date.

paymentClosingDate
string <date>
Example: "2022-04-17"

Last day of your billing cycle.

paymentDueDate
string <date>
Example: "2022-04-17"

The date by which is needed to pay the issuer to avoid interest charges.

minimumPayment
string <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

The minimum monthly payment is the lowest amount a customer can pay on their revolving credit account per month to remain in good standing with the credit card company.

lastPaymentDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

lastPaymentAmount
string (AmountInCents) <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: -9999999999999.99999999

Array of objects (CardProviderOffer)

Card provider offers assigned to the PAN.

Array
offerId
required
string (OfferId) [ 1 .. 35 ] characters
Example: "101854"

Card provider unique reference to the card payment offer.

offerTitle
required
string (OfferTitle) [ 1 .. 35 ] characters
Example: "Save 20%"

Short description of the offer

status
string (CardStatus) [ 1 .. 60 ] characters
Example: "Active"

Specifies the status of payment card. Some possible values are: AssignPIN, Active, Blocked, Closed, Expedite, Expired, HotCarded, Renewed, Inactive, Issued, Lost, Restricted, Stolen, Suspended.

statusDate
string <date-time> (DateAndTime)
Example: "2022-04-17T08:00:00Z"
statusReason
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
object (PaymentCardHistory)
lastCardId
string (PaymentCardId) [ 1 .. 36 ] characters
Example: "0dd926fe-1ca2-11ed-861d-0242ac120002"

Identification assigned by the card provider. A cardId is a unique identifier associated with a specific cardholder. Establishing the card ID is the first step. The card ID is used as the card reference. When a card is replaced, a new card ID must be requested for the new PAN.

lastActivityDate
string <date>
Example: "2022-04-17"

The most recent date the debit card was used to complete a transaction.

lastForeingTransferMonth
string (Month) <= 12
Example: "12"

Specifies a month number.

Array of objects (TotalAmount)

Total amounts

Array
name
string [ 1 .. 35 ] characters
object (Period)
amount
string <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Total of the transaction amounts.

Array of objects (ServicerAlert)

Customer alerts to be received by the account servicer.

Array
alertName
string (AlertName) [ 1 .. 35 ] characters
Example: "CreditBureauAlert"

An alert notification received by the bank. Possible values: CreditBureauAlert, CustomerAlert, PaymentCard

alertType
string (AlertType) [ 1 .. 35 ] characters
Example: "Warning"

An alert notification type. Possible values: Warning, Urgent.

alertCode
string [ 1 .. 36 ] characters
message
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
lastAlertDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

Responses

Request samples

Content type
application/merge-patch+json
{
  • "fundingSourceType": "Credit",
  • "productId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "styleId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "businessIndicator": true,
  • "digitalIndicator": true,
  • "cardBranchId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "number": "1234567890123456789",
  • "cardHolderType": "Primary",
  • "nameOnCard": "Jane Birkin",
  • "businessNameOnCard": "Jane Birkin",
  • "referenceAccountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "relatedAccounts": [
    ],
  • "startDate": "2022-04-17",
  • "expiryDate": "2022-12",
  • "orderedDate": "2022-04-17",
  • "securityCode": "103",
  • "pIN": "1031",
  • "pINRetries": 3,
  • "sequenceNumber": "1",
  • "brand": "Visa",
  • "limits": [
    ],
  • "interests": [
    ],
  • "restrictions": [
    ],
  • "charges": [
    ],
  • "algorithms": [
    ],
  • "supplementaryData": { },
  • "cardId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "cardHolderId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "statement": {
    },
  • "offers": [
    ],
  • "status": "Active",
  • "statusDate": "2022-04-17T08:00:00Z",
  • "statusReason": "This is a description.",
  • "history": {
    },
  • "servicerAlerts": [
    ]
}

Response samples

Content type
application/json
{
  • "fundingSourceType": "Credit",
  • "productId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "styleId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "businessIndicator": true,
  • "digitalIndicator": true,
  • "cardBranchId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "number": "1234567890123456789",
  • "cardHolderType": "Primary",
  • "nameOnCard": "Jane Birkin",
  • "businessNameOnCard": "Jane Birkin",
  • "referenceAccountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "relatedAccounts": [
    ],
  • "startDate": "2022-04-17",
  • "expiryDate": "2022-12",
  • "orderedDate": "2022-04-17",
  • "securityCode": "103",
  • "pIN": "1031",
  • "pINRetries": 3,
  • "sequenceNumber": "1",
  • "brand": "Visa",
  • "limits": [
    ],
  • "interests": [
    ],
  • "restrictions": [
    ],
  • "charges": [
    ],
  • "algorithms": [
    ],
  • "supplementaryData": { },
  • "cardId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "cardHolderId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "statement": {
    },
  • "offers": [
    ],
  • "status": "Active",
  • "statusDate": "2022-04-17T08:00:00Z",
  • "statusReason": "This is a description.",
  • "history": {
    },
  • "servicerAlerts": [
    ]
}

Retrieves Card Accounts

Authorizations:
jwtopenIdConnect
path Parameters
cardId
required
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Card Identification

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Responses

Response samples

Content type
application/json
{
  • "cardId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "fundingSourceType": "Credit",
  • "productName": "Visa Classic",
  • "productId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "digitalIndicator": true,
  • "number": "1234567890123456789",
  • "accounts": [
    ]
}

Retrieves Card Holder

Authorizations:
jwtopenIdConnect
path Parameters
cardId
required
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Card Identification

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Responses

Response samples

Content type
application/json
{
  • "uSDocumentedIndicator": true,
  • "identifiers": [
    ],
  • "name": "Jane Birkin",
  • "shortName": "Jane",
  • "nameTemplateId": "1",
  • "nameSoundExId": "1",
  • "partyBranchId": "SEA_1",
  • "comment": "This is a description.",
  • "relatedParties": [
    ],
  • "postalAddresses": [
    ],
  • "relationshipId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "relationshipLeadIndicator": true,
  • "residenceType": "Domestic",
  • "taxInformation": {
    },
  • "powerOfAttorney": {
    },
  • "supplementaryData": { },
  • "excludeMarketingIndicator": true,
  • "audit": {
    },
  • "restrictions": [
    ],
  • "placeAndDateOfBirth": {
    },
  • "signature": {
    },
  • "signatureVerificationId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "contact": {
    },
  • "headOfHousehold": true,
  • "civilStatus": "Single",
  • "structuredName": {
    },
  • "gender": "Female",
  • "race": "Director",
  • "profession": "Artist",
  • "jobTitle": "Head of Documentation",
  • "residentialStatus": "Permanent",
  • "minorIndicator": true,
  • "citizenships": [
    ],
  • "countryOfResidence": "US",
  • "profile": {
    },
  • "personId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "status": "Queued"
}

Retrieves Card Holder Transactions

Authorizations:
jwtopenIdConnect
path Parameters
cardId
required
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Card Identification

query Parameters
transactionId.eq
string (TransactionId) [ 1 .. 36 ] characters
Example: transactionId.eq=0dd926fe-1ca2-11ed-861d-0242ac120002

Unique reference as assigned by the account servicing institution to unambiguously identify the transaction.

amount.lte
string (AmountInCents) <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: amount.lte=100

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: -9999999999999.99999999

amount.gte
string (AmountInCents) <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: amount.gte=100

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: -9999999999999.99999999

creationDate.lte
string <date> (Date)
Example: creationDate.lte=2022-04-17

Input cycle date less than or equal

creationDate.gte
string <date> (Date)
Example: creationDate.gte=2022-04-17

Input cycle date greater than or equal

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Loans

Loan Management

Opens a Loan

Authorizations:
jwtopenIdConnect
header Parameters
idempotencyId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Idempotency identifier used by the client when making repeated calls

servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Request Body schema: application/json
object (CompositeAccountIdentifier)

The composite account identifier provides unique account identification when overlaying its parts. [branch-type-subtype-number]

branch
string [ 1 .. 10 ] characters
Example: "1"

Account branch

type
string [ 1 .. 10 ] characters
Example: "DD"

Account type.

subtype
string [ 1 .. 10 ] characters
Example: "HA"

Account subtype

number
required
string [ 1 .. 20 ] characters
Example: "12345"

Account number

accountBranchId
string (ServicerBranchId) [ 1 .. 36 ] characters
Example: "SEA_1"

Identification of the account servicer institution at branch level or operation level.

accountNumber
string (AccountNumber) <= 30 characters
Example: "012345678"

The account number or Basic Bank Account Number (BBAN). A Basic Bank Account Number (BBAN) is a bank account number that includes the domestic bank code, branch identifier, and account number. It is a unique identifier for a bank account within a specific country.

Array of objects (RoutingNumber)
Array
number
string (ABANumber) = 9 characters
Example: "012345678"

The routing number (sometimes referred to as an ABA routing number, regarding the American Bankers Association) is a sequence of nine digits used by banks to identify specific financial institutions within the United States.

routingNumberType
string (RoutingNumberType) = 9 characters
Example: "ACH"

Different types of payments may require different bank routing numbers. Some possible values: ACH, WIRE, ElectronicCheck, PaperCheck

Array of objects (AccountIdentification)
Array
identification
string [ 1 .. 34 ] characters

Identification assigned by an institution.

schemeName
string [ 1 .. 35 ] characters
Example: "BBANIdentifier"

Name of the identification scheme, in PascalCase. Possible ISO 20022 compliant values names are: IssuerIdentificationNumber, BBANIdentifier, CHIPSUniversalIdentifier, UPICIdentifier, IBANIdentifier

issuer
string [ 1 .. 35 ] characters

Entity that assigns the identification.

loanBranchId
string (ServicerBranchId) [ 1 .. 36 ] characters
Example: "SEA_1"

Identification of the account servicer institution at branch level or operation level.

loanType
required
string (LoanType) [ 1 .. 35 ] characters
Example: "Personal"

Type of the account. Some possible BIAN compliant values are: Personal, Consumer,
Corporate, Lease, Syndicated, Mortgage, Conforming, Merchandising, LineOfCredit, RevolvingCredit, LoanAgainstSecurities.

ownershipType
required
string (AccountOwnershipType) [ 1 .. 35 ] characters
Example: "SingleOwnerAccount"

Specifies the type of account ownership. Possible ISO 20022 compliant values names are: JointAccountWithSurvivorshipRights, JointAccountInCommon, CustodialAccount, SingleOwnerAccount, JointAccount, Corporation, Business, FormalPartnership, FormalTrust, Nominee, NonProfitOrganization, NotForProfitOrganization, ForProfit, EUResidualEntity, GovernmentOrganization, LimitedLiabilityCompany, RegisteredInvestmentCompany, Entrepreneurial, Unincorporated, LimitedPartnership, LimitedLiabilityPartnership, BareOwner, Usufructuary, Fiduciary, ServicerEmployeeAccount, BusinessTrust, FamilyTrust, Estate.

productId
string (ProductId) [ 1 .. 36 ] characters
Example: "PD_CA_0002"
name
string (AccountName) [ 1 .. 70 ] characters
Example: "Hermes PD_CA 0002"

Name of the account. It provides an additional means of identification, and is designated by the account servicer in agreement with the account owner.

accountPurpose
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
currency
string (CurrencyCode) = 3 characters ^([A-Z]{3})?$
Example: "USD"

Three contiguous letters for the representation of currencies and funds. Valid currency codes are registered with the ISO 4217 Maintenance Agency.

object (LoanContract)

Contract by which an amount of money in exchange for future repayment of the principal amount along with interest or other finance charges.

documentId
string (Id) [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"
documentReference
string [ 1 .. 35 ] characters

Document location.

version
string [ 1 .. 18 ] characters

Document version indentification.

signOffDate
string <date>
Example: "2022-04-17"

Signoff date of the document.

issueDate
string <date>
Example: "2022-04-17"

Issue date of the document.

purpose
string [ 1 .. 35 ] characters

Specifies the function of the document.

fromDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period starts.

upToDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period ends.

periodNumber
integer

Sequence number of the period.

object (Jurisdiction)

Area with a set of laws under the control of a system which are different from neighbouring areas

countrySubdivision
string (CountrySubdivision) [ 1 .. 35 ] characters
Example: "Oregon"

Name of a country subdivision such as state, region, county.

townName
string (TownName) [ 1 .. 35 ] characters
Example: "Tualatin"

Name of a built-up area, with defined boundaries, and a local government.

country
string (CountryCode) ^([A-Z]{2,2})?$
Example: "US"

Country name obtained from the United Nations (ISO 3166, Alpha-2 code).

amount
string <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Loan amount as defined in the contract.

borrower
string [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"

Party that is specified as the buyer for this loan agreement.

lender
string [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"

Party that is specified as the seller for this loan agreement.

maturityDate
string <date>
Example: "2022-04-17"

Planned final repayment date at the time of issuance.

object

Planned final repayment date at the time of issuance.

documentId
string (Id) [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"
documentReference
string [ 1 .. 35 ] characters

Document location.

version
string [ 1 .. 18 ] characters

Document version indentification.

signOffDate
string <date>
Example: "2022-04-17"

Signoff date of the document.

issueDate
string <date>
Example: "2022-04-17"

Issue date of the document.

purpose
string [ 1 .. 35 ] characters

Specifies the function of the document.

Array of objects (InterestCalculation)
Array
name
string (InterestName) [ 1 .. 35 ] characters
Example: "Deposit"

Name of the interest that applies to the account. For instance, Deposit.

code
string <= 50 characters

Interest code used by the account servicer.

dayCountBasis
string (InterestComputationMethod) [ 1 .. 50 ] characters
Example: "30360AmericanBasicRule"

Specifies the method used to compute accruing interest of a financial instrument. Possible Values: 30360AmericanBasicRule, IC30365, IC30Actual, Actual360, Actual365Fixed, ActualActualICMA, IC30E360orEuroBondBasismodel1, ActualActualISDA, Actual365LorActuActubasisRule, ActualActualAFB, IC30360ICMAor30360basicrule, IC30E2360orEurobondbasismodel2, IC30E3360orEurobondbasismodel3, Actual365NL, Narrative, ActualActualUltimo, IC30EPlus360, Actual364, Business252, Actual360NL, OneOne. DateDeposit365365, DateDeposit365360, LastInterest365365, LastInterest365360, EqualPayments365365, EqualPayments365360

accruedDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

nextInterestDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

rate
string <= 23 characters ^100|(([1-9][0-9]{0,1})([.][0-9]{0,8}){0,1})$...
Example: "25"

The actual interest rate.

object

The period funds are earning interest.

rateType
string (InterestRateType) [ 1 .. 35 ] characters
Example: "Fixed"

Specifies the type of interest rate. Some ISO 20022 compliant values are: Fixed, Forfeit, Variable, StepUp, Scheduled, Unscheduled, Discount, FixedRateUnderlyingExposureForLife, FixedRateUnderlyingExposureWithCompulsoryFutureSwitchToFloating, FixedWithFuturePeriodicResets, FloatingLinkedToIndex, FloatingRateUnderlyingExposureForLife, FloatingRateUnderlyingExposureWithCap, FloatingRateUnderlyingExposureWithFloor, FloatingRateUnderlyingExposureWithFloorAndCap, Modular, ObligorSwapped, SwicthOptionality

compoundingMethod
string (InterestCompoundingMethod) [ 1 .. 35 ] characters
Example: "Deposit"

Inteterst compounding method: Possible Values: Simple, Daily, Continuous.

object (Frequency)

Specifies an event frequency

object (VariableInterestCalculation)

Specifies the parameters to be used for variable interest.

dateNextInterest
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

oneDayInterest
string (PositiveAmountInCents) <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: 0

object (InterestPayment)

Set of attributes related to the interest payment.

Array of objects (Balance)

Total amounts related to an interest

object (InterestDetails)

Set of attributes related to the interest calculus.

object (InterestRenewalDetails)

Detailed interest attributes related to rate change and account maturity.

object (InterestDetails)

Set of attributes related to the interest calculus.

object (InterestCycle)

Set of parameters used to calculate an interest cycle.

lastCalculus
string (PositiveAmountInCents) <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: 0

Array of objects (ChargeCalculation)
Array
fromDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period starts.

upToDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period ends.

periodNumber
integer

Sequence number of the period.

name
string (ChargeName) [ 1 .. 60 ] characters
Example: "CardLatePayment"

Name of the charge calculation in PascalCase. Possible values: Overdraft, CardLatePayment, CashAdvance, LatePayment, CashWithdrawal, EarlyWithdrawal

amount
string <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Amount charged for the service.

rate
string <= 23 characters ^100|(([1-9][0-9]{0,1})([.][0-9]{0,8}){0,1})$...
Example: "25"

Rate applied on a basis amount to calculate the service charge.

chargeType
string (ChargeType) [ 1 .. 35 ] characters
Example: "ManagementFee"

Type of service for which a charge is asked or paid. Some possible ISO 20022 compliant values are: BrokerageFee, Commission, BackEndLoad, FrontEndLoad, Switch, DilutionLevy, Discount, ManagementFee, TransferFee, MatchingFees, PostageCharge, RegulatoryFee, ShippingCharge, ServiceProvisionFee, SpecialConcessions, PartAcquis, Penalty, ContingencyDeferredSalesCharge, Equalisation, CorrespondentBankCharge, Premium, Initial, AdvisoryFee, CustodyFee, PublicationFee, AccountingFee, SignatureService, StorageAtDestination, StorageAtOrigin, Packaging, PickUp, DangerousGoodsFee, SecurityCharge, InsurancePremium, CollectFreight, ClearanceAndHandlingAtOrigin, ClearanceAndHandlingAtDestination, AirWayBillFee, TransportCharges, UCITSCommission, SpeciallyAgreedFrontEndLoad, ADRFee, IssuanceCancellationFee, MiscellaneousFee, IssuanceFee.

calculationMethodCode
string [ 1 .. 60 ] characters

Servicer charge calculation code

calculationBasis
string (CalculationBasis) [ 1 .. 35 ] characters
Example: "Monthly"

Specifies the calculation basis of a charge or fee. Some possible ISO 20022 compliant values are: Average, Daily, Monthly, Annual, FullTerm, RemainingTerm

bearerType
string (ChargeBearerType) [ 1 .. 35 ] characters
Example: "Shared"

Specifies which party(ies) will pay charges due for processing of the instruction. BorneByDebtor, BorneByCreditor, Shared, FollowingServiceLevel

maximumAmount
string <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Maximum amount of money asked or paid for the charge.

object (InterestCalculation)

Set of parameters used to calculate an interest.

debitIndicator
boolean

Indicates whether the charge is automatically debited from the defined account.

accountToCharge
string (AccountId) [ 1 .. 36 ] characters
Example: "0dd926fe-1ca2-11ed-861d-0242ac120002"

Identification assigned by the account service institution (Servicer).

object (Frequency)

Specifies an event frequency

Array of objects (TotalAmount)

Total amounts related to a charge

Array of objects (LoanContractTranche)

Provides details on the tranches defined for the loan contract.

Array
sequenceNumber
string <= 20 characters
Example: "1"

Unique sequence number of the tranche.

expectedDate
string <date>
Example: "2022-04-17"

Expected tranche payment date.

dueDate
string <date>
Example: "2022-04-17"

Loan tranche due date.

amount
string <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Amount of the tranche as defined in the loan contract.

object

Loan tranche duration.

object (TemporalDuration)

Describes a temporal duration.

unit
required
string [ 1 .. 36 ] characters
Example: "Months"

Unit that describes the duration.

value
required
integer <= 999

Value of the duration in number of units.

Array of objects (RepaymentSchedule)

Schedule of the principal payments and interests defined for the loan contract.

Array
repaymentScheduleId
string [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"

Unique and unambiguous identification of the payment schedule.

amount
string <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Amount to be paid

expectedDate
string <date>
Example: "2022-04-17"

Expected date whereby the amount must be paid.

dueDate
string <date>
Example: "2022-04-17"

Latest date whereby the amount of money must be paid.

repaymentType
string (LoanPaymentType) [ 1 .. 35 ] characters
Example: "Principal"

Possible values are: Interest, Principal.

object (CreditTransferDetail)

Further details on the credit transfer instruction

Array of objects (Collateral)
Array
amount
string <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Value of the collateral as an amount.

collateralType
string (CollateralType) [ 1 .. 60 ] characters

Specifies the type of collateral. Some possible values are: LetterOfCredit, Cash, Securities, PhysicalEntities, Insurance, StockCertificate, Bond, BankGuarantee, Commodity, Automobile, IndustrialVehicle, CommercialTruck, RailVehicle, NauticalCommercialVehicle, NauticalLeisureVehicle, Aeroplane, MachineTool, IndustrialEquipment, OfficeEquipment, ITEquipment, MedicalEquipment, EnergyRelatedEquipment, CommercialBuilding, ResidentialBuilding. IndustrialBuilding, OtherVehicle, OtherEquipment, OtherRealEstate, OtherGoodsOrInventory, Guarantee, OtherFinancialAsset, MixedCategories.

object (Agreement)

Agreement between two trading parties that contains information about their relative duties and rights regarding collateral.

Array of objects (SyndicatedLoanLender)

Loan offered by a group of lenders (called a syndicate).

Array
lenderId
required
string [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"

Party which provides an amount of money available to others to borrow.

lenderType
required
string (PartyType)
Example: "Person"

Possible values are: Person, Organization. Also other types of servicer internal entities: ServicerOfficer

amount
string <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Amount of the part in the syndicated loan.

share
string <= 23 characters ^100|(([1-9][0-9]{0,1})([.][0-9]{0,8}){0,1})$...
Example: "25"

Share part in the syndicated loan.

intraCompanyLoanIndicator
boolean
Example: false

Indicates whether the loan is an intra-company loan.

required
Array of objects (AccountParty)
Array
partyId
required
string (Id) [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"
partyType
required
string (PartyType)
Example: "Person"

Possible values are: Person, Organization. Also other types of servicer internal entities: ServicerOfficer

partyAccountRole
required
string (AccountPartyRole) [ 1 .. 35 ] characters
Example: "AccountOwner"

Type of the account party role. Some possibles values are: Comaker, Cosigner, AccountOwner, AccountSigner, LiquidityManager, Endorser, LimitManager, PaymentManager, Reader, BackupManager, SettlementManager, FundManagementCompany, TransferAgent, FundAccountant, Registrar, InvestmentManager, Custodian, Auditor, PayingAgent, CashCorrespondent, DataProvider, FinalAgent, Investor, FirstAgent, Intermediary, Distributor, Concentrator, UnderlyingClient1, UnderlyingClient2, TransmittingAgent, FundBroker, FinancialAdvisor, ContactPersonAtInstructingPartyInstitution, ContactPersonAtExecutingPartyInstitution, NameOfAgentToOrder, PrimeBroker, Internal, LegalGuardian, DecisionMaker, Guarantor, LoanLender, LoanBorrower, LoanCoBorrower, PrimaryOwner, Trustee, CustodianForMinor, Nominee, SecondaryOwner, Executor, Beneficiary, PrimaryServicerOfficer, SecondaryServicerOfficer, AccountOpenningOfficer, CustomerServiceOfficer.

partyName
string (PartyName) [ 1 .. 350 ] characters
Example: "Jane Birkin"

Name by which a party is known and which is usually used to identify that party.

Array of objects (RelatedAccount)
Array
accountRelationType
required
string (AccountRelationType)
Example: "Child"

Account relation role. Possible values are: Parent, Child, Group.

accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: "0dd926fe-1ca2-11ed-861d-0242ac120002"

Identification assigned by the account service institution (Servicer).

accountNumber
string (AccountNumber) <= 30 characters
Example: "012345678"

The account number or Basic Bank Account Number (BBAN). A Basic Bank Account Number (BBAN) is a bank account number that includes the domestic bank code, branch identifier, and account number. It is a unique identifier for a bank account within a specific country.

accountType
required
string (RelatedAccountType) [ 1 .. 35 ] characters
Example: "Checking"

Type of the account. Some possible ISO 20022 compliant values are: Checking, CardAccount, CashPayment, Charges, CashIncome, Commission, ClearingParticipantSettlementAccount, LimitedLiquiditySavingsAccount, MarginalLending, MoneyMarket, NonResidentExternal, Overdraft, OverNightDeposit, Settlement, Salary, Savings, Tax, TransactingAccount, CashTrading, VirtualAccount, CreditCard, DebitCard, Universal, Investment, EpurseCard, CertificateOfDeposit, MoneyMarketChecking, RetirementAccount, StockOrBond, PrePaid, FleetCard, Cash, DebitAccount, CreditAccount, Benefit, HealthSavingsAccount, FlexibleSpendingAccount, ForBenefitOf, Estate, ClientTrustAccount, LawyersTrustAccount, KeoghPlanAccount, UniformTransfersToMinorsAct, UniformGiftsToMinorsAct, ReserveFunds, SelfDirectedBrokerage, Loan, Ledger.

name
string (AccountName) [ 1 .. 70 ] characters
Example: "Hermes PD_CA 0002"

Name of the account. It provides an additional means of identification, and is designated by the account servicer in agreement with the account owner.

Array of objects (Restriction)
Array
name
required
string [ 1 .. 60 ] characters
Example: "WireTransferIn"

Name of the restriction in PascalCase. Possible values: WireTransferIn, WireTransferOut, ForeignIncomingWires, ForeignOutgoingWires, ACHTransfers, InternetBankingTransfer, InternetView, InternetInquiry, ForeignOutgoingIran, Withdrawals, Renew, Transfers

restrictionPurpose
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
enableIndicator
boolean
Example: true

Indicates whether the capability is allowed or not.

validFrom
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

validUntil
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

Array of objects (Limit)
Array
name
required
string [ 1 .. 60 ] characters
Example: "creditLimit"

Name of the limit in PascalCase. Possible values: Overdraft, CreditLimit, CreditCard, Withdraw, CreditCardWithdraw, ForeignFeesWaived, CreditTransactions, DebitTransactions

limitTypeCode
string (LimitType) <= 35 characters
Example: "DirectDebit"

Specifies the type of risk management limit. Possible ISO 20020 compliant values are: Bilateral, NetBilateral, IndirectBilateral, Global, MandatoryBilateral, DiscretionaryBilateral, DirectDebit, SingleCustomerDirectDebit, SingleFinancialInstitutionDirectDebit, TotalDailyCustomerDirectDebit, TotalDailyFinancialInstitutionDirectDebit, AutoCollateralisation, UnsecuredCredit, ExternalGuarantee

channelType
string [ 1 .. 30 ] characters

Channel type for which this limit applies. Possible values: OnlineATM, OfflineATM, ATM, SaleTerminal

amount
string <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Amount limit

number
integer

Number limit.

percentage
string (Percentage) <= 23 characters ^100|(([1-9][0-9]{0,1})([.][0-9]{0,8}){0,1})$...
Example: "25"

Value expressed as a percentage, rate expressed as a percentage, that is, in hundredths, for example, 0.7 is 7/10 of a percent, and 7.0 is 7%. total number of digits: 11 number of digits in fractional part: 10 Max Value: 100

object (Period)
object (Frequency)

Specifies an event frequency

usedAmount
string <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Amount limit used

usedNumber
integer

Number limit used.

usedPercentage
string (Percentage) <= 23 characters ^100|(([1-9][0-9]{0,1})([.][0-9]{0,8}){0,1})$...
Example: "25"

Value expressed as a percentage, rate expressed as a percentage, that is, in hundredths, for example, 0.7 is 7/10 of a percent, and 7.0 is 7%. total number of digits: 11 number of digits in fractional part: 10 Max Value: 100

status
string (LimitStatus) <= 35 characters
Example: "Requested"

Specifies the current status of a limit. Possible ISO 20020 compliant values are: Enabled, Disabled, Deleted, Requested

object (Frequency)

Specifies an event frequency

object (FinancialStatement)

Specifies financial statement details.

object (Frequency)

Specifies an event frequency

cycleType
string [ 1 .. 35 ] characters

Specifies a cycle type. Possible values: Temporal, AtMaturity, InterestCycle, FromLastStatement, LastDay.

cycle
string [ 1 .. 35 ] characters
Example: "Monthly"

Specifies a temporal cycle. Possible values: Annual, Monthly, Quarterly, SemiAnnual, Weekly, Daily, Once, IntraDay, Overnight, TenDays, Fortnightly, TriggeredByMovement, Never, Rate, OnCreditEvent, Upfront, OnExpiry, Hourly, TriAnnual, Bimonthly, OnDemand, Shift, TwiceAWeek, XDays, XMonths, XYears.

every
integer <= 999
Example: 15

Custom cycle definition. Number of XDays, XMonths, XYears.

weekDay
string <= 3
Example: "Tuesday"

Day of the week. Possible Values: Monday, Tuesday, Wednesday, Thursday, Friday.

weekNumbers
Array of strings[ items <= 3 ]
Example: ["1st"]
days
Array of integers[ items <= 31 ]
Example: [30]
startDay
string (MonthDay) ([0-9]{2})-([0-9]{2})
Example: "04-17"

A particular point in the year expressed in the MM-DD format.

communicationMethod
string (CommunicationChannelName) [ 1 .. 35 ] characters
Example: "Email"

Channel used to communicate with a party. Possible Values: Email, Fax, File, Online, PostalService, LiveSupport, ATM, IVR, Kiosk, Mobile, OnlineBanking, Phone, SMS, Card, InPerson.

format
string (DocumentFormat) [ 1 .. 35 ] characters
Example: "PDF"

Specifies a choice of format for a document. Possible Values: PDF, HTML

templateCode
string (StatementTemplateId) [ 1 .. 36 ] characters
Example: "1"

Template used to create the statement document. This is an external code provided by the account servicer.

object (Period)
fromDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period starts.

upToDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period ends.

periodNumber
integer

Sequence number of the period.

lastStatementDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

lastRegularStatementDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

accountNameIndicator
boolean

Indicates whether the account name is printed on the statement.

Array of objects (Balance)

Statement total amounts

Array
balanceName
required
string (BalanceName) [ 1 .. 17 ] characters
Example: "Available"

Specifies the nature of the balance. Possible values: Current, Available, Pending, Blocked, Previous, PendingLedger, LastAnniversary, CurrentAccrued, PreviousAccrued, CurrentWithLastCalculus, CarriedAdjustment, PaidWithPenalties, Accrued, Penalty, CollectionLedger, LastLedger, CurrentLedger, Withheld.

amount
required
string (AmountInCents) <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: -9999999999999.99999999

currency
string (CurrencyCode) = 3 characters ^([A-Z]{3})?$
Example: "USD"

Three contiguous letters for the representation of currencies and funds. Valid currency codes are registered with the ISO 4217 Maintenance Agency.

calculationDate
string <date-time>
Example: "2022-04-17T08:00:00Z"

Specifies the date and time at which the balance is calculated.

preferredLanguage
string (PreferredLanguage) [ 1 .. 35 ] characters
Example: "English"

Language of the contact person. Names according to the language list provided in the ISO 639-1 codes. Some possible values: Chinese, Spanish, French, English, Japanese, Italian, German.

combineType
string [ 1 .. 36 ] characters
Example: "SavingsSatement"

Indicates whether account transactions are printed on a combined statement. Possible combinations: CheckingStatement, SavingsSatement.

category
string (StatementCategory) [ 1 .. 36 ] characters
Example: "BalanceSheet"

Used to categorize the statement. Possible Values: BalanceSheet, ProfitAndLoss

subcategory
string (StatementSubcategory) [ 1 .. 36 ] characters
Example: "Cash"

Used to subcategorize the statement. Possible Values: Cash, AccountReceivable, Inventory, CurrentAssets

profitabilityModelId
string (StatementModelId) [ 1 .. 36 ] characters
Example: "1"

Model used to calculate customer profitability. This is an external id provided by the account servicer.

lastIRAStatementDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

supplementaryData
object (SupplementaryData)

Additional information that cannot be captured in the structured elements and/or any other specific block. If this information need to be converted in ISO Messages, must be ISO 20022 compliant: it requires development of a compliant message extension model and its components must be registered in the ISO 20022 Data Dictionary. https://www.iso20022.org/catalogue-messages/additional-content-messages/supplementary-data

Responses

Request samples

Content type
application/json
{
  • "compositeId": {
    },
  • "accountBranchId": "SEA_1",
  • "accountNumber": "012345678",
  • "routingNumbers": [
    ],
  • "identifiers": [
    ],
  • "loanBranchId": "SEA_1",
  • "loanType": "Personal",
  • "ownershipType": "SingleOwnerAccount",
  • "productId": "PD_CA_0002",
  • "name": "Hermes PD_CA 0002",
  • "accountPurpose": "This is a description.",
  • "currency": "USD",
  • "contract": {
    },
  • "parties": [
    ],
  • "relatedAccounts": [
    ],
  • "restrictions": [
    ],
  • "limits": [
    ],
  • "statement": {
    },
  • "supplementaryData": { }
}

Response samples

Content type
application/json
{
  • "compositeId": {
    },
  • "accountBranchId": "SEA_1",
  • "accountNumber": "012345678",
  • "routingNumbers": [
    ],
  • "identifiers": [
    ],
  • "loanBranchId": "SEA_1",
  • "loanType": "Personal",
  • "ownershipType": "SingleOwnerAccount",
  • "productId": "PD_CA_0002",
  • "name": "Hermes PD_CA 0002",
  • "accountPurpose": "This is a description.",
  • "currency": "USD",
  • "contract": {
    },
  • "parties": [
    ],
  • "relatedAccounts": [
    ],
  • "restrictions": [
    ],
  • "limits": [
    ],
  • "statement": {
    },
  • "supplementaryData": { },
  • "status": "Withdrawn",
  • "statusDateAndTime": "2022-04-17T08:00:00Z",
  • "substatus": "string",
  • "openDate": "2022-04-17",
  • "fundedDate": "2022-04-17",
  • "disbursalDate": "2022-04-17",
  • "balances": [
    ],
  • "transactionGroups": [
    ],
  • "accountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "relatedCards": [
    ],
  • "principalAmount": "100",
  • "accruedCapitalisationAmount": "100",
  • "nextPayment": {
    },
  • "lastPayment": {
    }
}

Retrieves a Loan

Authorizations:
jwtopenIdConnect
path Parameters
loanId
required
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Loan Identification

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Responses

Response samples

Content type
application/json
{
  • "compositeId": {
    },
  • "accountBranchId": "SEA_1",
  • "accountNumber": "012345678",
  • "routingNumbers": [
    ],
  • "identifiers": [
    ],
  • "loanBranchId": "SEA_1",
  • "loanType": "Personal",
  • "ownershipType": "SingleOwnerAccount",
  • "productId": "PD_CA_0002",
  • "name": "Hermes PD_CA 0002",
  • "accountPurpose": "This is a description.",
  • "currency": "USD",
  • "contract": {
    },
  • "parties": [
    ],
  • "relatedAccounts": [
    ],
  • "restrictions": [
    ],
  • "limits": [
    ],
  • "statement": {
    },
  • "supplementaryData": { },
  • "status": "Withdrawn",
  • "statusDateAndTime": "2022-04-17T08:00:00Z",
  • "substatus": "string",
  • "openDate": "2022-04-17",
  • "fundedDate": "2022-04-17",
  • "disbursalDate": "2022-04-17",
  • "balances": [
    ],
  • "transactionGroups": [
    ],
  • "accountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "relatedCards": [
    ],
  • "principalAmount": "100",
  • "accruedCapitalisationAmount": "100",
  • "nextPayment": {
    },
  • "lastPayment": {
    }
}

Updates a Loan

Use the JSON Merge Patch standard https://tools.ietf.org/html/rfc7396

Authorizations:
jwtopenIdConnect
path Parameters
loanId
required
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Loan Identification

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Request Body schema: application/merge-patch+json
object (CompositeAccountIdentifier)

The composite account identifier provides unique account identification when overlaying its parts. [branch-type-subtype-number]

branch
string [ 1 .. 10 ] characters
Example: "1"

Account branch

type
string [ 1 .. 10 ] characters
Example: "DD"

Account type.

subtype
string [ 1 .. 10 ] characters
Example: "HA"

Account subtype

number
required
string [ 1 .. 20 ] characters
Example: "12345"

Account number

accountBranchId
string (ServicerBranchId) [ 1 .. 36 ] characters
Example: "SEA_1"

Identification of the account servicer institution at branch level or operation level.

accountNumber
string (AccountNumber) <= 30 characters
Example: "012345678"

The account number or Basic Bank Account Number (BBAN). A Basic Bank Account Number (BBAN) is a bank account number that includes the domestic bank code, branch identifier, and account number. It is a unique identifier for a bank account within a specific country.

Array of objects (RoutingNumber)
Array
number
string (ABANumber) = 9 characters
Example: "012345678"

The routing number (sometimes referred to as an ABA routing number, regarding the American Bankers Association) is a sequence of nine digits used by banks to identify specific financial institutions within the United States.

routingNumberType
string (RoutingNumberType) = 9 characters
Example: "ACH"

Different types of payments may require different bank routing numbers. Some possible values: ACH, WIRE, ElectronicCheck, PaperCheck

Array of objects (AccountIdentification)
Array
identification
string [ 1 .. 34 ] characters

Identification assigned by an institution.

schemeName
string [ 1 .. 35 ] characters
Example: "BBANIdentifier"

Name of the identification scheme, in PascalCase. Possible ISO 20022 compliant values names are: IssuerIdentificationNumber, BBANIdentifier, CHIPSUniversalIdentifier, UPICIdentifier, IBANIdentifier

issuer
string [ 1 .. 35 ] characters

Entity that assigns the identification.

loanBranchId
string (ServicerBranchId) [ 1 .. 36 ] characters
Example: "SEA_1"

Identification of the account servicer institution at branch level or operation level.

loanType
required
string (LoanType) [ 1 .. 35 ] characters
Example: "Personal"

Type of the account. Some possible BIAN compliant values are: Personal, Consumer,
Corporate, Lease, Syndicated, Mortgage, Conforming, Merchandising, LineOfCredit, RevolvingCredit, LoanAgainstSecurities.

ownershipType
required
string (AccountOwnershipType) [ 1 .. 35 ] characters
Example: "SingleOwnerAccount"

Specifies the type of account ownership. Possible ISO 20022 compliant values names are: JointAccountWithSurvivorshipRights, JointAccountInCommon, CustodialAccount, SingleOwnerAccount, JointAccount, Corporation, Business, FormalPartnership, FormalTrust, Nominee, NonProfitOrganization, NotForProfitOrganization, ForProfit, EUResidualEntity, GovernmentOrganization, LimitedLiabilityCompany, RegisteredInvestmentCompany, Entrepreneurial, Unincorporated, LimitedPartnership, LimitedLiabilityPartnership, BareOwner, Usufructuary, Fiduciary, ServicerEmployeeAccount, BusinessTrust, FamilyTrust, Estate.

productId
string (ProductId) [ 1 .. 36 ] characters
Example: "PD_CA_0002"
name
string (AccountName) [ 1 .. 70 ] characters
Example: "Hermes PD_CA 0002"

Name of the account. It provides an additional means of identification, and is designated by the account servicer in agreement with the account owner.

accountPurpose
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
currency
string (CurrencyCode) = 3 characters ^([A-Z]{3})?$
Example: "USD"

Three contiguous letters for the representation of currencies and funds. Valid currency codes are registered with the ISO 4217 Maintenance Agency.

object (LoanContract)

Contract by which an amount of money in exchange for future repayment of the principal amount along with interest or other finance charges.

documentId
string (Id) [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"
documentReference
string [ 1 .. 35 ] characters

Document location.

version
string [ 1 .. 18 ] characters

Document version indentification.

signOffDate
string <date>
Example: "2022-04-17"

Signoff date of the document.

issueDate
string <date>
Example: "2022-04-17"

Issue date of the document.

purpose
string [ 1 .. 35 ] characters

Specifies the function of the document.

fromDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period starts.

upToDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period ends.

periodNumber
integer

Sequence number of the period.

object (Jurisdiction)

Area with a set of laws under the control of a system which are different from neighbouring areas

countrySubdivision
string (CountrySubdivision) [ 1 .. 35 ] characters
Example: "Oregon"

Name of a country subdivision such as state, region, county.

townName
string (TownName) [ 1 .. 35 ] characters
Example: "Tualatin"

Name of a built-up area, with defined boundaries, and a local government.

country
string (CountryCode) ^([A-Z]{2,2})?$
Example: "US"

Country name obtained from the United Nations (ISO 3166, Alpha-2 code).

amount
string <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Loan amount as defined in the contract.

borrower
string [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"

Party that is specified as the buyer for this loan agreement.

lender
string [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"

Party that is specified as the seller for this loan agreement.

maturityDate
string <date>
Example: "2022-04-17"

Planned final repayment date at the time of issuance.

object

Planned final repayment date at the time of issuance.

documentId
string (Id) [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"
documentReference
string [ 1 .. 35 ] characters

Document location.

version
string [ 1 .. 18 ] characters

Document version indentification.

signOffDate
string <date>
Example: "2022-04-17"

Signoff date of the document.

issueDate
string <date>
Example: "2022-04-17"

Issue date of the document.

purpose
string [ 1 .. 35 ] characters

Specifies the function of the document.

Array of objects (InterestCalculation)
Array
name
string (InterestName) [ 1 .. 35 ] characters
Example: "Deposit"

Name of the interest that applies to the account. For instance, Deposit.

code
string <= 50 characters

Interest code used by the account servicer.

dayCountBasis
string (InterestComputationMethod) [ 1 .. 50 ] characters
Example: "30360AmericanBasicRule"

Specifies the method used to compute accruing interest of a financial instrument. Possible Values: 30360AmericanBasicRule, IC30365, IC30Actual, Actual360, Actual365Fixed, ActualActualICMA, IC30E360orEuroBondBasismodel1, ActualActualISDA, Actual365LorActuActubasisRule, ActualActualAFB, IC30360ICMAor30360basicrule, IC30E2360orEurobondbasismodel2, IC30E3360orEurobondbasismodel3, Actual365NL, Narrative, ActualActualUltimo, IC30EPlus360, Actual364, Business252, Actual360NL, OneOne. DateDeposit365365, DateDeposit365360, LastInterest365365, LastInterest365360, EqualPayments365365, EqualPayments365360

accruedDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

nextInterestDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

rate
string <= 23 characters ^100|(([1-9][0-9]{0,1})([.][0-9]{0,8}){0,1})$...
Example: "25"

The actual interest rate.

object

The period funds are earning interest.

rateType
string (InterestRateType) [ 1 .. 35 ] characters
Example: "Fixed"

Specifies the type of interest rate. Some ISO 20022 compliant values are: Fixed, Forfeit, Variable, StepUp, Scheduled, Unscheduled, Discount, FixedRateUnderlyingExposureForLife, FixedRateUnderlyingExposureWithCompulsoryFutureSwitchToFloating, FixedWithFuturePeriodicResets, FloatingLinkedToIndex, FloatingRateUnderlyingExposureForLife, FloatingRateUnderlyingExposureWithCap, FloatingRateUnderlyingExposureWithFloor, FloatingRateUnderlyingExposureWithFloorAndCap, Modular, ObligorSwapped, SwicthOptionality

compoundingMethod
string (InterestCompoundingMethod) [ 1 .. 35 ] characters
Example: "Deposit"

Inteterst compounding method: Possible Values: Simple, Daily, Continuous.

object (Frequency)

Specifies an event frequency

object (VariableInterestCalculation)

Specifies the parameters to be used for variable interest.

dateNextInterest
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

oneDayInterest
string (PositiveAmountInCents) <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: 0

object (InterestPayment)

Set of attributes related to the interest payment.

Array of objects (Balance)

Total amounts related to an interest

object (InterestDetails)

Set of attributes related to the interest calculus.

object (InterestRenewalDetails)

Detailed interest attributes related to rate change and account maturity.

object (InterestDetails)

Set of attributes related to the interest calculus.

object (InterestCycle)

Set of parameters used to calculate an interest cycle.

lastCalculus
string (PositiveAmountInCents) <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: 0

Array of objects (ChargeCalculation)
Array
fromDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period starts.

upToDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period ends.

periodNumber
integer

Sequence number of the period.

name
string (ChargeName) [ 1 .. 60 ] characters
Example: "CardLatePayment"

Name of the charge calculation in PascalCase. Possible values: Overdraft, CardLatePayment, CashAdvance, LatePayment, CashWithdrawal, EarlyWithdrawal

amount
string <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Amount charged for the service.

rate
string <= 23 characters ^100|(([1-9][0-9]{0,1})([.][0-9]{0,8}){0,1})$...
Example: "25"

Rate applied on a basis amount to calculate the service charge.

chargeType
string (ChargeType) [ 1 .. 35 ] characters
Example: "ManagementFee"

Type of service for which a charge is asked or paid. Some possible ISO 20022 compliant values are: BrokerageFee, Commission, BackEndLoad, FrontEndLoad, Switch, DilutionLevy, Discount, ManagementFee, TransferFee, MatchingFees, PostageCharge, RegulatoryFee, ShippingCharge, ServiceProvisionFee, SpecialConcessions, PartAcquis, Penalty, ContingencyDeferredSalesCharge, Equalisation, CorrespondentBankCharge, Premium, Initial, AdvisoryFee, CustodyFee, PublicationFee, AccountingFee, SignatureService, StorageAtDestination, StorageAtOrigin, Packaging, PickUp, DangerousGoodsFee, SecurityCharge, InsurancePremium, CollectFreight, ClearanceAndHandlingAtOrigin, ClearanceAndHandlingAtDestination, AirWayBillFee, TransportCharges, UCITSCommission, SpeciallyAgreedFrontEndLoad, ADRFee, IssuanceCancellationFee, MiscellaneousFee, IssuanceFee.

calculationMethodCode
string [ 1 .. 60 ] characters

Servicer charge calculation code

calculationBasis
string (CalculationBasis) [ 1 .. 35 ] characters
Example: "Monthly"

Specifies the calculation basis of a charge or fee. Some possible ISO 20022 compliant values are: Average, Daily, Monthly, Annual, FullTerm, RemainingTerm

bearerType
string (ChargeBearerType) [ 1 .. 35 ] characters
Example: "Shared"

Specifies which party(ies) will pay charges due for processing of the instruction. BorneByDebtor, BorneByCreditor, Shared, FollowingServiceLevel

maximumAmount
string <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Maximum amount of money asked or paid for the charge.

object (InterestCalculation)

Set of parameters used to calculate an interest.

debitIndicator
boolean

Indicates whether the charge is automatically debited from the defined account.

accountToCharge
string (AccountId) [ 1 .. 36 ] characters
Example: "0dd926fe-1ca2-11ed-861d-0242ac120002"

Identification assigned by the account service institution (Servicer).

object (Frequency)

Specifies an event frequency

Array of objects (TotalAmount)

Total amounts related to a charge

Array of objects (LoanContractTranche)

Provides details on the tranches defined for the loan contract.

Array
sequenceNumber
string <= 20 characters
Example: "1"

Unique sequence number of the tranche.

expectedDate
string <date>
Example: "2022-04-17"

Expected tranche payment date.

dueDate
string <date>
Example: "2022-04-17"

Loan tranche due date.

amount
string <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Amount of the tranche as defined in the loan contract.

object

Loan tranche duration.

object (TemporalDuration)

Describes a temporal duration.

unit
required
string [ 1 .. 36 ] characters
Example: "Months"

Unit that describes the duration.

value
required
integer <= 999

Value of the duration in number of units.

Array of objects (RepaymentSchedule)

Schedule of the principal payments and interests defined for the loan contract.

Array
repaymentScheduleId
string [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"

Unique and unambiguous identification of the payment schedule.

amount
string <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Amount to be paid

expectedDate
string <date>
Example: "2022-04-17"

Expected date whereby the amount must be paid.

dueDate
string <date>
Example: "2022-04-17"

Latest date whereby the amount of money must be paid.

repaymentType
string (LoanPaymentType) [ 1 .. 35 ] characters
Example: "Principal"

Possible values are: Interest, Principal.

object (CreditTransferDetail)

Further details on the credit transfer instruction

Array of objects (Collateral)
Array
amount
string <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Value of the collateral as an amount.

collateralType
string (CollateralType) [ 1 .. 60 ] characters

Specifies the type of collateral. Some possible values are: LetterOfCredit, Cash, Securities, PhysicalEntities, Insurance, StockCertificate, Bond, BankGuarantee, Commodity, Automobile, IndustrialVehicle, CommercialTruck, RailVehicle, NauticalCommercialVehicle, NauticalLeisureVehicle, Aeroplane, MachineTool, IndustrialEquipment, OfficeEquipment, ITEquipment, MedicalEquipment, EnergyRelatedEquipment, CommercialBuilding, ResidentialBuilding. IndustrialBuilding, OtherVehicle, OtherEquipment, OtherRealEstate, OtherGoodsOrInventory, Guarantee, OtherFinancialAsset, MixedCategories.

object (Agreement)

Agreement between two trading parties that contains information about their relative duties and rights regarding collateral.

Array of objects (SyndicatedLoanLender)

Loan offered by a group of lenders (called a syndicate).

Array
lenderId
required
string [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"

Party which provides an amount of money available to others to borrow.

lenderType
required
string (PartyType)
Example: "Person"

Possible values are: Person, Organization. Also other types of servicer internal entities: ServicerOfficer

amount
string <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Amount of the part in the syndicated loan.

share
string <= 23 characters ^100|(([1-9][0-9]{0,1})([.][0-9]{0,8}){0,1})$...
Example: "25"

Share part in the syndicated loan.

intraCompanyLoanIndicator
boolean
Example: false

Indicates whether the loan is an intra-company loan.

required
Array of objects (AccountParty)
Array
partyId
required
string (Id) [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"
partyType
required
string (PartyType)
Example: "Person"

Possible values are: Person, Organization. Also other types of servicer internal entities: ServicerOfficer

partyAccountRole
required
string (AccountPartyRole) [ 1 .. 35 ] characters
Example: "AccountOwner"

Type of the account party role. Some possibles values are: Comaker, Cosigner, AccountOwner, AccountSigner, LiquidityManager, Endorser, LimitManager, PaymentManager, Reader, BackupManager, SettlementManager, FundManagementCompany, TransferAgent, FundAccountant, Registrar, InvestmentManager, Custodian, Auditor, PayingAgent, CashCorrespondent, DataProvider, FinalAgent, Investor, FirstAgent, Intermediary, Distributor, Concentrator, UnderlyingClient1, UnderlyingClient2, TransmittingAgent, FundBroker, FinancialAdvisor, ContactPersonAtInstructingPartyInstitution, ContactPersonAtExecutingPartyInstitution, NameOfAgentToOrder, PrimeBroker, Internal, LegalGuardian, DecisionMaker, Guarantor, LoanLender, LoanBorrower, LoanCoBorrower, PrimaryOwner, Trustee, CustodianForMinor, Nominee, SecondaryOwner, Executor, Beneficiary, PrimaryServicerOfficer, SecondaryServicerOfficer, AccountOpenningOfficer, CustomerServiceOfficer.

partyName
string (PartyName) [ 1 .. 350 ] characters
Example: "Jane Birkin"

Name by which a party is known and which is usually used to identify that party.

Array of objects (RelatedAccount)
Array
accountRelationType
required
string (AccountRelationType)
Example: "Child"

Account relation role. Possible values are: Parent, Child, Group.

accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: "0dd926fe-1ca2-11ed-861d-0242ac120002"

Identification assigned by the account service institution (Servicer).

accountNumber
string (AccountNumber) <= 30 characters
Example: "012345678"

The account number or Basic Bank Account Number (BBAN). A Basic Bank Account Number (BBAN) is a bank account number that includes the domestic bank code, branch identifier, and account number. It is a unique identifier for a bank account within a specific country.

accountType
required
string (RelatedAccountType) [ 1 .. 35 ] characters
Example: "Checking"

Type of the account. Some possible ISO 20022 compliant values are: Checking, CardAccount, CashPayment, Charges, CashIncome, Commission, ClearingParticipantSettlementAccount, LimitedLiquiditySavingsAccount, MarginalLending, MoneyMarket, NonResidentExternal, Overdraft, OverNightDeposit, Settlement, Salary, Savings, Tax, TransactingAccount, CashTrading, VirtualAccount, CreditCard, DebitCard, Universal, Investment, EpurseCard, CertificateOfDeposit, MoneyMarketChecking, RetirementAccount, StockOrBond, PrePaid, FleetCard, Cash, DebitAccount, CreditAccount, Benefit, HealthSavingsAccount, FlexibleSpendingAccount, ForBenefitOf, Estate, ClientTrustAccount, LawyersTrustAccount, KeoghPlanAccount, UniformTransfersToMinorsAct, UniformGiftsToMinorsAct, ReserveFunds, SelfDirectedBrokerage, Loan, Ledger.

name
string (AccountName) [ 1 .. 70 ] characters
Example: "Hermes PD_CA 0002"

Name of the account. It provides an additional means of identification, and is designated by the account servicer in agreement with the account owner.

Array of objects (Restriction)
Array
name
required
string [ 1 .. 60 ] characters
Example: "WireTransferIn"

Name of the restriction in PascalCase. Possible values: WireTransferIn, WireTransferOut, ForeignIncomingWires, ForeignOutgoingWires, ACHTransfers, InternetBankingTransfer, InternetView, InternetInquiry, ForeignOutgoingIran, Withdrawals, Renew, Transfers

restrictionPurpose
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
enableIndicator
boolean
Example: true

Indicates whether the capability is allowed or not.

validFrom
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

validUntil
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

Array of objects (Limit)
Array
name
required
string [ 1 .. 60 ] characters
Example: "creditLimit"

Name of the limit in PascalCase. Possible values: Overdraft, CreditLimit, CreditCard, Withdraw, CreditCardWithdraw, ForeignFeesWaived, CreditTransactions, DebitTransactions

limitTypeCode
string (LimitType) <= 35 characters
Example: "DirectDebit"

Specifies the type of risk management limit. Possible ISO 20020 compliant values are: Bilateral, NetBilateral, IndirectBilateral, Global, MandatoryBilateral, DiscretionaryBilateral, DirectDebit, SingleCustomerDirectDebit, SingleFinancialInstitutionDirectDebit, TotalDailyCustomerDirectDebit, TotalDailyFinancialInstitutionDirectDebit, AutoCollateralisation, UnsecuredCredit, ExternalGuarantee

channelType
string [ 1 .. 30 ] characters

Channel type for which this limit applies. Possible values: OnlineATM, OfflineATM, ATM, SaleTerminal

amount
string <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Amount limit

number
integer

Number limit.

percentage
string (Percentage) <= 23 characters ^100|(([1-9][0-9]{0,1})([.][0-9]{0,8}){0,1})$...
Example: "25"

Value expressed as a percentage, rate expressed as a percentage, that is, in hundredths, for example, 0.7 is 7/10 of a percent, and 7.0 is 7%. total number of digits: 11 number of digits in fractional part: 10 Max Value: 100

object (Period)
object (Frequency)

Specifies an event frequency

usedAmount
string <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Amount limit used

usedNumber
integer

Number limit used.

usedPercentage
string (Percentage) <= 23 characters ^100|(([1-9][0-9]{0,1})([.][0-9]{0,8}){0,1})$...
Example: "25"

Value expressed as a percentage, rate expressed as a percentage, that is, in hundredths, for example, 0.7 is 7/10 of a percent, and 7.0 is 7%. total number of digits: 11 number of digits in fractional part: 10 Max Value: 100

status
string (LimitStatus) <= 35 characters
Example: "Requested"

Specifies the current status of a limit. Possible ISO 20020 compliant values are: Enabled, Disabled, Deleted, Requested

object (Frequency)

Specifies an event frequency

object (FinancialStatement)

Specifies financial statement details.

object (Frequency)

Specifies an event frequency

cycleType
string [ 1 .. 35 ] characters

Specifies a cycle type. Possible values: Temporal, AtMaturity, InterestCycle, FromLastStatement, LastDay.

cycle
string [ 1 .. 35 ] characters
Example: "Monthly"

Specifies a temporal cycle. Possible values: Annual, Monthly, Quarterly, SemiAnnual, Weekly, Daily, Once, IntraDay, Overnight, TenDays, Fortnightly, TriggeredByMovement, Never, Rate, OnCreditEvent, Upfront, OnExpiry, Hourly, TriAnnual, Bimonthly, OnDemand, Shift, TwiceAWeek, XDays, XMonths, XYears.

every
integer <= 999
Example: 15

Custom cycle definition. Number of XDays, XMonths, XYears.

weekDay
string <= 3
Example: "Tuesday"

Day of the week. Possible Values: Monday, Tuesday, Wednesday, Thursday, Friday.

weekNumbers
Array of strings[ items <= 3 ]
Example: ["1st"]
days
Array of integers[ items <= 31 ]
Example: [30]
startDay
string (MonthDay) ([0-9]{2})-([0-9]{2})
Example: "04-17"

A particular point in the year expressed in the MM-DD format.

communicationMethod
string (CommunicationChannelName) [ 1 .. 35 ] characters
Example: "Email"

Channel used to communicate with a party. Possible Values: Email, Fax, File, Online, PostalService, LiveSupport, ATM, IVR, Kiosk, Mobile, OnlineBanking, Phone, SMS, Card, InPerson.

format
string (DocumentFormat) [ 1 .. 35 ] characters
Example: "PDF"

Specifies a choice of format for a document. Possible Values: PDF, HTML

templateCode
string (StatementTemplateId) [ 1 .. 36 ] characters
Example: "1"

Template used to create the statement document. This is an external code provided by the account servicer.

object (Period)
fromDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period starts.

upToDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period ends.

periodNumber
integer

Sequence number of the period.

lastStatementDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

lastRegularStatementDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

accountNameIndicator
boolean

Indicates whether the account name is printed on the statement.

Array of objects (Balance)

Statement total amounts

Array
balanceName
required
string (BalanceName) [ 1 .. 17 ] characters
Example: "Available"

Specifies the nature of the balance. Possible values: Current, Available, Pending, Blocked, Previous, PendingLedger, LastAnniversary, CurrentAccrued, PreviousAccrued, CurrentWithLastCalculus, CarriedAdjustment, PaidWithPenalties, Accrued, Penalty, CollectionLedger, LastLedger, CurrentLedger, Withheld.

amount
required
string (AmountInCents) <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: -9999999999999.99999999

currency
string (CurrencyCode) = 3 characters ^([A-Z]{3})?$
Example: "USD"

Three contiguous letters for the representation of currencies and funds. Valid currency codes are registered with the ISO 4217 Maintenance Agency.

calculationDate
string <date-time>
Example: "2022-04-17T08:00:00Z"

Specifies the date and time at which the balance is calculated.

preferredLanguage
string (PreferredLanguage) [ 1 .. 35 ] characters
Example: "English"

Language of the contact person. Names according to the language list provided in the ISO 639-1 codes. Some possible values: Chinese, Spanish, French, English, Japanese, Italian, German.

combineType
string [ 1 .. 36 ] characters
Example: "SavingsSatement"

Indicates whether account transactions are printed on a combined statement. Possible combinations: CheckingStatement, SavingsSatement.

category
string (StatementCategory) [ 1 .. 36 ] characters
Example: "BalanceSheet"

Used to categorize the statement. Possible Values: BalanceSheet, ProfitAndLoss

subcategory
string (StatementSubcategory) [ 1 .. 36 ] characters
Example: "Cash"

Used to subcategorize the statement. Possible Values: Cash, AccountReceivable, Inventory, CurrentAssets

profitabilityModelId
string (StatementModelId) [ 1 .. 36 ] characters
Example: "1"

Model used to calculate customer profitability. This is an external id provided by the account servicer.

lastIRAStatementDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

supplementaryData
object (SupplementaryData)

Additional information that cannot be captured in the structured elements and/or any other specific block. If this information need to be converted in ISO Messages, must be ISO 20022 compliant: it requires development of a compliant message extension model and its components must be registered in the ISO 20022 Data Dictionary. https://www.iso20022.org/catalogue-messages/additional-content-messages/supplementary-data

status
string (LoanStatus) [ 1 .. 17 ] characters
Example: "Withdrawn"

Specifies the current state of an account. Possible values names are: Pending, Form, Denied, Review, Approve, Withdrawn, Disable, Funded, Deleted

statusDateAndTime
string <date-time> (DateAndTime)
Example: "2022-04-17T08:00:00Z"
substatus
string [ 1 .. 35 ] characters

Status defined by the loan servicer.

openDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

fundedDate
string <date>
Example: "2022-04-17"

Date on which the loan was funded or closed

disbursalDate
string <date>
Example: "2022-04-17"

Date on which loan amount is disbursed.

Array of objects (Balance)
Array
balanceName
required
string (BalanceName) [ 1 .. 17 ] characters
Example: "Available"

Specifies the nature of the balance. Possible values: Current, Available, Pending, Blocked, Previous, PendingLedger, LastAnniversary, CurrentAccrued, PreviousAccrued, CurrentWithLastCalculus, CarriedAdjustment, PaidWithPenalties, Accrued, Penalty, CollectionLedger, LastLedger, CurrentLedger, Withheld.

amount
required
string (AmountInCents) <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: -9999999999999.99999999

currency
string (CurrencyCode) = 3 characters ^([A-Z]{3})?$
Example: "USD"

Three contiguous letters for the representation of currencies and funds. Valid currency codes are registered with the ISO 4217 Maintenance Agency.

calculationDate
string <date-time>
Example: "2022-04-17T08:00:00Z"

Specifies the date and time at which the balance is calculated.

Array of objects (TransactionGroup)
Array
domain
string (BankTransactionDomain) [ 1 .. 35 ] characters
Example: "Payments"

Specifies the bank transaction code domain. Some possible ISO 20022 compliant values are: Payments, AccountManagement.

family
string (BankTransactionFamily) [ 1 .. 60 ] characters
Example: "CustomerCardTransactions"

Specifies the bank transaction family. Some possible ISO 20022 compliant values are: For Payments domain: CustomerCardTransactions, MerchantCardTransactions.

subFamily
string (BankTransactionSubfamily) [ 1 .. 60 ] characters
Example: "CreditCardPayment"

Specifies the bank transaction subfamily. Some possible ISO 20022 compliant values are: For CustomerCardTransactions family: CashDeposit, CashWithdrawal, SmartCardPayment, PointOfSalePaymentDebitCard, CreditCardPayment, CrossBorderCreditCardPayment, CrossBorderCashWithdrawal

Array of objects (GenericTransactionCode)

Additional transaction codes.

status
string (TransactionStatus) [ 1 .. 35 ] characters
Example: "Booked"

Specifies the status of an entry on the books of the account servicer. Some possible ISO 20022 compliant values are: Booked, Future, Information, Pending.

number
integer

Number of individual transactions.

amount
string <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Total of the transaction amounts.

object

Temporal duration by which the transactions are grouped

accountId
string (AccountId) [ 1 .. 36 ] characters
Example: "0dd926fe-1ca2-11ed-861d-0242ac120002"

Identification assigned by the account service institution (Servicer).

Array of objects (RelatedCard)

Payment cards related to the account. Debit cards, for loans or current accounts. Credit cards, for credit card accounts.

Array
cardId
required
string (Id) [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"
cardHolderName
required
string (PartyName) [ 1 .. 350 ] characters
Example: "Jane Birkin"

Name by which a party is known and which is usually used to identify that party.

cardHolderType
required
string (CardHolderType) [ 1 .. 35 ] characters
Example: "Primary"

Specifies the card holder type of payment card. Possible Values: Primary, Additional

principalAmount
string <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Amount of money borrowed, or part of that amount which remains unpaid (excluding interest).

accruedCapitalisationAmount
string <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Amount of unpaid interest (on bonds which have defaulted and have subsequently restructured), which is capitalized and added to the original principal amount of the bond.

object (RepaymentSchedule)

An amount that must be paid no sooner than the expected payment date and no later than the due date.

repaymentScheduleId
string [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"

Unique and unambiguous identification of the payment schedule.

amount
string <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Amount to be paid

expectedDate
string <date>
Example: "2022-04-17"

Expected date whereby the amount must be paid.

dueDate
string <date>
Example: "2022-04-17"

Latest date whereby the amount of money must be paid.

repaymentType
string (LoanPaymentType) [ 1 .. 35 ] characters
Example: "Principal"

Possible values are: Interest, Principal.

object (CreditTransferDetail)

Further details on the credit transfer instruction

paymentMethod
required
string (PaymentMethod) [ 1 .. 35 ] characters
Example: "CreditTransfer"

Specifies the means of payment that will be used to move the amount of money. Possible ISO 20022 compliant values are: Check, CreditTransfer

paymentType
required
string (PaymentType) [ 1 .. 35 ] characters
Example: "On-Us"

Specifies the type of Payment. Possible values: LiquidityTransfer, On-Us, ACH, Wire

creditorAccountId
string (AccountId) [ 1 .. 36 ] characters
Example: "0dd926fe-1ca2-11ed-861d-0242ac120002"

Identification assigned by the account service institution (Servicer).

object (PaymentIdentifiers)

Set of elements used to reference a payment instruction.

object (PaymentProcessingDetail)

Provides further details of the type of payment.

chargeBearerType
string (ChargeBearerType) [ 1 .. 35 ] characters
Example: "Shared"

Specifies which party(ies) will pay charges due for processing of the instruction. BorneByDebtor, BorneByCreditor, Shared, FollowingServiceLevel

object (PartyIdentification)
object (Repayment)

An amount that must be paid no sooner than the expected payment date and no later than the due date.

repaymentScheduleId
string [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"

Unique and unambiguous identification of the payment schedule.

amount
string <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Amount to be paid

expectedDate
string <date>
Example: "2022-04-17"

Expected date whereby the amount must be paid.

dueDate
string <date>
Example: "2022-04-17"

Latest date whereby the amount of money must be paid.

repaymentType
string (LoanPaymentType) [ 1 .. 35 ] characters
Example: "Principal"

Possible values are: Interest, Principal.

object (CreditTransferDetail)

Further details on the credit transfer instruction

paymentMethod
required
string (PaymentMethod) [ 1 .. 35 ] characters
Example: "CreditTransfer"

Specifies the means of payment that will be used to move the amount of money. Possible ISO 20022 compliant values are: Check, CreditTransfer

paymentType
required
string (PaymentType) [ 1 .. 35 ] characters
Example: "On-Us"

Specifies the type of Payment. Possible values: LiquidityTransfer, On-Us, ACH, Wire

creditorAccountId
string (AccountId) [ 1 .. 36 ] characters
Example: "0dd926fe-1ca2-11ed-861d-0242ac120002"

Identification assigned by the account service institution (Servicer).

object (PaymentIdentifiers)

Set of elements used to reference a payment instruction.

object (PaymentProcessingDetail)

Provides further details of the type of payment.

chargeBearerType
string (ChargeBearerType) [ 1 .. 35 ] characters
Example: "Shared"

Specifies which party(ies) will pay charges due for processing of the instruction. BorneByDebtor, BorneByCreditor, Shared, FollowingServiceLevel

object (PartyIdentification)
paymentDate
string <date>
Example: "2022-04-17"

Payment date

Responses

Request samples

Content type
application/merge-patch+json
{
  • "compositeId": {
    },
  • "accountBranchId": "SEA_1",
  • "accountNumber": "012345678",
  • "routingNumbers": [
    ],
  • "identifiers": [
    ],
  • "loanBranchId": "SEA_1",
  • "loanType": "Personal",
  • "ownershipType": "SingleOwnerAccount",
  • "productId": "PD_CA_0002",
  • "name": "Hermes PD_CA 0002",
  • "accountPurpose": "This is a description.",
  • "currency": "USD",
  • "contract": {
    },
  • "parties": [
    ],
  • "relatedAccounts": [
    ],
  • "restrictions": [
    ],
  • "limits": [
    ],
  • "statement": {
    },
  • "supplementaryData": { },
  • "status": "Withdrawn",
  • "statusDateAndTime": "2022-04-17T08:00:00Z",
  • "substatus": "string",
  • "openDate": "2022-04-17",
  • "fundedDate": "2022-04-17",
  • "disbursalDate": "2022-04-17",
  • "balances": [
    ],
  • "transactionGroups": [
    ],
  • "accountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "relatedCards": [
    ],
  • "principalAmount": "100",
  • "accruedCapitalisationAmount": "100",
  • "nextPayment": {
    },
  • "lastPayment": {
    }
}

Response samples

Content type
application/json
{
  • "compositeId": {
    },
  • "accountBranchId": "SEA_1",
  • "accountNumber": "012345678",
  • "routingNumbers": [
    ],
  • "identifiers": [
    ],
  • "loanBranchId": "SEA_1",
  • "loanType": "Personal",
  • "ownershipType": "SingleOwnerAccount",
  • "productId": "PD_CA_0002",
  • "name": "Hermes PD_CA 0002",
  • "accountPurpose": "This is a description.",
  • "currency": "USD",
  • "contract": {
    },
  • "parties": [
    ],
  • "relatedAccounts": [
    ],
  • "restrictions": [
    ],
  • "limits": [
    ],
  • "statement": {
    },
  • "supplementaryData": { },
  • "status": "Withdrawn",
  • "statusDateAndTime": "2022-04-17T08:00:00Z",
  • "substatus": "string",
  • "openDate": "2022-04-17",
  • "fundedDate": "2022-04-17",
  • "disbursalDate": "2022-04-17",
  • "balances": [
    ],
  • "transactionGroups": [
    ],
  • "accountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "relatedCards": [
    ],
  • "principalAmount": "100",
  • "accruedCapitalisationAmount": "100",
  • "nextPayment": {
    },
  • "lastPayment": {
    }
}

Retrieves Loan Balances

Authorizations:
jwtopenIdConnect
path Parameters
loanId
required
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Loan Identification

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Responses

Response samples

Content type
application/json
{
  • "loanId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "accountNumber": "012345678",
  • "balances": [
    ]
}

Retrieves Loan Transactions

Authorizations:
jwtopenIdConnect
path Parameters
loanId
required
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Loan Identification

query Parameters
transactionId.eq
string (TransactionId) [ 1 .. 36 ] characters
Example: transactionId.eq=0dd926fe-1ca2-11ed-861d-0242ac120002

Unique reference as assigned by the account servicing institution to unambiguously identify the transaction.

amount.lte
string (AmountInCents) <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: amount.lte=100

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: -9999999999999.99999999

amount.gte
string (AmountInCents) <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: amount.gte=100

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: -9999999999999.99999999

creationDate.lte
string <date> (Date)
Example: creationDate.lte=2022-04-17

Creation date less than or equal

creationDate.gte
string <date> (Date)
Example: creationDate.gte=2022-04-17

Creation date greater than or equal

cursor
string

Specifies an opaque string value ( "no meaning" string value) at which start retrieving transactions. For instance, limit=5&cursor=62aef884fbe3470ce7d9a92140b09b17

limit
string

Specifies the number of resources to return in one request, specified as an integer from 1 to 100.

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Pagination-Cursor
required
string

Pagination Cursor

Pagination-Total
required
string

Total number of resources.

Responses

Response samples

Content type
application/json
{
  • "loanId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "accountNumber": "012345678",
  • "loanType": "Personal",
  • "currency": "USD",
  • "currentBalance": "100",
  • "availableBalance": "100",
  • "transactions": [
    ]
}

Retrieves Loan Identifiers

Authorizations:
jwtopenIdConnect
path Parameters
loanId
required
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Loan Identification

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Responses

Response samples

Content type
application/json
{
  • "compositeId": {
    },
  • "accountBranchId": "SEA_1",
  • "accountNumber": "012345678",
  • "routingNumbers": [
    ],
  • "identifiers": [
    ],
  • "loanId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "loanType": "Personal"
}

Retrieves Loan Parties

Authorizations:
jwtopenIdConnect
path Parameters
loanId
required
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Loan Identification

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Responses

Response samples

Content type
application/json
{
  • "loanId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "accountNumber": "012345678",
  • "parties": [
    ]
}

Retrieves Loan Owners

Authorizations:
jwtopenIdConnect
path Parameters
loanId
required
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Loan Identification

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Responses

Response samples

Content type
application/json
{
  • "accountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "accountNumber": "012345678",
  • "accountType": "Checking",
  • "ownershipType": "SingleOwnerAccount",
  • "owners": [
    ]
}

Retrieves Loan Cards

Authorizations:
jwtopenIdConnect
path Parameters
loanId
required
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Loan Identification

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Responses

Response samples

Content type
application/json
{
  • "loanId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "accountNumber": "012345678",
  • "cards": [
    ]
}

Relationships

Retrieves a list of relationships matching the parameters.

Authorizations:
jwtopenIdConnect
query Parameters
customer.name.inc
string

The primary customer name includes the substring provided.

customer.lastName.eq
string (PartyName) [ 1 .. 350 ] characters
Example: customer.lastName.eq=Jane Birkin

Name by which a party is known and which is usually used to identify that party.

customer.firstName.eq
string (PartyName) [ 1 .. 350 ] characters
Example: customer.firstName.eq=Jane Birkin

Name by which a party is known and which is usually used to identify that party.

customer.birthDate.eq
string <date> (Date)
Example: customer.birthDate.eq=2022-04-17

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

customer.phoneNumber.eq
string (PhoneNumber) ^\+[0-9]{1,3}-[0-9()+\-]{1,30}$
Example: customer.phoneNumber.eq=+1-415-731359

Any phone number equals to.

customer.accountNumber.eq
string (AccountNumber) <= 30 characters
Example: customer.accountNumber.eq=012345678

The account number or Basic Bank Account Number (BBAN). A Basic Bank Account Number (BBAN) is a bank account number that includes the domestic bank code, branch identifier, and account number. It is a unique identifier for a bank account within a specific country.

customer.tin.eq
string
customer.ssn.eq
string

Social Security Number

customer.ssn.last4
string

Social Security Number last four digits.

customer.email.eq
string

Email equals to

customer.addressLine.inc
string

Any address line of any postal address includes substring

customer.postCode.eq
string

Any postal address with post code equals to

customer.country.eq
string

Any postal address with Country code equals to

customer.countrySubDivision.inc
string

Any postal address with country subdivision includes substring

customer.townName.inc
string

Any postal address with town name includes substring

customer.personId.eq
string (Id) [ 1 .. 36 ] characters
Example: customer.personId.eq=5fb9d4d6-1a3c-11ed-861d-0242ac120002

System id equals to

customer.audit.lastModificationDate.lte
string <date> (Date)
Example: customer.audit.lastModificationDate.lte=2022-04-17

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

customer.audit.lastModificationDate.gte
string <date> (Date)
Example: customer.audit.lastModificationDate.gte=2022-04-17

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Creates a Relationship

Authorizations:
jwtopenIdConnect
header Parameters
idempotencyId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Idempotency identifier used by the client when making repeated calls

servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Request Body schema: application/json
object (CustomerRelationshipParty)

Person tied to the relationship.

object (Person)

Human entity, as distinguished from a corporate entity.

uSDocumentedIndicator
boolean
Array of objects (PersonIdentification)
name
string (PartyName) [ 1 .. 350 ] characters
Example: "Jane Birkin"

Name by which a party is known and which is usually used to identify that party.

shortName
string (PartyShortName) [ 1 .. 35 ] characters
Example: "Jane"

Short name or nickname by which a party is known and which is usually used to identify that party.

nameTemplateId
string (NameTemplateId) [ 1 .. 36 ] characters
Example: "1"

Template used to display the party name. This is an external id provided by the account servicer.

nameSoundExId
string (SoundExId) [ 1 .. 36 ] characters
Example: "1"

Identification of a SoundEx method develop for search attribute. SoundEx is a method used to find strings when the sound is known but the precise spelling is not. It searches out words with similar sounds based on phonetic assumptions about how certain letters are pronounced. It can be used to search names in a database, for example, where spellings and pronunciations for similar names may vary.

partyBranchId
string (ServicerBranchId) [ 1 .. 36 ] characters
Example: "SEA_1"

Identification of the account servicer institution at branch level or operation level.

comment
string [ 1 .. 1025 ] characters
Example: "This is a description."

Bank commnent of the party.

Array of objects (RelatedParty)
Array of objects (PostalAddress)
relationshipId
string [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"

This id gives the ability to view a party’s total relationship with the bank. The relationship Id ties multiple parties together. This code is also used to reduce mailing costs during marketing campaigns to avoid sending duplicate materials to parties residing at the same address.

relationshipLeadIndicator
boolean

The relationship lead is often the primary account owner or the party with whom the bank have the most contact.

residenceType
string [ 1 .. 35 ] characters
Example: "Domestic"

Specifies the type of residence where the party has its permanent home or principal establishment. Possible ISO Complaian values are: Domestic, Foreign, Mixed

object (TaxPartyInformation)

Taxation parameters which apply to an individual person or to an organization.

object (PowerOfAttorney)

Document that transfers specific rights from a party to a person.

supplementaryData
object (SupplementaryData)

Additional information that cannot be captured in the structured elements and/or any other specific block. If this information need to be converted in ISO Messages, must be ISO 20022 compliant: it requires development of a compliant message extension model and its components must be registered in the ISO 20022 Data Dictionary. https://www.iso20022.org/catalogue-messages/additional-content-messages/supplementary-data

excludeMarketingIndicator
boolean
object (Audit)

Resource Audit Information. Captures the creation, modification and maintenance details.

Array of objects (Restriction)

Access and operation restrictions at Party level.

object (PlaceAndDateOfBirth)

Date and place of birth of a person.

signature
string <byte> (DigitalSignature) [ 1 .. 13654 ] characters
Example: {"0":83,"1":109,"2":70,"3":117,"4":90,"5":83,"6":66,"7":67,"8":97,"9":88,"10":74,"11":114,"12":97,"13":87,"14":52,"15":61}

Binary data of 10K maximum, base64 encoded.

signatureVerificationId
string (SignatureVerificationId) [ 1 .. 36 ] characters
Example: "0dd926fe-1ca2-11ed-861d-0242ac120002"

This field contains the key of the CISA validation record.

object (PersonContactDetails)

Specifies the contact details of a person.

headOfHousehold
boolean
Example: true

Indicates whether the person pay the costs of supporting a house.

civilStatus
string (CivilStatus) [ 1 .. 17 ] characters
Example: "Single"

Specifies the civil status of a person. Possible ISO 20022 compliant values names are: Single, Married, LegallyDivorced, Divorced, Widowed, StableUnion

object (StructuredName)

The structured name is used to initialize the person name with the format

gender
string (Gender) [ 1 .. 36 ] characters
Example: "Female"

Specifies the gender of the person. Possible Values: Female, Male, NonBinary

race
string (Race) [ 1 .. 35 ] characters
Example: "Director"

Categorization of humans based on shared physical qualities. Possible Values: NativeAmerican, African, Hispanic, White, Asian

profession
string (Profession) <= 35 characters
Example: "Artist"

Professional Designation or name of the occupation of a person.

jobTitle
string (JobTitle) [ 1 .. 35 ] characters
Example: "Head of Documentation"

Title of the function in an organization.

residentialStatus
string (ResidentialStatus) [ 1 .. 35 ] characters
Example: "Permanent"

Residential status of an individual. Possible values: Permanent, Resident, NonResident, Rents, Owns

minorIndicator
boolean (MinorIndicator)

Indicates whether the person is a legal minor.

Array of objects (Citizenship)
countryOfResidence
string (CountryCode) ^([A-Z]{2,2})?$
Example: "US"

Country name obtained from the United Nations (ISO 3166, Alpha-2 code).

object (PersonProfile)

Information to support Know Your Customer (KYC) processes.

personId
required
string [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"

Person identifier code assigned by the account service institution.

status
string (InstructionStatus) [ 1 .. 35 ] characters
Example: "Queued"

Details about the processing of a request on party reference data (create, update, delete). Possible ISO compliant values are: Rejected, Completed, Queued.

partyRelationType
required
string (PersonRelationType) [ 1 .. 40 ] characters
Example: "PrimaryCustomer"

Role of a person in a customer bank relationship. Possible values: PrimaryCustomer, SecondaryOwner, Beneficiary, CustomerServiceOfficer, PrimaryServicerOfficer, SecondaryServicerOfficer, SalesPerson, ReferralOfficer.

partyRelationDescription
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
object (Organization)

Organized structure that is set up for a particular purpose. For example, a business, government body, department, charity, or financial institution.

Array of objects (OrganizationIdentification)
Array
number
required
string [ 1 .. 35 ] characters
Example: "123-45-6789"

Unique and unambiguous identification of an organization.

schemeName
required
string [ 1 .. 35 ] characters
Example: "TaxIdentificationNumber"

Name of the identification scheme, in PascalCase form. Possible ISO compliant values are: BankPartyIdentification CentralBankIdentificationNumber ClearingIdentificationNumber CertificateOfIncorporationNumber CountryIdentificationCode CustomerNumber DataUniversalNumberingSystem EmployerIdentificationNumber GS1GLNIdentifier SIREN SIRET TaxIdentificationNumber BusinessDomainIdentifier BusinessOtherIdentification EmployerIdentificationNumber BICIdentifier LEIIdentifier

issuer
string
Example: "UnitedStates"

Entity that assigns the identification.

issueDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

expirationDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

name
string (PartyName) [ 1 .. 350 ] characters
Example: "Jane Birkin"

Name by which a party is known and which is usually used to identify that party.

shortName
string (PartyShortName) [ 1 .. 35 ] characters
Example: "Jane"

Short name or nickname by which a party is known and which is usually used to identify that party.

nameTemplateId
string (NameTemplateId) [ 1 .. 36 ] characters
Example: "1"

Template used to display the party name. This is an external id provided by the account servicer.

nameSoundExId
string (SoundExId) [ 1 .. 36 ] characters
Example: "1"

Identification of a SoundEx method develop for search attribute. SoundEx is a method used to find strings when the sound is known but the precise spelling is not. It searches out words with similar sounds based on phonetic assumptions about how certain letters are pronounced. It can be used to search names in a database, for example, where spellings and pronunciations for similar names may vary.

partyBranchId
string (ServicerBranchId) [ 1 .. 36 ] characters
Example: "SEA_1"

Identification of the account servicer institution at branch level or operation level.

comment
string [ 1 .. 1025 ] characters
Example: "This is a description."

Bank commnent of the party.

Array of objects (RelatedParty)
Array
partyId
required
string (Id) [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"
partyType
required
string (PartyType)
Example: "Person"

Possible values are: Person, Organization. Also other types of servicer internal entities: ServicerOfficer

partyName
string (PartyName) [ 1 .. 350 ] characters
Example: "Jane Birkin"

Name by which a party is known and which is usually used to identify that party.

partyRelationType
required
string (PartyRelationType) [ 1 .. 40 ] characters
Example: "PrimaryServicerOfficer"

Type of relation between parties. Possible values Between Organizations and persons are: ResponsibleParty, OrganizationOwner, ControlPerson, BeneficialOwner, PrimaryContact, SecondaryContact. For Trusts: Trustor, Trustee. Between organizations: ParentOrganization, Branch. Between parties and external entities: AccountOpenningOfficer, CustomerServiceOfficer, PrimaryServicerOfficer, SecondaryServicerOfficer, SalesPerson, ReferralOfficer. Between financial institutions: AffiliateFinancialInstitution, HoldingCompany. Between persons: Spouse.

partyRelationDescription
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
ownershipPercentage
string <= 23 characters ^100|(([1-9][0-9]{0,1})([.][0-9]{0,8}){0,1})$...
Example: "25"

Company Ownership Percentage. If the relation Type is BeneficialOwner the ownership percentage could be added. Ownership means any person with more than 25% equity in the legal entity.

Array of objects (PostalAddress)
Array
addressType
string
Example: "Postal"

Specifies the type of address, in PascalCase form. Possible ISO Compliant values are: PhysicalAddress, Postal, POBox, Residential, Permanent, Temporary, Business.

addressPurpose
string
Example: "Billing"

Specifies the purpose of an address, in PascalCase form. Possible ISO Compliant values are: MailTo, DeliveryTo, Billing, PlaceOfOperation, PlaceOfRegistration

primaryIndicator
boolean (PrimaryContactIndicator)

Indicates whether the contact informacion is primary.

department
string [ 1 .. 70 ] characters
Example: "A"

Identification of a division of a large Organization or building.

subDepartment
string [ 1 .. 70 ] characters
Example: "B"

Identification of a sub-division of a large Organization or building.

streetName
string [ 1 .. 70 ] characters
Example: "First Street"

Name of a street or thoroughfare.

firstCrossStreetName
string [ 1 .. 70 ] characters

Name of a the first cross street.

secondCrossStreetName
string [ 1 .. 70 ] characters
Example: "Second Street"

Name of a the second cross street.

buildingNumber
string [ 1 .. 16 ] characters
Example: "11407"

Number that identifies the position of a building or house on a street.

buildingName
string [ 1 .. 35 ] characters
Example: "Tall Tower"

Name of the building or house.

floor
string [ 1 .. 70 ] characters
Example: "20"

Floor or storey within a building.

postBox
string [ 1 .. 16 ] characters
Example: "MY779"

Numbered box in a post office, assigned to a person or Organization, where letters are kept until called for.

room
string [ 1 .. 70 ] characters
Example: "22"

Building room number.

postCode
string (PostCode) [ 1 .. 16 ] characters
Example: "97062-68"

Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.

censusTrack
string (CensusTrack) = 5 characters
Example: "04013216813"

A census tract, census area, census district or meshblock is a geographic region defined for the purpose of taking a census

cBSACode
string (CBSACode) = 5 characters
Example: "49780"

Core-based statistical area. Metropolitan statistical area (MSA) is the formal definition of a region that consists of a city and surrounding communities that are linked by social and economic factors. Micropolitan Statistical Areas (MISA) are CBSAs associated with at least one urban cluster that has a population of at least 10,000, but less than 50,000. The micropolitan statistical area comprises the central county or counties or equivalent entities containing the core, plus adjacent outlying counties having a high degree of social and economic integration with the central county as measured through commuting.

cBSAType
string (CBSAType) [ 1 .. 10 ] characters
Example: "MSA"

Type of Core-based statistical area. Possible values: MSA, MISA

foreignIndicator
boolean

Indicates whether the postal address is from a foreing country.

townName
string (TownName) [ 1 .. 35 ] characters
Example: "Tualatin"

Name of a built-up area, with defined boundaries, and a local government.

townLocationName
string [ 1 .. 35 ] characters
Example: "Clackamas"

Specific location name within the town.

districtName
string [ 1 .. 35 ] characters
Example: "Washington"

Identifies a subdivision within a country sub-division.

countrySubDivision
string (CountrySubdivision) [ 1 .. 35 ] characters
Example: "Oregon"

Name of a country subdivision such as state, region, county.

countrySubDivisionCode
string (CountrySubdivisionCode) ^[A-Z]{2,2}\-[0-9A-Z]{1,3}
Example: "AR-B"

Code to identify a name of a unit resulting from the division of a country, dependency, or other area of special geopolitical interest contained in ISO 3166-1, on the basis of country names obtained from the United Nations (ISO 3166-2: Country subdivision code).

country
string (CountryCode) ^([A-Z]{2,2})?$
Example: "US"

Country name obtained from the United Nations (ISO 3166, Alpha-2 code).

addressLine
Array of strings[ items [ 1 .. 70 ] characters ]
Example: ["11407 Sw Amu st, Suite MY777"]

Information that locates and identifies a specific address, as defined by postal services, presented in free format text.

object

The period of use of the address information.

relationshipId
string [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"

This id gives the ability to view a party’s total relationship with the bank. The relationship Id ties multiple parties together. This code is also used to reduce mailing costs during marketing campaigns to avoid sending duplicate materials to parties residing at the same address.

relationshipLeadIndicator
boolean

The relationship lead is often the primary account owner or the party with whom the bank have the most contact.

residenceType
string [ 1 .. 35 ] characters
Example: "Domestic"

Specifies the type of residence where the party has its permanent home or principal establishment. Possible ISO Complaian values are: Domestic, Foreign, Mixed

object (TaxPartyInformation)

Taxation parameters which apply to an individual person or to an organization.

tIN
string
Example: "778-62-8144"

A Taxpayer Identification Number

taxIdType
string [ 1 .. 50 ] characters
Example: "SocialSecurityNumber"

Identifies what type of tax ID is in the TIN field. Possible Values: SocialSecurityNumber, EmployerIdentificationNumber, IndividualTaxpayerIdentificationNumber, AdoptionTaxpayerIdentificationNumber, PreparerTaxpayerIdentificationNumber, ForeignTaxID

financialReportingIndicator
boolean

Whether the financial income for this party should be reported to the U.S. government (IRS) when related to an account in a way which requires reporting (for example, primary, joint ownership). Defaults to true if not specified.

tINStatus
string
Example: "Valid"

'The tax ID has been verified by the IRS. Possible values: Valid, NotValid, NotVerified, IRSWarning, TINApplied.

object (TINVerification)

IRS information about the TIN provided.

taxStatus
string
Example: "Valid"

Exempt, Retain, ExemptExpired, VoluntaryWithholding, Chapter3, Chapter4, C-Corp, S-Corp.

Array of objects (TaxForm)

Forms applied by the party

Array of objects (TaxRegulation)
Array of objects (WithholdingTax)
foreignIndicator
boolean

Indicates whether the party is a non-residen alien or a foreign entity.

countrySubDivision
string (CountrySubdivision) [ 1 .. 35 ] characters
Example: "Oregon"

Name of a country subdivision such as state, region, county.

countrySubDivisionCode
string (CountrySubdivisionCode) ^[A-Z]{2,2}\-[0-9A-Z]{1,3}
Example: "AR-B"

Code to identify a name of a unit resulting from the division of a country, dependency, or other area of special geopolitical interest contained in ISO 3166-1, on the basis of country names obtained from the United Nations (ISO 3166-2: Country subdivision code).

country
string (CountryCode) ^([A-Z]{2,2})?$
Example: "US"

Country name obtained from the United Nations (ISO 3166, Alpha-2 code).

supplementaryData
object (SupplementaryData)

Additional information that cannot be captured in the structured elements and/or any other specific block. If this information need to be converted in ISO Messages, must be ISO 20022 compliant: it requires development of a compliant message extension model and its components must be registered in the ISO 20022 Data Dictionary. https://www.iso20022.org/catalogue-messages/additional-content-messages/supplementary-data

object (PowerOfAttorney)

Document that transfers specific rights from a party to a person.

documentId
string (Id) [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"
documentReference
string [ 1 .. 35 ] characters

Document location.

version
string [ 1 .. 18 ] characters

Document version indentification.

signOffDate
string <date>
Example: "2022-04-17"

Signoff date of the document.

issueDate
string <date>
Example: "2022-04-17"

Issue date of the document.

purpose
string [ 1 .. 35 ] characters

Specifies the function of the document.

fromDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period starts.

upToDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period ends.

periodNumber
integer

Sequence number of the period.

object (Jurisdiction)

Area with a set of laws under the control of a system which are different from neighbouring areas

authorizedPerson
string [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"

Person which is the holder of the power of attorney.

authorizedAccount
string [ 1 .. 36 ] characters
Example: "0dd926fe-1ca2-11ed-861d-0242ac120002"

Specifies the account on which the power of attorney applies.

supplementaryData
object (SupplementaryData)

Additional information that cannot be captured in the structured elements and/or any other specific block. If this information need to be converted in ISO Messages, must be ISO 20022 compliant: it requires development of a compliant message extension model and its components must be registered in the ISO 20022 Data Dictionary. https://www.iso20022.org/catalogue-messages/additional-content-messages/supplementary-data

excludeMarketingIndicator
boolean
object (Audit)

Resource Audit Information. Captures the creation, modification and maintenance details.

status
string (AuditStatus) [ 1 .. 35 ] characters

Maintenance status of a resource. Possible values: Requested, Created, Changed, Deleted

creationDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

lastModificacionChannel
string (CommunicationChannelName) [ 1 .. 35 ] characters
Example: "Email"

Channel used to communicate with a party. Possible Values: Email, Fax, File, Online, PostalService, LiveSupport, ATM, IVR, Kiosk, Mobile, OnlineBanking, Phone, SMS, Card, InPerson.

lastModificationDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

Array of objects (AuditChannel)

Activity audit throught comunication channles

Array of objects (Restriction)

Access and operation restrictions at Party level.

Array
name
required
string [ 1 .. 60 ] characters
Example: "WireTransferIn"

Name of the restriction in PascalCase. Possible values: WireTransferIn, WireTransferOut, ForeignIncomingWires, ForeignOutgoingWires, ACHTransfers, InternetBankingTransfer, InternetView, InternetInquiry, ForeignOutgoingIran, Withdrawals, Renew, Transfers

restrictionPurpose
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
enableIndicator
boolean
Example: true

Indicates whether the capability is allowed or not.

validFrom
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

validUntil
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

organizationType
required
string (OrganizationType)
Example: "Corporation"

Specifies the legal standing of the organization. Possible values are: Government, FinancialInstitution SoleProprietorship, UnincorporatedAssociation, LimitedLiabilityPartnership, LimitedLiabilityCompany, LimitedPartnership, FormalPartnership, GeneralPartnership, Business, Corporation, NotForProfit, ForProfit, NonProfit, Club, Supranational, Sovereign, Municipal, Province, State, County, National, ExemptionTrust, LivingTrust, EmployeeTrust, RevocableTrust, IrrovocableTrust, NakedTrust, FamilyTrust, BussinesTrust, CliffordTrust, FormalTrust.

organizationPurpose
string [ 1 .. 1025 ] characters
Example: "This is a description."

Description and purpose of an organization.

legalName
string [ 1 .. 35 ] characters
Example: "Jane"

Official name under which an organization is registered.

tradingName
string [ 1 .. 35 ] characters
Example: "Jane"

Name used by a business for commercial purposes, although its registered legal name, used for contracts and other formal situations, may be another.

registrationDate
string <date>
Example: "2022-04-17"

Date and time at which a given organization was officially registered.

establishmentDate
string <date>
Example: "2022-04-17"

Date when the Organization was established.

merchantCategory
string (MerchantCategoryCode) ^[0-9]{4,4}
Example: "482"

Category code conform to ISO 18245, related to the type of services or goods the merchant provides for the transaction.

nAICSCode
string (NAICSCode) ^[0-9]{2,2}
Example: "54"

The North American Industry Classification System (NAICS) is the standard used by Federal statistical agencies in classifying business establishments for the purpose of collecting, analyzing, and publishing statistical data related to the U.S. business economy.

sector
string (OrganizationSector)

A sector is an area of the economy in which businesses share the same or related business activity, product, or service. Energy, Materials, Industrials, ConsumerDiscretionary, ConsumerStaples, HealthCare, Financials, InformationTechnology, TelecommunicationServices, Utilities, RealEstate.

object (OrganizationProfile)

Information to support Know Your Customer (KYC) processes.

riskLevel
string (RiskLevel) [ 1 .. 35 ] characters
Example: "Permanent"

Specifies the customer’s money laundering risk. Possible values: High, Medium, Low, None.

bSARiskCode
integer (BSARiskCode) <= 10
Example: 0

Used to identify customers that present a risk to the bank as defined by the Bank Secrecy Act. For example, use this code to identify and monitor accounts suspected of fraud, kiting or money laundering.

object (CreditReview)

A credit review is a periodic assessment of an individual’s or businesses' credit profile.

creditBureauReportCode
string

Code used for reporting to the credit bureaus. This code is used to report the trade line of a credit account to the credit bureau agencies.

oFACReportingIndicator
boolean

Indicates whether the party is to be excluded from OFAC Reporting.

previousFinancialInstitution
string (PartyName) [ 1 .. 350 ] characters
Example: "Jane Birkin"

Name by which a party is known and which is usually used to identify that party.

referredByWhom
string (PartyName) [ 1 .. 350 ] characters
Example: "Jane Birkin"

Name by which a party is known and which is usually used to identify that party.

moneyLaunderingCheck
string (MoneyLaunderingCheck)
Example: "AuthorizedCredit"

Specifies the status of money laundering identification procedures. Possible Values: PassedNotChecked, ExemptBelowLimit, ClientMoneyTypeExempt, AuthorizedCredit, PostalOrElectronicPaymentExempt

knowYourCustomerCheck
string (KnowYourCustomerCheckType) [ 1 .. 36 ] characters
Example: "Ordinary"

Specifies the type of Know Your Customer (KYC) or anti-money laundering due diligence to which the investor has been subjected. Possible Values: Ordinary, Simple, Enhanced.

object (TemporalDuration)

Describes a temporal duration.

dateAtCurrentAddress
string <date>
Example: "2022-04-17"

Date of Residence in the current household.

sourceOfWealth
string [ 1 .. 1025 ] characters
Example: "This is a description."

Indicates the main sources of the money.

politicalAffiliation
string

Indicates the political affiliation of the Party. Possible values could be: Democrat, Independent, Republican.

lostCustomerDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

lostCustomerReason
string (LostCustomerReason) [ 1 .. 35 ] characters
Example: "Deceased"

Used for regulatory purposes by the bank to track how long closed account history has been maintained for a customer. Possible values are: Competition, Deceased, Dissatisfied, Moved, MergedEntity, CeasedOperation

Array of objects (ServicerAlert)

Customer alerts to be received by the account servicer.

legalEntityReportingIndicator
boolean

Indicates whether the party is required to be reported as a legal entity.

numberOfEmployees
integer
Example: 100

Number of employees of the corporation.

anualSales
string (AmountInCents) <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: -9999999999999.99999999

services
string [ 1 .. 1025 ] characters
Example: "This is a description."

Description of the services that are offered for sale.

goods
string [ 1 .. 1025 ] characters
Example: "This is a description."

Description of the goods that are offered for sale.

Array of objects (Place)

Places where the goods and services are sold.

object

Business e-mails and phone numbers. Configuration of communication channels at organization level.

Array of objects (Phone)
Array of objects (Email)
Array of objects (CommunicationChannel)
webPage
string^[(http(s)?):\/\/(www\.)?a-zA-Z0-9@:%._\+~#=]...
Example: "http://portx.io"

Business web page

logo
string <byte> (ComercialLogo) [ 1 .. 32768 ] characters
Example: {"0":105,"1":86,"2":66,"3":79,"4":82,"5":119,"6":48,"7":75,"8":71,"9":103,"10":111,"11":65,"12":65,"13":65,"14":65,"15":78,"16":83,"17":85,"18":104,"19":69,"20":85,"21":103,"22":65,"23":65,"24":65,"25":90,"26":52,"27":65,"28":65,"29":65,"30":66,"31":111,"32":67,"33":65,"34":77,"35":65,"36":65,"37":65,"38":68,"39":50,"40":72,"41":109,"42":97,"43":78,"44":65,"45":65,"46":65,"47":65,"48":66,"49":71,"50":100,"51":66,"52":84,"53":85,"54":69,"55":65,"56":65,"57":76,"58":71,"59":80,"60":67,"61":47,"62":120,"63":104,"64":66,"65":81,"66":65,"67":65,"68":65,"69":65,"70":70,"71":122,"72":85,"73":107,"74":100,"75":67,"76":65,"77":75,"78":55,"79":79,"80":72,"81":79,"82":107,"83":65,"84":65,"85":65,"86":68,"87":56,"88":85,"89":69,"90":120,"91":85,"92":82,"93":81,"94":65,"95":65,"96":65,"97":70,"98":68,"99":80,"100":51,"101":49,"102":67,"103":47,"104":51,"105":119,"106":65,"107":81,"108":77,"109":65,"110":65,"111":81,"112":73,"113":65,"114":65,"115":90,"116":75,"117":86,"118":68,"119":72,"120":53,"121":119,"122":65,"123":89,"124":75,"125":70,"126":68,"127":70,"128":54,"129":108,"130":68,"131":70,"132":53,"133":65,"134":65,"135":86,"136":75,"137":103,"138":65,"139":86,"140":74,"141":86,"142":68,"143":72,"144":53,"145":49,"146":68,"147":72,"148":52,"149":48,"150":122,"151":68,"152":53,"153":119,"154":65,"155":89,"156":76,"157":65,"158":65,"159":89,"160":75,"161":70,"162":68,"163":71,"164":53,"165":85,"166":122,"167":71,"168":53,"169":81,"170":77,"171":87,"172":76,"173":81,"174":65,"175":87,"176":76,"177":81,"178":65,"179":87,"180":75,"181":81,"182":65,"183":89,"184":75,"185":49,"186":68,"187":72,"188":53,"189":49,"190":68,"191":72,"192":53,"193":69,"194":51,"195":70,"196":53,"197":48,"198":51,"199":70,"200":53,"201":65,"202":77,"203":89,"204":75,"205":103,"206":65,"207":89,"208":75,"209":108,"210":68,"211":73,"212":54,"213":65,"214":73,"215":88,"216":76,"217":70,"218":68,"219":73,"220":53,"221":108,"222":68,"223":71,"224":53,"225":107,"226":51,"227":71,"228":53,"229":103,"230":73,"231":90,"232":75,"233":119,"234":73,"235":90,"236":75,"237":81,"238":73,"239":88,"240":75,"241":119,"242":65,"243":88,"244":75,"245":49,"246":68,"247":74,"248":53,"249":119,"250":73,"251":89,"252":76,"253":65,"254":73,"255":89,"256":75,"257":108,"258":68,"259":72,"260":53,"261":85,"262":55,"263":70,"264":53,"265":48,"266":55,"267":70,"268":53,"269":81,"270":73,"271":89,"272":76,"273":65,"274":73,"275":89,"276":75,"277":107,"278":55,"279":73,"280":54,"281":69,"282":55,"283":71,"284":54,"285":65,"286":73,"287":90,"288":75,"289":119,"290":73,"291":88,"292":75,"293":48,"294":55,"295":71,"296":53,"297":103,"298":73,"299":90,"300":76,"301":65,"302":73,"303":90,"304":75,"305":103,"306":73,"307":88,"308":75,"309":107,"310":47,"311":72,"312":54,"313":85,"314":47,"315":72,"316":53,"317":119,"318":73,"319":89,"320":75,"321":119,"322":73,"323":89,"324":75,"325":107,"326":55,"327":71,"328":53,"329":119,"330":73,"331":89,"332":75,"333":119,"334":73,"335":89,"336":75,"337":85,"338":47,"339":73,"340":54,"341":69,"342":47,"343":71,"344":54,"345":65,"346":69,"347":90,"348":76,"349":65,"350":69,"351":88,"352":75,"353":103,"354":69,"355":88,"356":75,"357":107,"358":47,"359":72,"360":53,"361":119,"362":69,"363":89,"364":75,"365":48,"366":47,"367":73,"368":53,"369":107,"370":47,"371":71,"372":53,"373":103,"374":73,"375":90,"376":75,"377":119,"378":69,"379":90,"380":75,"381":119,"382":69,"383":88,"384":75,"385":48,"386":47,"387":72,"388":53,"389":119,"390":73,"391":89,"392":75,"393":119,"394":69,"395":89,"396":75,"397":48,"398":47,"399":73,"400":54,"401":69,"402":47,"403":71,"404":54,"405":65,"406":73,"407":90,"408":75,"409":119,"410":73,"411":88,"412":76,"413":65,"414":73,"415":88,"416":75,"417":119,"418":69,"419":88,"420":76,"421":69,"422":47,"423":72,"424":53,"425":119,"426":73,"427":89,"428":75,"429":54,"430":111,"431":85,"432":72,"433":77,"434":107,"435":65,"436":65,"437":65,"438":66,"439":83,"440":100,"441":70,"442":74,"443":79,"444":85,"445":119,"446":65,"447":81,"448":69,"449":66,"450":65,"451":81,"452":72,"453":121,"454":65,"455":103,"456":77,"457":68,"458":65,"459":119,"460":77,"461":69,"462":66,"463":65,"464":81,"465":69,"466":66,"467":65,"468":85,"469":70,"470":66,"471":81,"472":85,"473":70,"474":66,"475":102,"476":89,"477":71,"478":66,"479":103,"480":89,"481":71,"482":66,"483":103,"484":98,"485":50,"486":57,"487":119,"488":99,"489":72,"490":66,"491":119,"492":99,"493":72,"494":66,"495":119,"496":102,"497":51,"498":57,"499":47,"500":103,"501":73,"502":67,"503":65,"504":103,"505":73,"506":67,"507":80,"508":106,"509":52,"510":43,"511":80,"512":107,"513":74,"514":67,"515":81,"516":107,"517":74,"518":43,"519":102,"520":110,"521":53,"522":43,"523":103,"524":111,"525":75,"526":67,"527":118,"528":114,"529":54,"530":43,"531":118,"532":115,"533":76,"534":43,"535":47,"536":122,"537":56,"538":47,"539":80,"540":122,"541":56,"542":47,"543":102,"544":51,"545":57,"546":47,"547":118,"548":55,"549":43,"550":47,"551":118,"552":55,"553":43,"554":47,"555":77,"556":49,"557":99,"558":87,"559":116,"560":65,"561":65,"562":65,"563":73,"564":49,"565":48,"566":108,"567":69,"568":81,"569":86,"570":82,"571":52,"572":50,"573":117,"574":50,"575":100,"576":102,"577":51,"578":47,"579":84,"580":78,"581":104,"582":68,"583":71,"584":66,"585":81,"586":107,"587":50,"588":84,"589":81,"590":115,"591":50,"592":106,"593":65,"594":74,"595":90,"596":80,"597":68,"598":112,"599":71,"600":70,"601":56,"602":112,"603":111,"604":117,"605":112,"606":73,"607":117,"608":120,"609":81,"610":78,"611":71,"612":73,"613":97,"614":90,"615":76,"616":71,"617":112,"618":80,"619":43,"620":121,"621":118,"622":116,"623":47,"624":76,"625":47,"626":115,"627":65,"628":88,"629":83,"630":80,"631":70,"632":79,"633":117,"634":108,"635":79,"636":80,"637":113,"638":88,"639":57,"640":103,"641":79,"642":55,"643":80,"644":117,"645":110,"646":89,"647":99,"648":80,"649":100,"650":76,"651":112,"652":113,"653":43,"654":100,"655":107,"656":82,"657":51,"658":84,"659":80,"660":116,"661":88,"662":70,"663":48,"664":81,"665":122,"666":66,"667":69,"668":78,"669":78,"670":86,"671":101,"672":102,"673":80,"674":112,"675":85,"676":104,"677":77,"678":67,"679":70,"680":118,"681":103,"682":72,"683":80,"684":122,"685":49,"686":57,"687":121,"688":88,"689":80,"690":119,"691":73,"692":117,"693":80,"694":103,"695":119,"696":116,"697":68,"698":115,"699":121,"700":43,"701":107,"702":65,"703":76,"704":102,"705":111,"706":55,"707":113,"708":88,"709":55,"710":115,"711":78,"712":88,"713":80,"714":118,"715":56,"716":99,"717":87,"718":104,"719":51,"720":90,"721":78,"722":121,"723":99,"724":101,"725":117,"726":118,"727":104,"728":78,"729":54,"730":68,"731":66,"732":56,"733":48,"734":57,"735":111,"736":100,"737":110,"738":82,"739":115,"740":81,"741":70,"742":51,"743":56,"744":98,"745":116,"746":48,"747":114,"748":100,"749":54,"750":69,"751":114,"752":82,"753":54,"754":72,"755":86,"756":56,"757":84,"758":69,"759":69,"760":71,"761":118,"762":71,"763":111,"764":76,"765":104,"766":100,"767":65,"768":54,"769":118,"770":82,"771":68,"772":109,"773":120,"774":78,"775":105,"776":68,"777":87,"778":114,"779":71,"780":109,"781":110,"782":121,"783":49,"784":68,"785":56,"786":107,"787":101,"788":66,"789":103,"790":56,"791":80,"792":72,"793":100,"794":83,"795":67,"796":54,"797":47,"798":117,"799":66,"800":67,"801":122,"802":122,"803":84,"804":119,"805":90,"806":56,"807":43,"808":111,"809":80,"810":112,"811":84,"812":97,"813":80,"814":66,"815":114,"816":81,"817":65,"818":101,"819":47,"820":66,"821":67,"822":53,"823":103,"824":105,"825":48,"826":78,"827":50,"828":117,"829":73,"830":54,"831":103,"832":119,"833":102,"834":77,"835":54,"836":116,"837":68,"838":89,"839":102,"840":72,"841":102,"842":119,"843":99,"844":117,"845":79,"846":65,"847":54,"848":120,"849":74,"850":116,"851":122,"852":88,"853":117,"854":115,"855":116,"856":67,"857":108,"858":121,"859":119,"860":70,"861":68,"862":112,"863":119,"864":116,"865":78,"866":52,"867":79,"868":80,"869":97,"870":50,"871":108,"872":102,"873":116,"874":82,"875":52,"876":119,"877":87,"878":113,"879":57,"880":116,"881":81,"882":77,"883":88,"884":77,"885":65,"886":101,"887":114,"888":117,"889":82,"890":121,"891":52,"892":89,"893":71,"894":108,"895":48,"896":52,"897":65,"898":68,"899":88,"900":51,"901":99,"902":65,"903":70,"904":55,"905":80,"906":71,"907":101,"908":98,"909":82,"910":107,"911":90,"912":117,"913":77,"914":66,"915":68,"916":82,"917":70,"918":77,"919":117,"920":54,"921":50,"922":48,"923":47,"924":99,"925":77,"926":69,"927":121,"928":54,"929":89,"930":65,"931":73,"932":49,"933":54,"934":68,"935":90,"936":116,"937":104,"938":76,"939":97,"940":117,"941":65,"942":53,"943":99,"944":72,"945":47,"946":70,"947":89,"948":98,"949":52,"950":69,"951":76,"952":108,"953":107,"954":119,"955":72,"956":112,"957":71,"958":55,"959":102,"960":68,"961":108,"962":122,"963":103,"964":75,"965":89,"966":89,"967":77,"968":99,"969":65,"970":50,"971":97,"972":98,"973":88,"974":43,"975":69,"976":57,"977":118,"978":86,"979":70,"980":66,"981":47,"982":99,"983":68,"984":70,"985":49,"986":120,"987":110,"988":79,"989":115,"990":66,"991":98,"992":98,"993":121,"994":66,"995":85,"996":51,"997":119,"998":43,"999":116,"1000":54,"1001":52,"1002":56,"1003":79,"1004":48,"1005":78,"1006":98,"1007":98,"1008":77,"1009":72,"1010":68,"1011":66,"1012":70,"1013":100,"1014":65,"1015":66,"1016":49,"1017":110,"1018":111,"1019":76,"1020":90,"1021":116,"1022":118,"1023":86,"1024":48,"1025":65,"1026":70,"1027":121,"1028":97,"1029":57,"1030":111,"1031":49,"1032":52,"1033":111,"1034":74,"1035":109,"1036":110,"1037":71,"1038":90,"1039":90,"1040":116,"1041":112,"1042":55,"1043":71,"1044":51,"1045":120,"1046":85,"1047":100,"1048":49,"1049":76,"1050":76,"1051":101,"1052":117,"1053":106,"1054":120,"1055":99,"1056":107,"1057":70,"1058":97,"1059":68,"1060":49,"1061":115,"1062":106,"1063":78,"1064":122,"1065":98,"1066":121,"1067":99,"1068":47,"1069":82,"1070":56,"1071":110,"1072":120,"1073":97,"1074":118,"1075":85,"1076":102,"1077":107,"1078":112,"1079":99,"1080":47,"1081":99,"1082":120,"1083":86,"1084":56,"1085":52,"1086":101,"1087":117,"1088":112,"1089":115,"1090":104,"1091":111,"1092":76,"1093":72,"1094":81,"1095":98,"1096":75,"1097":90,"1098":114,"1099":86,"1100":84,"1101":109,"1102":85,"1103":52,"1104":97,"1105":75,"1106":67,"1107":68,"1108":89,"1109":82,"1110":49,"1111":116,"1112":105,"1113":87,"1114":98,"1115":98,"1116":84,"1117":66,"1118":101,"1119":106,"1120":68,"1121":120,"1122":50,"1123":107,"1124":82,"1125":109,"1126":108,"1127":82,"1128":79,"1129":88,"1130":109,"1131":83,"1132":50,"1133":56,"1134":55,"1135":116,"1136":54,"1137":84,"1138":56,"1139":48,"1140":88,"1141":50,"1142":57,"1143":67,"1144":90,"1145":120,"1146":81,"1147":122,"1148":90,"1149":75,"1150":105,"1151":100,"1152":111,"1153":49,"1154":70,"1155":75,"1156":104,"1157":52,"1158":52,"1159":88,"1160":98,"1161":50,"1162":116,"1163":88,"1164":79,"1165":104,"1166":104,"1167":84,"1168":54,"1169":65,"1170":66,"1171":104,"1172":118,"1173":101,"1174":48,"1175":122,"1176":99,"1177":81,"1178":72,"1179":52,"1180":82,"1181":88,"1182":79,"1183":69,"1184":81,"1185":74,"1186":50,"1187":74,"1188":48,"1189":55,"1190":107,"1191":57,"1192":54,"1193":68,"1194":78,"1195":80,"1196":111,"1197":66,"1198":77,"1199":100,"1200":53,"1201":82,"1202":71,"1203":74,"1204":102,"1205":75,"1206":120,"1207":89,"1208":71,"1209":77,"1210":80,"1211":83,"1212":111,"1213":90,"1214":55,"1215":50,"1216":85,"1217":120,"1218":56,"1219":53,"1220":87,"1221":50,"1222":57,"1223":51,"1224":117,"1225":76,"1226":106,"1227":65,"1228":56,"1229":70,"1230":86,"1231":116,"1232":65,"1233":114,"1234":85,"1235":77,"1236":106,"1237":98,"1238":98,"1239":108,"1240":74,"1241":65,"1242":57,"1243":52,"1244":111,"1245":113,"1246":115,"1247":56,"1248":89,"1249":107,"1250":56,"1251":43,"1252":43,"1253":69,"1254":119,"1255":53,"1256":74,"1257":72,"1258":87,"1259":116,"1260":69,"1261":90,"1262":69,"1263":79,"1264":114,"1265":78,"1266":89,"1267":98,"1268":71,"1269":120,"1270":101,"1271":89,"1272":118,"1273":117,"1274":118,"1275":69,"1276":113,"1277":77,"1278":43,"1279":84,"1280":109,"1281":101,"1282":117,"1283":53,"1284":74,"1285":110,"1286":108,"1287":109,"1288":111,"1289":53,"1290":104,"1291":84,"1292":72,"1293":106,"1294":71,"1295":71,"1296":48,"1297":116,"1298":118,"1299":122,"1300":43,"1301":100,"1302":47,"1303":80,"1304":111,"1305":72,"1306":117,"1307":57,"1308":55,"1309":87,"1310":105,"1311":57,"1312":116,"1313":100,"1314":110,"1315":56,"1316":65,"1317":117,"1318":99,"1319":50,"1320":122,"1321":105,"1322":48,"1323":78,"1324":78,"1325":85,"1326":110,"1327":100,"1328":53,"1329":78,"1330":70,"1331":43,"1332":113,"1333":76,"1334":115,"1335":56,"1336":56,"1337":97,"1338":107,"1339":43,"1340":118,"1341":99,"1342":109,"1343":112,"1344":55,"1345":84,"1346":102,"1347":119,"1348":84,"1349":118,"1350":116,"1351":79,"1352":100,"1353":65,"1354":67,"1355":97,"1356":98,"1357":89,"1358":57,"1359":53,"1360":53,"1361":90,"1362":108,"1363":78,"1364":71,"1365":104,"1366":67,"1367":118,"1368":73,"1369":82,"1370":114,"1371":115,"1372":111,"1373":90,"1374":115,"1375":56,"1376":117,"1377":108,"1378":84,"1379":106,"1380":76,"1381":111,"1382":47,"1383":52,"1384":88,"1385":90,"1386":47,"1387":101,"1388":112,"1389":78,"1390":83,"1391":87,"1392":71,"1393":55,"1394":121,"1395":68,"1396":113,"1397":81,"1398":116,"1399":99,"1400":55,"1401":47,"1402":77,"1403":57,"1404":122,"1405":71,"1406":80,"1407":53,"1408":117,"1409":116,"1410":67,"1411":116,"1412":72,"1413":50,"1414":68,"1415":97,"1416":54,"1417":113,"1418":71,"1419":98,"1420":80,"1421":74,"1422":113,"1423":74,"1424":117,"1425":111,"1426":89,"1427":56,"1428":121,"1429":113,"1430":49,"1431":101,"1432":112,"1433":106,"1434":99,"1435":112,"1436":77,"1437":53,"1438":101,"1439":109,"1440":70,"1441":76,"1442":55,"1443":104,"1444":89,"1445":76,"1446":49,"1447":70,"1448":106,"1449":72,"1450":54,"1451":66,"1452":119,"1453":47,"1454":100,"1455":86,"1456":69,"1457":55,"1458":99,"1459":104,"1460":106,"1461":108,"1462":116,"1463":117,"1464":56,"1465":104,"1466":119,"1467":51,"1468":79,"1469":79,"1470":86,"1471":82,"1472":54,"1473":80,"1474":111,"1475":105,"1476":118,"1477":99,"1478":85,"1479":110,"1480":56,"1481":122,"1482":57,"1483":108,"1484":84,"1485":116,"1486":54,"1487":66,"1488":119,"1489":88,"1490":112,"1491":55,"1492":122,"1493":43,"1494":103,"1495":88,"1496":122,"1497":71,"1498":43,"1499":122,"1500":99,"1501":51,"1502":72,"1503":110,"1504":121,"1505":86,"1506":118,"1507":53,"1508":43,"1509":119,"1510":54,"1511":48,"1512":81,"1513":75,"1514":50,"1515":50,"1516":121,"1517":100,"1518":110,"1519":103,"1520":119,"1521":90,"1522":99,"1523":101,"1524":50,"1525":71,"1526":120,"1527":108,"1528":66,"1529":83,"1530":111,"1531":51,"1532":57,"1533":113,"1534":82,"1535":53,"1536":53,"1537":108,"1538":115,"1539":107,"1540":50,"1541":89,"1542":70,"1543":120,"1544":43,"1545":65,"1546":119,"1547":75,"1548":74,"1549":97,"1550":81,"1551":71,"1552":72,"1553":54,"1554":116,"1555":72,"1556":100,"1557":66,"1558":48,"1559":105,"1560":113,"1561":97,"1562":97,"1563":51,"1564":72,"1565":74,"1566":88,"1567":97,"1568":51,"1569":75,"1570":121,"1571":51,"1572":78,"1573":117,"1574":99,"1575":50,"1576":48,"1577":52,"1578":111,"1579":56,"1580":88,"1581":120,"1582":81,"1583":113,"1584":84,"1585":84,"1586":49,"1587":90,"1588":105,"1589":70,"1590":104,"1591":90,"1592":55,"1593":112,"1594":122,"1595":74,"1596":51,"1597":83,"1598":57,"1599":87,"1600":116,"1601":74,"1602":51,"1603":116,"1604":50,"1605":117,"1606":83,"1607":90,"1608":47,"1609":122,"1610":69,"1611":55,"1612":66,"1613":86,"1614":99,"1615":111,"1616":112,"1617":117,"1618":70,"1619":51,"1620":67,"1621":47,"1622":69,"1623":100,"1624":57,"1625":120,"1626":98,"1627":84,"1628":87,"1629":119,"1630":101,"1631":90,"1632":50,"1633":107,"1634":120,"1635":48,"1636":56,"1637":74,"1638":111,"1639":75,"1640":49,"1641":85,"1642":54,"1643":98,"1644":99,"1645":51,"1646":84,"1647":121,"1648":105,"1649":74,"1650":89,"1651":53,"1652":88,"1653":83,"1654":106,"1655":81,"1656":57,"1657":110,"1658":90,"1659":104,"1660":113,"1661":83,"1662":56,"1663":51,"1664":77,"1665":53,"1666":65,"1667":98,"1668":116,"1669":102,"1670":75,"1671":73,"1672":66,"1673":57,"1674":74,"1675":112,"1676":68,"1677":86,"1678":90,"1679":53,"1680":71,"1681":109,"1682":77,"1683":49,"1684":118,"1685":99,"1686":110,"1687":100,"1688":75,"1689":55,"1690":70,"1691":87,"1692":70,"1693":111,"1694":104,"1695":48,"1696":48,"1697":71,"1698":86,"1699":57,"1700":109,"1701":69,"1702":99,"1703":114,"1704":106,"1705":47,"1706":103,"1707":76,"1708":87,"1709":115,"1710":115,"1711":116,"1712":77,"1713":113,"1714":108,"1715":109,"1716":71,"1717":111,"1718":47,"1719":76,"1720":109,"1721":87,"1722":85,"1723":99,"1724":54,"1725":79,"1726":87,"1727":82,"1728":74,"1729":53,"1730":105,"1731":85,"1732":86,"1733":82,"1734":54,"1735":86,"1736":114,"1737":112,"1738":47,"1739":74,"1740":51,"1741":87,"1742":116,"1743":103,"1744":80,"1745":51,"1746":109,"1747":68,"1748":66,"1749":78,"1750":99,"1751":82,"1752":98,"1753":120,"1754":49,"1755":66,"1756":76,"1757":52,"1758":43,"1759":85,"1760":114,"1761":118,"1762":56,"1763":50,"1764":68,"1765":104,"1766":54,"1767":100,"1768":71,"1769":57,"1770":73,"1771":54,"1772":116,"1773":81,"1774":119,"1775":102,"1776":81,"1777":74,"1778":53,"1779":78,"1780":47,"1781":98,"1782":48,"1783":119,"1784":121,"1785":75,"1786":80,"1787":81,"1788":57,"1789":102,"1790":71,"1791":87,"1792":108,"1793":78,"1794":114,"1795":113,"1796":86,"1797":66,"1798":97,"1799":101,"1800":85,"1801":113,"1802":68,"1803":97,"1804":56,"1805":83,"1806":70,"1807":102,"1808":102,"1809":90,"1810":77,"1811":48,"1812":53,"1813":110,"1814":47,"1815":43,"1816":97,"1817":66,"1818":111,"1819":56,"1820":112,"1821":98,"1822":85,"1823":120,"1824":66,"1825":110,"1826":104,"1827":53,"1828":102,"1829":118,"1830":73,"1831":110,"1832":68,"1833":52,"1834":82,"1835":43,"1836":75,"1837":79,"1838":78,"1839":51,"1840":106,"1841":87,"1842":67,"1843":57,"1844":114,"1845":84,"1846":66,"1847":118,"1848":122,"1849":103,"1850":71,"1851":97,"1852":120,"1853":74,"1854":67,"1855":101,"1856":90,"1857":71,"1858":120,"1859":114,"1860":87,"1861":82,"1862":116,"1863":68,"1864":104,"1865":120,"1866":97,"1867":65,"1868":80,"1869":73,"1870":108,"1871":72,"1872":101,"1873":82,"1874":83,"1875":54,"1876":116,"1877":106,"1878":105,"1879":104,"1880":108,"1881":88,"1882":105,"1883":68,"1884":104,"1885":50,"1886":116,"1887":87,"1888":76,"1889":110,"1890":65,"1891":97,"1892":80,"1893":89,"1894":87,"1895":100,"1896":115,"1897":66,"1898":74,"1899":122,"1900":100,"1901":114,"1902":77,"1903":110,"1904":116,"1905":51,"1906":86,"1907":117,"1908":101,"1909":86,"1910":83,"1911":54,"1912":112,"1913":113,"1914":81,"1915":50,"1916":69,"1917":120,"1918":49,"1919":69,"1920":47,"1921":115,"1922":119,"1923":50,"1924":55,"1925":78,"1926":121,"1927":122,"1928":109,"1929":74,"1930":48,"1931":107,"1932":53,"1933":101,"1934":66,"1935":87,"1936":110,"1937":66,"1938":105,"1939":122,"1940":71,"1941":121,"1942":68,"1943":80,"1944":66,"1945":50,"1946":57,"1947":111,"1948":85,"1949":80,"1950":71,"1951":117,"1952":67,"1953":97,"1954":109,"1955":78,"1956":81,"1957":103,"1958":101,"1959":103,"1960":50,"1961":82,"1962":98,"1963":120,"1964":121,"1965":112,"1966":80,"1967":68,"1968":53,"1969":67,"1970":90,"1971":51,"1972":81,"1973":47,"1974":67,"1975":113,"1976":69,"1977":118,"1978":109,"1979":78,"1980":115,"1981":102,"1982":75,"1983":107,"1984":51,"1985":115,"1986":65,"1987":97,"1988":83,"1989":71,"1990":56,"1991":57,"1992":102,"1993":67,"1994":115,"1995":100,"1996":52,"1997":117,"1998":66,"1999":54,"2000":104,"2001":51,"2002":49,"2003":122,"2004":106,"2005":108,"2006":89,"2007":101,"2008":117,"2009":86,"2010":97,"2011":119,"2012":117,"2013":110,"2014":68,"2015":67,"2016":74,"2017":109,"2018":98,"2019":49,"2020":75,"2021":77,"2022":51,"2023":121,"2024":120,"2025":48,"2026":104,"2027":53,"2028":87,"2029":104,"2030":78,"2031":118,"2032":121,"2033":49,"2034":73,"2035":78,"2036":85,"2037":67,"2038":73,"2039":43,"2040":66,"2041":69,"2042":77,"2043":72,"2044":113,"2045":104,"2046":77,"2047":81,"2048":56,"2049":87,"2050":47,"2051":97,"2052":49,"2053":99,"2054":110,"2055":122,"2056":120,"2057":74,"2058":83,"2059":102,"2060":101,"2061":53,"2062":104,"2063":70,"2064":81,"2065":50,"2066":119,"2067":99,"2068":67,"2069":86,"2070":86,"2071":53,"2072":109,"2073":117,"2074":109,"2075":87,"2076":51,"2077":72,"2078":75,"2079":90,"2080":68,"2081":51,"2082":108,"2083":85,"2084":55,"2085":57,"2086":112,"2087":117,"2088":70,"2089":54,"2090":66,"2091":56,"2092":116,"2093":74,"2094":101,"2095":89,"2096":102,"2097":54,"2098":114,"2099":120,"2100":77,"2101":73,"2102":57,"2103":107,"2104":80,"2105":109,"2106":88,"2107":102,"2108":52,"2109":116,"2110":87,"2111":74,"2112":115,"2113":97,"2114":88,"2115":101,"2116":109,"2117":86,"2118":97,"2119":115,"2120":79,"2121":113,"2122":102,"2123":49,"2124":70,"2125":116,"2126":107,"2127":83,"2128":116,"2129":85,"2130":55,"2131":90,"2132":98,"2133":118,"2134":75,"2135":111,"2136":100,"2137":74,"2138":50,"2139":82,"2140":109,"2141":103,"2142":110,"2143":97,"2144":49,"2145":67,"2146":118,"2147":68,"2148":78,"2149":84,"2150":115,"2151":88,"2152":50,"2153":66,"2154":51,"2155":114,"2156":97,"2157":107,"2158":117,"2159":57,"2160":81,"2161":43,"2162":72,"2163":118,"2164":113,"2165":87,"2166":109,"2167":97,"2168":116,"2169":56,"2170":109,"2171":84,"2172":101,"2173":90,"2174":73,"2175":110,"2176":104,"2177":105,"2178":118,"2179":98,"2180":49,"2181":110,"2182":104,"2183":104,"2184":110,"2185":49,"2186":97,"2187":79,"2188":80,"2189":79,"2190":119,"2191":55,"2192":74,"2193":76,"2194":101,"2195":85,"2196":102,"2197":51,"2198":108,"2199":121,"2200":52,"2201":85,"2202":109,"2203":101,"2204":88,"2205":85,"2206":83,"2207":112,"2208":66,"2209":65,"2210":122,"2211":73,"2212":114,"2213":76,"2214":110,"2215":56,"2216":104,"2217":122,"2218":115,"2219":43,"2220":88,"2221":116,"2222":90,"2223":72,"2224":76,"2225":89,"2226":122,"2227":82,"2228":107,"2229":57,"2230":115,"2231":113,"2232":85,"2233":90,"2234":54,"2235":121,"2236":54,"2237":85,"2238":109,"2239":101,"2240":70,"2241":70,"2242":107,"2243":74,"2244":74,"2245":106,"2246":109,"2247":100,"2248":56,"2249":57,"2250":69,"2251":68,"2252":55,"2253":114,"2254":117,"2255":54,"2256":54,"2257":48,"2258":115,"2259":101,"2260":51,"2261":100,"2262":122,"2263":47,"2264":68,"2265":111,"2266":77,"2267":71,"2268":68,"2269":102,"2270":101,"2271":53,"2272":90,"2273":52,"2274":83,"2275":89,"2276":115,"2277":112,"2278":51,"2279":107,"2280":105,"2281":82,"2282":100,"2283":51,"2284":102,"2285":101,"2286":48,"2287":121,"2288":122,"2289":68,"2290":48,"2291":121,"2292":108,"2293":75,"2294":49,"2295":53,"2296":101,"2297":80,"2298":71,"2299":85,"2300":113,"2301":97,"2302":87,"2303":48,"2304":87,"2305":121,"2306":82,"2307":81,"2308":89,"2309":71,"2310":49,"2311":101,"2312":72,"2313":74,"2314":110,"2315":107,"2316":71,"2317":84,"2318":83,"2319":70,"2320":74,"2321":51,"2322":108,"2323":121,"2324":47,"2325":71,"2326":89,"2327":73,"2328":118,"2329":78,"2330":80,"2331":53,"2332":75,"2333":52,"2334":98,"2335":99,"2336":110,"2337":118,"2338":113,"2339":81,"2340":112,"2341":57,"2342":65,"2343":98,"2344":97,"2345":104,"2346":50,"2347":122,"2348":110,"2349":48,"2350":90,"2351":98,"2352":108,"2353":108,"2354":98,"2355":75,"2356":50,"2357":65,"2358":110,"2359":113,"2360":112,"2361":108,"2362":51,"2363":107,"2364":54,"2365":87,"2366":103,"2367":43,"2368":68,"2369":99,"2370":51,"2371":87,"2372":79,"2373":67,"2374":103,"2375":68,"2376":56,"2377":83,"2378":55,"2379":105,"2380":108,"2381":117,"2382":101,"2383":115,"2384":83,"2385":66,"2386":68,"2387":52,"2388":107,"2389":121,"2390":74,"2391":77,"2392":110,"2393":89,"2394":43,"2395":107,"2396":48,"2397":90,"2398":80,"2399":54,"2400":107,"2401":105,"2402":102,"2403":87,"2404":98,"2405":87,"2406":104,"2407":70,"2408":114,"2409":48,"2410":121,"2411":82,"2412":85,"2413":76,"2414":98,"2415":66,"2416":47,"2417":114,"2418":53,"2419":100,"2420":83,"2421":90,"2422":72,"2423":121,"2424":73,"2425":115,"2426":89,"2427":72,"2428":103,"2429":54,"2430":83,"2431":74,"2432":103,"2433":106,"2434":75,"2435":77,"2436":74,"2437":90,"2438":111,"2439":90,"2440":88,"2441":89,"2442":79,"2443":118,"2444":79,"2445":119,"2446":50,"2447":107,"2448":57,"2449":88,"2450":122,"2451":104,"2452":83,"2453":120,"2454":55,"2455":57,"2456":116,"2457":106,"2458":119,"2459":107,"2460":88,"2461":88,"2462":101,"2463":120,"2464":90,"2465":115,"2466":50,"2467":81,"2468":109,"2469":119,"2470":55,"2471":81,"2472":74,"2473":114,"2474":52,"2475":117,"2476":99,"2477":85,"2478":71,"2479":100,"2480":102,"2481":87,"2482":122,"2483":50,"2484":72,"2485":83,"2486":117,"2487":117,"2488":119,"2489":84,"2490":98,"2491":120,"2492":76,"2493":117,"2494":106,"2495":121,"2496":83,"2497":69,"2498":98,"2499":73,"2500":50,"2501":99,"2502":120,"2503":101,"2504":69,"2505":99,"2506":70,"2507":86,"2508":81,"2509":75,"2510":116,"2511":109,"2512":122,"2513":82,"2514":114,"2515":110,"2516":78,"2517":104,"2518":65,"2519":51,"2520":101,"2521":82,"2522":74,"2523":114,"2524":100,"2525":112,"2526":68,"2527":84,"2528":47,"2529":66,"2530":104,"2531":84,"2532":106,"2533":109,"2534":117,"2535":99,"2536":73,"2537":117,"2538":97,"2539":122,"2540":79,"2541":118,"2542":76,"2543":73,"2544":71,"2545":54,"2546":102,"2547":105,"2548":65,"2549":121,"2550":112,"2551":100,"2552":69,"2553":56,"2554":121,"2555":97,"2556":80,"2557":118,"2558":79,"2559":76,"2560":47,"2561":117,"2562":110,"2563":121,"2564":105,"2565":78,"2566":73,"2567":67,"2568":112,"2569":51,"2570":74,"2571":98,"2572":97,"2573":66,"2574":50,"2575":65,"2576":113,"2577":117,"2578":101,"2579":50,"2580":84,"2581":102,"2582":79,"2583":82,"2584":121,"2585":102,"2586":76,"2587":56,"2588":75,"2589":49,"2590":43,"2591":47,"2592":99,"2593":85,"2594":113,"2595":106,"2596":54,"2597":122,"2598":90,"2599":104,"2600":118,"2601":88,"2602":109,"2603":84,"2604":109,"2605":81,"2606":52,"2607":99,"2608":53,"2609":77,"2610":110,"2611":77,"2612":84,"2613":120,"2614":81,"2615":111,"2616":107,"2617":51,"2618":65,"2619":112,"2620":85,"2621":80,"2622":76,"2623":73,"2624":119,"2625":56,"2626":102,"2627":68,"2628":117,"2629":117,"2630":101,"2631":53,"2632":101,"2633":107,"2634":80,"2635":121,"2636":110,"2637":105,"2638":66,"2639":98,"2640":53,"2641":89,"2642":57,"2643":97,"2644":120,"2645":72,"2646":110,"2647":69,"2648":54,"2649":120,"2650":48,"2651":52,"2652":121,"2653":75,"2654":77,"2655":77,"2656":110,"2657":52,"2658":111,"2659":43,"2660":114,"2661":89,"2662":110,"2663":86,"2664":80,"2665":116,"2666":77,"2667":85,"2668":70,"2669":76,"2670":90,"2671":74,"2672":79,"2673":69,"2674":87,"2675":85,"2676":74,"2677":49,"2678":54,"2679":99,"2680":67,"2681":103,"2682":56,"2683":111,"2684":100,"2685":76,"2686":49,"2687":68,"2688":50,"2689":47,"2690":81,"2691":53,"2692":90,"2693":72,"2694":49,"2695":99,"2696":51,"2697":107,"2698":87,"2699":101,"2700":66,"2701":72,"2702":52,"2703":85,"2704":111,"2705":98,"2706":109,"2707":70,"2708":56,"2709":74,"2710":52,"2711":49,"2712":56,"2713":115,"2714":106,"2715":70,"2716":115,"2717":112,"2718":82,"2719":98,"2720":110,"2721":115,"2722":108,"2723":105,"2724":54,"2725":109,"2726":121,"2727":85,"2728":101,"2729":76,"2730":113,"2731":79,"2732":105,"2733":68,"2734":53,"2735":48,"2736":120,"2737":69,"2738":111,"2739":72,"2740":76,"2741":118,"2742":73,"2743":115,"2744":98,"2745":111,"2746":65,"2747":118,"2748":79,"2749":113,"2750":115,"2751":88,"2752":86,"2753":82,"2754":117,"2755":49,"2756":71,"2757":65,"2758":71,"2759":86,"2760":105,"2761":51,"2762":88,"2763":108,"2764":79,"2765":67,"2766":108,"2767":106,"2768":84,"2769":112,"2770":106,"2771":108,"2772":101,"2773":86,"2774":55,"2775":116,"2776":76,"2777":103,"2778":109,"2779":101,"2780":114,"2781":115,"2782":109,"2783":98,"2784":79,"2785":49,"2786":53,"2787":119,"2788":118,"2789":113,"2790":110,"2791":99,"2792":83,"2793":90,"2794":53,"2795":113,"2796":89,"2797":102,"2798":104,"2799":107,"2800":86,"2801":73,"2802":120,"2803":75,"2804":55,"2805":69,"2806":52,"2807":89,"2808":98,"2809":98,"2810":87,"2811":48,"2812":74,"2813":75,"2814":120,"2815":71,"2816":83,"2817":80,"2818":76,"2819":69,"2820":117,"2821":117,"2822":54,"2823":121,"2824":104,"2825":54,"2826":88,"2827":114,"2828":78,"2829":114,"2830":107,"2831":43,"2832":68,"2833":86,"2834":113,"2835":106,"2836":75,"2837":56,"2838":117,"2839":83,"2840":112,"2841":49,"2842":73,"2843":89,"2844":49,"2845":115,"2846":100,"2847":98,"2848":81,"2849":90,"2850":65,"2851":110,"2852":109,"2853":101,"2854":72,"2855":104,"2856":109,"2857":105,"2858":74,"2859":80,"2860":85,"2861":55,"2862":115,"2863":116,"2864":82,"2865":101,"2866":108,"2867":103,"2868":66,"2869":114,"2870":113,"2871":71,"2872":117,"2873":71,"2874":66,"2875":113,"2876":73,"2877":76,"2878":69,"2879":49,"2880":82,"2881":106,"2882":112,"2883":119,"2884":107,"2885":119,"2886":101,"2887":108,"2888":122,"2889":48,"2890":104,"2891":81,"2892":53,"2893":74,"2894":70,"2895":114,"2896":109,"2897":98,"2898":117,"2899":77,"2900":56,"2901":117,"2902":122,"2903":113,"2904":83,"2905":120,"2906":85,"2907":74,"2908":122,"2909":114,"2910":118,"2911":101,"2912":100,"2913":51,"2914":107,"2915":89,"2916":90,"2917":77,"2918":104,"2919":110,"2920":106,"2921":84,"2922":114,"2923":75,"2924":73,"2925":49,"2926":113,"2927":108,"2928":100,"2929":101,"2930":119,"2931":48,"2932":97,"2933":102,"2934":73,"2935":107,"2936":101,"2937":79,"2938":117,"2939":78,"2940":73,"2941":73,"2942":43,"2943":56,"2944":82,"2945":70,"2946":90,"2947":115,"2948":120,"2949":68,"2950":48,"2951":77,"2952":88,"2953":97,"2954":56,"2955":52,"2956":49,"2957":97,"2958":99,"2959":120,"2960":108,"2961":87,"2962":47,"2963":80,"2964":56,"2965":113,"2966":103,"2967":55,"2968":51,"2969":87,"2970":107,"2971":55,"2972":77,"2973":79,"2974":49,"2975":98,"2976":52,"2977":65,"2978":115,"2979":117,"2980":101,"2981":87,"2982":76,"2983":119,"2984":73,"2985":85,"2986":88,"2987":122,"2988":79,"2989":119,"2990":56,"2991":115,"2992":88,"2993":71,"2994":67,"2995":90,"2996":82,"2997":118,"2998":106,"2999":111,"3000":119,"3001":70,"3002":107,"3003":101,"3004":48,"3005":100,"3006":103,"3007":122,"3008":108,"3009":84,"3010":119,"3011":84,"3012":81,"3013":90,"3014":89,"3015":110,"3016":81,"3017":83,"3018":56,"3019":87,"3020":56,"3021":102,"3022":76,"3023":107,"3024":56,"3025":78,"3026":97,"3027":99,"3028":120,"3029":79,"3030":53,"3031":100,"3032":100,"3033":49,"3034":51,"3035":51,"3036":114,"3037":82,"3038":49,"3039":121,"3040":87,"3041":97,"3042":80,"3043":117,"3044":56,"3045":104,"3046":103,"3047":71,"3048":48,"3049":78,"3050":108,"3051":50,"3052":85,"3053":57,"3054":68,"3055":108,"3056":107,"3057":89,"3058":101,"3059":80,"3060":50,"3061":81,"3062":116,"3063":68,"3064":121,"3065":57,"3066":77,"3067":120,"3068":114,"3069":90,"3070":68,"3071":51,"3072":98,"3073":72,"3074":83,"3075":78,"3076":75,"3077":90,"3078":72,"3079":83,"3080":54,"3081":79,"3082":68,"3083":84,"3084":77,"3085":117,"3086":85,"3087":82,"3088":73,"3089":105,"3090":118,"3091":111,"3092":52,"3093":115,"3094":68,"3095":121,"3096":116,"3097":76,"3098":66,"3099":98,"3100":79,"3101":76,"3102":72,"3103":121,"3104":120,"3105":77,"3106":98,"3107":110,"3108":114,"3109":57,"3110":88,"3111":108,"3112":81,"3113":81,"3114":118,"3115":80,"3116":66,"3117":89,"3118":104,"3119":57,"3120":97,"3121":51,"3122":48,"3123":109,"3124":79,"3125":115,"3126":103,"3127":118,"3128":73,"3129":120,"3130":85,"3131":117,"3132":69,"3133":81,"3134":47,"3135":71,"3136":113,"3137":106,"3138":89,"3139":72,"3140":109,"3141":98,"3142":85,"3143":99,"3144":118,"3145":88,"3146":55,"3147":53,"3148":109,"3149":81,"3150":118,"3151":73,"3152":116,"3153":74,"3154":108,"3155":68,"3156":82,"3157":54,"3158":65,"3159":76,"3160":53,"3161":77,"3162":90,"3163":82,"3164":49,"3165":112,"3166":110,"3167":47,"3168":110,"3169":43,"3170":52,"3171":86,"3172":74,"3173":121,"3174":51,"3175":112,"3176":99,"3177":78,"3178":53,"3179":68,"3180":76,"3181":51,"3182":107,"3183":119,"3184":43,"3185":57,"3186":90,"3187":117,"3188":56,"3189":104,"3190":100,"3191":79,"3192":88,"3193":83,"3194":78,"3195":43,"3196":48,"3197":77,"3198":117,"3199":47,"3200":80,"3201":110,"3202":101,"3203":98,"3204":68,"3205":55,"3206":75,"3207":87,"3208":43,"3209":72,"3210":54,"3211":105,"3212":49,"3213":114,"3214":52,"3215":49,"3216":47,"3217":115,"3218":74,"3219":112,"3220":67,"3221":66,"3222":81,"3223":88,"3224":73,"3225":74,"3226":57,"3227":47,"3228":72,"3229":51,"3230":114,"3231":89,"3232":86,"3233":104,"3234":87,"3235":67,"3236":122,"3237":100,"3238":113,"3239":56,"3240":122,"3241":86,"3242":48,"3243":52,"3244":68,"3245":83,"3246":70,"3247":72,"3248":55,"3249":102,"3250":51,"3251":115,"3252":51,"3253":73,"3254":88,"3255":84,"3256":69,"3257":76,"3258":87,"3259":115,"3260":85,"3261":75,"3262":119,"3263":49,"3264":43,"3265":106,"3266":109,"3267":56,"3268":54,"3269":55,"3270":86,"3271":43,"3272":97,"3273":109,"3274":80,"3275":89,"3276":122,"3277":51,"3278":55,"3279":80,"3280":50,"3281":121,"3282":43,"3283":107,"3284":47,"3285":47,"3286":67,"3287":120,"3288":85,"3289":52,"3290":56,"3291":76,"3292":122,"3293":72,"3294":81,"3295":81,"3296":51,"3297":106,"3298":80,"3299":117,"3300":105,"3301":119,"3302":116,"3303":111,"3304":86,"3305":53,"3306":107,"3307":71,"3308":79,"3309":108,"3310":106,"3311":113,"3312":107,"3313":111,"3314":102,"3315":89,"3316":55,"3317":49,"3318":107,"3319":76,"3320":112,"3321":121,"3322":72,"3323":52,"3324":117,"3325":77,"3326":65,"3327":105,"3328":99,"3329":47,"3330":104,"3331":53,"3332":74,"3333":81,"3334":57,"3335":99,"3336":81,"3337":72,"3338":43,"3339":69,"3340":100,"3341":121,"3342":51,"3343":81,"3344":65,"3345":88,"3346":47,"3347":115,"3348":49,"3349":49,"3350":51,"3351":121,"3352":122,"3353":79,"3354":77,"3355":78,"3356":47,"3357":122,"3358":77,"3359":108,"3360":80,"3361":51,"3362":113,"3363":115,"3364":115,"3365":72,"3366":68,"3367":66,"3368":120,"3369":101,"3370":75,"3371":72,"3372":114,"3373":51,"3374":65,"3375":97,"3376":119,"3377":106,"3378":120,"3379":104,"3380":79,"3381":67,"3382":48,"3383":110,"3384":78,"3385":119,"3386":73,"3387":100,"3388":56,"3389":69,"3390":97,"3391":88,"3392":57,"3393":53,"3394":86,"3395":102,"3396":119,"3397":82,"3398":114,"3399":108,"3400":53,"3401":89,"3402":73,"3403":112,"3404":70,"3405":120,"3406":101,"3407":89,"3408":54,"3409":101,"3410":66,"3411":84,"3412":97,"3413":79,"3414":111,"3415":114,"3416":53,"3417":111,"3418":74,"3419":118,"3420":48,"3421":81,"3422":57,"3423":48,"3424":52,"3425":72,"3426":47,"3427":74,"3428":52,"3429":49,"3430":53,"3431":71,"3432":117,"3433":48,"3434":97,"3435":70,"3436":48,"3437":56,"3438":65,"3439":70,"3440":109,"3441":114,"3442":103,"3443":88,"3444":67,"3445":113,"3446":101,"3447":43,"3448":117,"3449":97,"3450":68,"3451":87,"3452":84,"3453":52,"3454":111,"3455":70,"3456":79,"3457":117,"3458":68,"3459":105,"3460":65,"3461":105,"3462":56,"3463":47,"3464":78,"3465":82,"3466":113,"3467":115,"3468":85,"3469":97,"3470":98,"3471":119,"3472":56,"3473":77,"3474":111,"3475":118,"3476":89,"3477":98,"3478":66,"3479":71,"3480":81,"3481":43,"3482":71,"3483":85,"3484":104,"3485":81,"3486":118,"3487":113,"3488":47,"3489":116,"3490":82,"3491":111,"3492":75,"3493":74,"3494":121,"3495":121,"3496":112,"3497":68,"3498":97,"3499":72,"3500":112,"3501":48,"3502":88,"3503":113,"3504":76,"3505":88,"3506":54,"3507":67,"3508":78,"3509":85,"3510":113,"3511":73,"3512":72,"3513":99,"3514":121,"3515":76,"3516":99,"3517":51,"3518":105,"3519":122,"3520":90,"3521":105,"3522":105,"3523":99,"3524":88,"3525":106,"3526":69,"3527":88,"3528":109,"3529":79,"3530":107,"3531":103,"3532":87,"3533":75,"3534":80,"3535":111,"3536":79,"3537":80,"3538":84,"3539":53,"3540":75,"3541":56,"3542":111,"3543":98,"3544":103,"3545":81,"3546":53,"3547":113,"3548":120,"3549":116,"3550":84,"3551":114,"3552":84,"3553":53,"3554":65,"3555":102,"3556":104,"3557":116,"3558":109,"3559":110,"3560":88,"3561":116,"3562":120,"3563":55,"3564":114,"3565":89,"3566":115,"3567":43,"3568":85,"3569":47,"3570":113,"3571":74,"3572":43,"3573":116,"3574":114,"3575":76,"3576":66,"3577":51,"3578":90,"3579":68,"3580":120,"3581":110,"3582":47,"3583":122,"3584":121,"3585":111,"3586":52,"3587":115,"3588":74,"3589":103,"3590":103,"3591":90,"3592":53,"3593":65,"3594":65,"3595":65,"3596":65,"3597":65,"3598":66,"3599":74,"3600":82,"3601":85,"3602":53,"3603":69,"3604":114,"3605":107,"3606":74,"3607":103,"3608":103,"3609":103,"3610":61,"3611":61}

Commercial logo of the organization. Max length of 32K, base64 encoded.

organizationId
string [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"

Organization identifier code assigned by the account service institution.

status
string (InstructionStatus) [ 1 .. 35 ] characters
Example: "Queued"

Details about the processing of a request on party reference data (create, update, delete). Possible ISO compliant values are: Rejected, Completed, Queued.

Array of objects (Account)
Array
object

The composite account identifier provides unique account identification when overlaying its parts. [branch-type-subtype-number]

accountBranchId
string [ 1 .. 36 ] characters
Example: "SEA_1"

Identification of the account servicer institution at branch level or operation level.

accountNumber
string <= 30 characters
Example: "012345678"

The account number or Basic Bank Account Number (BBAN). A Basic Bank Account Number (BBAN) is a bank account number that includes the domestic bank code, branch identifier, and account number. It is a unique identifier for a bank account within a specific country.

Array of objects
Array of objects
accountType
required
string (AccountType) [ 1 .. 35 ] characters
Example: "Checking"

Type of the account. Some possible ISO 20022 compliant values are: Checking, CardAccount, CashPayment, Charges, CashIncome, Commission, ClearingParticipantSettlementAccount, LimitedLiquiditySavingsAccount, MarginalLending, MoneyMarket, NonResidentExternal, Overdraft, OverNightDeposit, Settlement, Salary, Savings, Tax, TransactingAccount, CashTrading, VirtualAccount, CreditCard, DebitCard, Universal, Investment, EpurseCard, CertificateOfDeposit, MoneyMarketChecking, RetirementAccount, StockOrBond, PrePaid, FleetCard, Cash, DebitAccount, CreditAccount, Benefit, HealthSavingsAccount, FlexibleSpendingAccount, ForBenefitOf, Estate, ClientTrustAccount, LawyersTrustAccount, KeoghPlanAccount, UniformTransfersToMinorsAct, UniformGiftsToMinorsAct, ReserveFunds, SelfDirectedBrokerage.

ownershipType
required
string (AccountOwnershipType) [ 1 .. 35 ] characters
Example: "SingleOwnerAccount"

Specifies the type of account ownership. Possible ISO 20022 compliant values names are: JointAccountWithSurvivorshipRights, JointAccountInCommon, CustodialAccount, SingleOwnerAccount, JointAccount, Corporation, Business, FormalPartnership, FormalTrust, Nominee, NonProfitOrganization, NotForProfitOrganization, ForProfit, EUResidualEntity, GovernmentOrganization, LimitedLiabilityCompany, RegisteredInvestmentCompany, Entrepreneurial, Unincorporated, LimitedPartnership, LimitedLiabilityPartnership, BareOwner, Usufructuary, Fiduciary, ServicerEmployeeAccount, BusinessTrust, FamilyTrust, Estate.

productId
string (ProductId) [ 1 .. 36 ] characters
Example: "PD_CA_0002"
name
string (AccountName) [ 1 .. 70 ] characters
Example: "Hermes PD_CA 0002"

Name of the account. It provides an additional means of identification, and is designated by the account servicer in agreement with the account owner.

accountPurpose
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
currency
string (CurrencyCode) = 3 characters ^([A-Z]{3})?$
Example: "USD"

Three contiguous letters for the representation of currencies and funds. Valid currency codes are registered with the ISO 4217 Maintenance Agency.

initialAmount
string (AmountInCents) <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: -9999999999999.99999999

depositDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

object (AccountContract)

Account contractual details between the owners and the account servicer.

required
Array of objects (AccountParty)
maturityDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

Array of objects (RelatedAccount)
referenceAccount
string [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"

Account used as a reference for the account opening. Could be used to provide initial funds.

Array of objects (Restriction)
Array of objects (Limit)
object (FinancialStatement)

Specifies financial statement details.

Array of objects (InterestCalculation)
Array of objects (ChargeCalculation)
Array of objects (Tax)
Array of objects (CommunicationChannel)
relationshipId
string [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"

This id gives the ability to view a party’s total relationship with the bank. The relationship Id ties multiple parties and accounts together. This code is also used to reduce mailing costs during marketing campaigns to avoid sending duplicate materials to parties residing at the same address.

Array of objects (GenericAccountCode)

Generic codes to aggregate accounts for similar accounting, processing and integration into the general ledger.

object (AccountPrintOptions)
Array of objects (ServicerAlert)

Account alerts to be received by the account servicer.

object (AccountHistory)

History attribute values.

supplementaryData
object (SupplementaryData)

Additional information that cannot be captured in the structured elements and/or any other specific block. If this information need to be converted in ISO Messages, must be ISO 20022 compliant: it requires development of a compliant message extension model and its components must be registered in the ISO 20022 Data Dictionary. https://www.iso20022.org/catalogue-messages/additional-content-messages/supplementary-data

Array of objects (Balance)
Array of objects (TransactionGroup)
accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: "0dd926fe-1ca2-11ed-861d-0242ac120002"

Identification assigned by the account service institution (Servicer).

Array of objects (RelatedCard)

Payment cards related to the account. Debit cards, for loans or current accounts. Credit cards, for credit card accounts.

Array of objects (StandingOrder)

Instructions given by an account holder to an account servicer to make regular transfers on given dates to the same beneficiary.

object (Audit)

Resource Audit Information. Captures the creation, modification and maintenance details.

required
object (AccountDetailedStatus)

Specifies the current state of an account.

Array of objects (Loan)
Array
object (CompositeAccountIdentifier)

The composite account identifier provides unique account identification when overlaying its parts. [branch-type-subtype-number]

accountBranchId
string (ServicerBranchId) [ 1 .. 36 ] characters
Example: "SEA_1"

Identification of the account servicer institution at branch level or operation level.

accountNumber
string (AccountNumber) <= 30 characters
Example: "012345678"

The account number or Basic Bank Account Number (BBAN). A Basic Bank Account Number (BBAN) is a bank account number that includes the domestic bank code, branch identifier, and account number. It is a unique identifier for a bank account within a specific country.

Array of objects (RoutingNumber)
Array of objects (AccountIdentification)
loanBranchId
string (ServicerBranchId) [ 1 .. 36 ] characters
Example: "SEA_1"

Identification of the account servicer institution at branch level or operation level.

loanType
required
string (LoanType) [ 1 .. 35 ] characters
Example: "Personal"

Type of the account. Some possible BIAN compliant values are: Personal, Consumer,
Corporate, Lease, Syndicated, Mortgage, Conforming, Merchandising, LineOfCredit, RevolvingCredit, LoanAgainstSecurities.

ownershipType
required
string (AccountOwnershipType) [ 1 .. 35 ] characters
Example: "SingleOwnerAccount"

Specifies the type of account ownership. Possible ISO 20022 compliant values names are: JointAccountWithSurvivorshipRights, JointAccountInCommon, CustodialAccount, SingleOwnerAccount, JointAccount, Corporation, Business, FormalPartnership, FormalTrust, Nominee, NonProfitOrganization, NotForProfitOrganization, ForProfit, EUResidualEntity, GovernmentOrganization, LimitedLiabilityCompany, RegisteredInvestmentCompany, Entrepreneurial, Unincorporated, LimitedPartnership, LimitedLiabilityPartnership, BareOwner, Usufructuary, Fiduciary, ServicerEmployeeAccount, BusinessTrust, FamilyTrust, Estate.

productId
string (ProductId) [ 1 .. 36 ] characters
Example: "PD_CA_0002"
name
string (AccountName) [ 1 .. 70 ] characters
Example: "Hermes PD_CA 0002"

Name of the account. It provides an additional means of identification, and is designated by the account servicer in agreement with the account owner.

accountPurpose
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
currency
string (CurrencyCode) = 3 characters ^([A-Z]{3})?$
Example: "USD"

Three contiguous letters for the representation of currencies and funds. Valid currency codes are registered with the ISO 4217 Maintenance Agency.

object (LoanContract)

Contract by which an amount of money in exchange for future repayment of the principal amount along with interest or other finance charges.

required
Array of objects (AccountParty)
Array of objects (RelatedAccount)
Array of objects (Restriction)
Array of objects (Limit)
object (FinancialStatement)

Specifies financial statement details.

supplementaryData
object (SupplementaryData)

Additional information that cannot be captured in the structured elements and/or any other specific block. If this information need to be converted in ISO Messages, must be ISO 20022 compliant: it requires development of a compliant message extension model and its components must be registered in the ISO 20022 Data Dictionary. https://www.iso20022.org/catalogue-messages/additional-content-messages/supplementary-data

status
string (LoanStatus) [ 1 .. 17 ] characters
Example: "Withdrawn"

Specifies the current state of an account. Possible values names are: Pending, Form, Denied, Review, Approve, Withdrawn, Disable, Funded, Deleted

statusDateAndTime
string <date-time> (DateAndTime)
Example: "2022-04-17T08:00:00Z"
substatus
string [ 1 .. 35 ] characters

Status defined by the loan servicer.

openDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

fundedDate
string <date>
Example: "2022-04-17"

Date on which the loan was funded or closed

disbursalDate
string <date>
Example: "2022-04-17"

Date on which loan amount is disbursed.

Array of objects (Balance)
Array of objects (TransactionGroup)
accountId
string (AccountId) [ 1 .. 36 ] characters
Example: "0dd926fe-1ca2-11ed-861d-0242ac120002"

Identification assigned by the account service institution (Servicer).

Array of objects (RelatedCard)

Payment cards related to the account. Debit cards, for loans or current accounts. Credit cards, for credit card accounts.

principalAmount
string <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Amount of money borrowed, or part of that amount which remains unpaid (excluding interest).

accruedCapitalisationAmount
string <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Amount of unpaid interest (on bonds which have defaulted and have subsequently restructured), which is capitalized and added to the original principal amount of the bond.

object (RepaymentSchedule)

An amount that must be paid no sooner than the expected payment date and no later than the due date.

object (Repayment)

An amount that must be paid no sooner than the expected payment date and no later than the due date.

Array of objects (PaymentCard)
Array
fundingSourceType
string (CardFundingSourceType) [ 1 .. 35 ] characters
Example: "Credit"

Specifies the funding source type of payment card. Possible Values: Credit, Debit, Prepaid, Charge, DeferredDebit

productId
required
string (Id) [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"
styleId
string (Id) [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"
businessIndicator
boolean

Indicates whether the payment card is business or not.

digitalIndicator
boolean (DigitalCardIndicator)

Indicates whether the payment card is digital or physical.

cardBranchId
string (Id) [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"
number
required
string (PrimaryAccountNumber) [ 1 .. 19 ] characters
Example: "1234567890123456789"

Primary Account Number (PAN) of the card.

cardHolderType
required
string (CardHolderType) [ 1 .. 35 ] characters
Example: "Primary"

Specifies the card holder type of payment card. Possible Values: Primary, Additional

nameOnCard
string [ 1 .. 350 ] characters
Example: "Jane Birkin"

Specifies the name on the card if overriding the name from the card holder.

businessNameOnCard
string [ 1 .. 350 ] characters
Example: "Jane Birkin"

Specifies the business name on the card.

referenceAccountId
string [ 1 .. 36 ] characters
Example: "0dd926fe-1ca2-11ed-861d-0242ac120002"

Account used as a reference for the card creation. Could be a cash or loan account owned by the primary card holder.

required
Array of objects (RelatedAccount)

Account that provides the payment card transactions. The account is the funding source for the card. Could be a cash or loan account linked to the debit card or a credit card account. A card can have one or many accounts.

startDate
required
string <date>
Example: "2022-04-17"

Year and month the card is available for use.

expiryDate
required
string <= 7 characters ^\d{4}-([0]\d|1[0-2])$
Example: "2022-12"

Year and month the card expires.

orderedDate
string <date>
Example: "2022-04-17"

Date the card is ordered

securityCode
string <= 35 characters
Example: "103"

Security code written on the card, sometimes called card security code (CSC).

pIN
string <= 35 characters
Example: "1031"

PIN is the 4 digit security code that is used to authenticate the user and allow them access to the associated accounts of the card.

pINRetries
number <= 99
Example: 3

Pin Retries Allowed

sequenceNumber
string <= 20 characters
Example: "1"

Identifies a card inside a set of cards with the same number (or PAN).

brand
string <= 35 characters
Example: "Visa"

Brand name of the card.

Array of objects (Limit)
Array of objects (InterestCalculation)
Array of objects (Restriction)
Array of objects (ChargeCalculation)
Array of objects (Algorithm)
supplementaryData
object (SupplementaryData)

Additional information that cannot be captured in the structured elements and/or any other specific block. If this information need to be converted in ISO Messages, must be ISO 20022 compliant: it requires development of a compliant message extension model and its components must be registered in the ISO 20022 Data Dictionary. https://www.iso20022.org/catalogue-messages/additional-content-messages/supplementary-data

cardId
string (PaymentCardId) [ 1 .. 36 ] characters
Example: "0dd926fe-1ca2-11ed-861d-0242ac120002"

Identification assigned by the card provider. A cardId is a unique identifier associated with a specific cardholder. Establishing the card ID is the first step. The card ID is used as the card reference. When a card is replaced, a new card ID must be requested for the new PAN.

cardHolderId
required
string [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"

Card holder person identifier

object (CreditCardStatement)

Credit Card statement details.

Array of objects (CardProviderOffer)

Card provider offers assigned to the PAN.

status
string (CardStatus) [ 1 .. 60 ] characters
Example: "Active"

Specifies the status of payment card. Some possible values are: AssignPIN, Active, Blocked, Closed, Expedite, Expired, HotCarded, Renewed, Inactive, Issued, Lost, Restricted, Stolen, Suspended.

statusDate
string <date-time> (DateAndTime)
Example: "2022-04-17T08:00:00Z"
statusReason
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
object (PaymentCardHistory)
Array of objects (ServicerAlert)

Customer alerts to be received by the account servicer.

object (Audit)

Resource Audit Information. Captures the creation, modification and maintenance details.

status
string (AuditStatus) [ 1 .. 35 ] characters

Maintenance status of a resource. Possible values: Requested, Created, Changed, Deleted

creationDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

lastModificacionChannel
string (CommunicationChannelName) [ 1 .. 35 ] characters
Example: "Email"

Channel used to communicate with a party. Possible Values: Email, Fax, File, Online, PostalService, LiveSupport, ATM, IVR, Kiosk, Mobile, OnlineBanking, Phone, SMS, Card, InPerson.

lastModificationDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

Array of objects (AuditChannel)

Activity audit throught comunication channles

Array
lastActivityDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

name
string (CommunicationChannelName) [ 1 .. 35 ] characters
Example: "Email"

Channel used to communicate with a party. Possible Values: Email, Fax, File, Online, PostalService, LiveSupport, ATM, IVR, Kiosk, Mobile, OnlineBanking, Phone, SMS, Card, InPerson.

activityType
string (AuditActivityType) [ 1 .. 35 ] characters

Maintenance activity of a resource. Possible values: Transaction, Modification, Deposit, Withdrawal.

amount
string (PositiveAmountInCents) <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: 0

Responses

Request samples

Content type
application/json
{
  • "relatedPersons": {
    },
  • "organizations": {
    },
  • "accounts": [
    ],
  • "loans": [
    ],
  • "cards": [
    ],
  • "audit": {
    }
}

Response samples

Content type
application/json
{
  • "relatedPersons": {
    },
  • "organizations": {
    },
  • "accounts": [
    ],
  • "loans": [
    ],
  • "cards": [
    ],
  • "audit": {
    },
  • "relationshipId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "status": "Active"
}

Retrieves a Relationship

Authorizations:
jwtopenIdConnect
path Parameters
relationshipId
required
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Relationship Identification

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Responses

Response samples

Content type
application/json
{
  • "relatedPersons": {
    },
  • "organizations": {
    },
  • "accounts": [
    ],
  • "loans": [
    ],
  • "cards": [
    ],
  • "audit": {
    },
  • "relationshipId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "status": "Active"
}

Updates a Relationship

Use the JSON Merge Patch standard https://tools.ietf.org/html/rfc7396

Authorizations:
jwtopenIdConnect
path Parameters
relationshipId
required
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Relationship Identification

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Request Body schema: application/merge-patch+json
uSDocumentedIndicator
boolean
Array of objects (PersonIdentification)
Array
number
required
string [ 1 .. 35 ] characters
Example: "123-45-6789"

Unique and unambiguous identification of a person.

schemeName
required
string [ 1 .. 35 ] characters
Example: "SocialSecurityNumber"

Name of the identification scheme in PascalCase form. Possible values are: AlienRegistrationNumber, PassportNumber, CustomerIdentificationNumber, DriversLicenseNumber, EmployeeIdentificationNumber, NationalIdentityNumber, SocialSecurityNumber, TelephoneNumber, TaxIdentificationNumber, PersonCommercialIdentification, StateIdentificationNumber, MilitaryIdCard, BirthMarriageCertificateNumber, MarriageCertificateNumber, BirthCertificateNumber, CountryTerritoriIdCard, DriverLicenseNumber, WageTaxStatementFormNumber, GovernmentDocumentNumber, HealthInsuranceCard, CertificateOfIncorporationNumber, CertificateOfOrganizationNumber, CertificateOfPartnershipNumber, ForwardHealthMedicaIdCard, MexicanConsularIdCard, DLNTaxExemptNumber, PhotoIdCard, PermantResidentCard, TribalIdCard, UtilityBillInvoiceNumber, VoterUniqueIdentifier, WisconsinCRISSearch, PropertyTaxBillNumber, MedicareCardId, OrganizationalDocumentNumber, CertificationOfTrustNumber, EstateDomiciliaryLetterNumber, TaxReturnFormNumber, MinorIdCard, EmploymentAuthorizationCard, StateDocumentNumber, TravelDocumentNumber, StateIssuedPermitNumber

issuer
string
Example: "Baltimore"

Entity that assigns the identification.

issueDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

expirationDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

foreingIDIndicator
boolean

Indicates whether the identifications is from a foreing country.

name
string (PartyName) [ 1 .. 350 ] characters
Example: "Jane Birkin"

Name by which a party is known and which is usually used to identify that party.

shortName
string (PartyShortName) [ 1 .. 35 ] characters
Example: "Jane"

Short name or nickname by which a party is known and which is usually used to identify that party.

nameTemplateId
string (NameTemplateId) [ 1 .. 36 ] characters
Example: "1"

Template used to display the party name. This is an external id provided by the account servicer.

nameSoundExId
string (SoundExId) [ 1 .. 36 ] characters
Example: "1"

Identification of a SoundEx method develop for search attribute. SoundEx is a method used to find strings when the sound is known but the precise spelling is not. It searches out words with similar sounds based on phonetic assumptions about how certain letters are pronounced. It can be used to search names in a database, for example, where spellings and pronunciations for similar names may vary.

partyBranchId
string (ServicerBranchId) [ 1 .. 36 ] characters
Example: "SEA_1"

Identification of the account servicer institution at branch level or operation level.

comment
string [ 1 .. 1025 ] characters
Example: "This is a description."

Bank commnent of the party.

Array of objects (RelatedParty)
Array
partyId
required
string (Id) [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"
partyType
required
string (PartyType)
Example: "Person"

Possible values are: Person, Organization. Also other types of servicer internal entities: ServicerOfficer

partyName
string (PartyName) [ 1 .. 350 ] characters
Example: "Jane Birkin"

Name by which a party is known and which is usually used to identify that party.

partyRelationType
required
string (PartyRelationType) [ 1 .. 40 ] characters
Example: "PrimaryServicerOfficer"

Type of relation between parties. Possible values Between Organizations and persons are: ResponsibleParty, OrganizationOwner, ControlPerson, BeneficialOwner, PrimaryContact, SecondaryContact. For Trusts: Trustor, Trustee. Between organizations: ParentOrganization, Branch. Between parties and external entities: AccountOpenningOfficer, CustomerServiceOfficer, PrimaryServicerOfficer, SecondaryServicerOfficer, SalesPerson, ReferralOfficer. Between financial institutions: AffiliateFinancialInstitution, HoldingCompany. Between persons: Spouse.

partyRelationDescription
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
ownershipPercentage
string <= 23 characters ^100|(([1-9][0-9]{0,1})([.][0-9]{0,8}){0,1})$...
Example: "25"

Company Ownership Percentage. If the relation Type is BeneficialOwner the ownership percentage could be added. Ownership means any person with more than 25% equity in the legal entity.

Array of objects (PostalAddress)
Array
addressType
string
Example: "Postal"

Specifies the type of address, in PascalCase form. Possible ISO Compliant values are: PhysicalAddress, Postal, POBox, Residential, Permanent, Temporary, Business.

addressPurpose
string
Example: "Billing"

Specifies the purpose of an address, in PascalCase form. Possible ISO Compliant values are: MailTo, DeliveryTo, Billing, PlaceOfOperation, PlaceOfRegistration

primaryIndicator
boolean (PrimaryContactIndicator)

Indicates whether the contact informacion is primary.

department
string [ 1 .. 70 ] characters
Example: "A"

Identification of a division of a large Organization or building.

subDepartment
string [ 1 .. 70 ] characters
Example: "B"

Identification of a sub-division of a large Organization or building.

streetName
string [ 1 .. 70 ] characters
Example: "First Street"

Name of a street or thoroughfare.

firstCrossStreetName
string [ 1 .. 70 ] characters

Name of a the first cross street.

secondCrossStreetName
string [ 1 .. 70 ] characters
Example: "Second Street"

Name of a the second cross street.

buildingNumber
string [ 1 .. 16 ] characters
Example: "11407"

Number that identifies the position of a building or house on a street.

buildingName
string [ 1 .. 35 ] characters
Example: "Tall Tower"

Name of the building or house.

floor
string [ 1 .. 70 ] characters
Example: "20"

Floor or storey within a building.

postBox
string [ 1 .. 16 ] characters
Example: "MY779"

Numbered box in a post office, assigned to a person or Organization, where letters are kept until called for.

room
string [ 1 .. 70 ] characters
Example: "22"

Building room number.

postCode
string (PostCode) [ 1 .. 16 ] characters
Example: "97062-68"

Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.

censusTrack
string (CensusTrack) = 5 characters
Example: "04013216813"

A census tract, census area, census district or meshblock is a geographic region defined for the purpose of taking a census

cBSACode
string (CBSACode) = 5 characters
Example: "49780"

Core-based statistical area. Metropolitan statistical area (MSA) is the formal definition of a region that consists of a city and surrounding communities that are linked by social and economic factors. Micropolitan Statistical Areas (MISA) are CBSAs associated with at least one urban cluster that has a population of at least 10,000, but less than 50,000. The micropolitan statistical area comprises the central county or counties or equivalent entities containing the core, plus adjacent outlying counties having a high degree of social and economic integration with the central county as measured through commuting.

cBSAType
string (CBSAType) [ 1 .. 10 ] characters
Example: "MSA"

Type of Core-based statistical area. Possible values: MSA, MISA

foreignIndicator
boolean

Indicates whether the postal address is from a foreing country.

townName
string (TownName) [ 1 .. 35 ] characters
Example: "Tualatin"

Name of a built-up area, with defined boundaries, and a local government.

townLocationName
string [ 1 .. 35 ] characters
Example: "Clackamas"

Specific location name within the town.

districtName
string [ 1 .. 35 ] characters
Example: "Washington"

Identifies a subdivision within a country sub-division.

countrySubDivision
string (CountrySubdivision) [ 1 .. 35 ] characters
Example: "Oregon"

Name of a country subdivision such as state, region, county.

countrySubDivisionCode
string (CountrySubdivisionCode) ^[A-Z]{2,2}\-[0-9A-Z]{1,3}
Example: "AR-B"

Code to identify a name of a unit resulting from the division of a country, dependency, or other area of special geopolitical interest contained in ISO 3166-1, on the basis of country names obtained from the United Nations (ISO 3166-2: Country subdivision code).

country
string (CountryCode) ^([A-Z]{2,2})?$
Example: "US"

Country name obtained from the United Nations (ISO 3166, Alpha-2 code).

addressLine
Array of strings[ items [ 1 .. 70 ] characters ]
Example: ["11407 Sw Amu st, Suite MY777"]

Information that locates and identifies a specific address, as defined by postal services, presented in free format text.

object

The period of use of the address information.

relationshipId
string [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"

This id gives the ability to view a party’s total relationship with the bank. The relationship Id ties multiple parties together. This code is also used to reduce mailing costs during marketing campaigns to avoid sending duplicate materials to parties residing at the same address.

relationshipLeadIndicator
boolean

The relationship lead is often the primary account owner or the party with whom the bank have the most contact.

residenceType
string [ 1 .. 35 ] characters
Example: "Domestic"

Specifies the type of residence where the party has its permanent home or principal establishment. Possible ISO Complaian values are: Domestic, Foreign, Mixed

object (TaxPartyInformation)

Taxation parameters which apply to an individual person or to an organization.

tIN
string
Example: "778-62-8144"

A Taxpayer Identification Number

taxIdType
string [ 1 .. 50 ] characters
Example: "SocialSecurityNumber"

Identifies what type of tax ID is in the TIN field. Possible Values: SocialSecurityNumber, EmployerIdentificationNumber, IndividualTaxpayerIdentificationNumber, AdoptionTaxpayerIdentificationNumber, PreparerTaxpayerIdentificationNumber, ForeignTaxID

financialReportingIndicator
boolean

Whether the financial income for this party should be reported to the U.S. government (IRS) when related to an account in a way which requires reporting (for example, primary, joint ownership). Defaults to true if not specified.

tINStatus
string
Example: "Valid"

'The tax ID has been verified by the IRS. Possible values: Valid, NotValid, NotVerified, IRSWarning, TINApplied.

object (TINVerification)

IRS information about the TIN provided.

verificationAttemps
integer <= 10
Example: 1

The Tax Identification Verification Attempts is the number of times attempts have been made to verify the tax ID number.

bNoticeDates
Array of strings <date> (Date)
Example: ["2022-04-17"]
tINResultCode
string <= 3

TIN matching result codes

taxStatus
string
Example: "Valid"

Exempt, Retain, ExemptExpired, VoluntaryWithholding, Chapter3, Chapter4, C-Corp, S-Corp.

Array of objects (TaxForm)

Forms applied by the party

Array
formName
required
string [ 1 .. 10 ] characters
Example: "W-8"

Form name requested. Possible Values: W-8BEN, W-8BEN-E, W-8ECI, W-8EXP, W-8IMY, W-9, W-8, 1042-S, 1099-INT, 1099-OID.

taxRate
string <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Indicates the tax rate provided by the IRS on the form.

Array of objects (TaxFormCode)

Codes provided by the IRS on the form.

recipientGIIN
string (GIIN) [ 1 .. 34 ] characters ^([A-N,P-Z,0-9]){6}\.([A-N,P-Z,0-9]){5}\.(LE|...
Example: "ADN123.FG4FE3.LE.999"

Global intermediary identification number (GIIN).

recipientPostCode
string (PostCode) [ 1 .. 16 ] characters
Example: "97062-68"

Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.

recipientTownName
string (TownName) [ 1 .. 35 ] characters
Example: "Tualatin"

Name of a built-up area, with defined boundaries, and a local government.

certificationDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

expirationDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

Array of objects (TaxRegulation)
Array
name
required
string [ 1 .. 35 ] characters
Example: "Chapter4"
section
string [ 1 .. 10 ] characters
Example: "1471"

String that represent the section number.

Array of objects (WithholdingTax)
Array
withholdingTaxType
required
string (WithholdingTaxType) [ 1 .. 35 ] characters
Example: "NonResidentAlienTax"

Type of Withholding. Possible Values: ForeignAccountTaxComplianceAct, NonResidentAlienTax, BackUpWithholding, VoluntaryWithholding, Federal, State, Local, W-4.

withholdingRate
string <= 23 characters ^100|(([1-9][0-9]{0,1})([.][0-9]{0,8}){0,1})$...
Example: "25"

Rate applied on a basis amount to calculate the withholding.

withholdingAmount
string <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Withholding amount.

foreignIndicator
boolean

Indicates whether the party is a non-residen alien or a foreign entity.

countrySubDivision
string (CountrySubdivision) [ 1 .. 35 ] characters
Example: "Oregon"

Name of a country subdivision such as state, region, county.

countrySubDivisionCode
string (CountrySubdivisionCode) ^[A-Z]{2,2}\-[0-9A-Z]{1,3}
Example: "AR-B"

Code to identify a name of a unit resulting from the division of a country, dependency, or other area of special geopolitical interest contained in ISO 3166-1, on the basis of country names obtained from the United Nations (ISO 3166-2: Country subdivision code).

country
string (CountryCode) ^([A-Z]{2,2})?$
Example: "US"

Country name obtained from the United Nations (ISO 3166, Alpha-2 code).

supplementaryData
object (SupplementaryData)

Additional information that cannot be captured in the structured elements and/or any other specific block. If this information need to be converted in ISO Messages, must be ISO 20022 compliant: it requires development of a compliant message extension model and its components must be registered in the ISO 20022 Data Dictionary. https://www.iso20022.org/catalogue-messages/additional-content-messages/supplementary-data

object (PowerOfAttorney)

Document that transfers specific rights from a party to a person.

documentId
string (Id) [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"
documentReference
string [ 1 .. 35 ] characters

Document location.

version
string [ 1 .. 18 ] characters

Document version indentification.

signOffDate
string <date>
Example: "2022-04-17"

Signoff date of the document.

issueDate
string <date>
Example: "2022-04-17"

Issue date of the document.

purpose
string [ 1 .. 35 ] characters

Specifies the function of the document.

fromDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period starts.

upToDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period ends.

periodNumber
integer

Sequence number of the period.

object (Jurisdiction)

Area with a set of laws under the control of a system which are different from neighbouring areas

countrySubdivision
string (CountrySubdivision) [ 1 .. 35 ] characters
Example: "Oregon"

Name of a country subdivision such as state, region, county.

townName
string (TownName) [ 1 .. 35 ] characters
Example: "Tualatin"

Name of a built-up area, with defined boundaries, and a local government.

country
string (CountryCode) ^([A-Z]{2,2})?$
Example: "US"

Country name obtained from the United Nations (ISO 3166, Alpha-2 code).

authorizedPerson
string [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"

Person which is the holder of the power of attorney.

authorizedAccount
string [ 1 .. 36 ] characters
Example: "0dd926fe-1ca2-11ed-861d-0242ac120002"

Specifies the account on which the power of attorney applies.

supplementaryData
object (SupplementaryData)

Additional information that cannot be captured in the structured elements and/or any other specific block. If this information need to be converted in ISO Messages, must be ISO 20022 compliant: it requires development of a compliant message extension model and its components must be registered in the ISO 20022 Data Dictionary. https://www.iso20022.org/catalogue-messages/additional-content-messages/supplementary-data

excludeMarketingIndicator
boolean
object (Audit)

Resource Audit Information. Captures the creation, modification and maintenance details.

status
string (AuditStatus) [ 1 .. 35 ] characters

Maintenance status of a resource. Possible values: Requested, Created, Changed, Deleted

creationDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

lastModificacionChannel
string (CommunicationChannelName) [ 1 .. 35 ] characters
Example: "Email"

Channel used to communicate with a party. Possible Values: Email, Fax, File, Online, PostalService, LiveSupport, ATM, IVR, Kiosk, Mobile, OnlineBanking, Phone, SMS, Card, InPerson.

lastModificationDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

Array of objects (AuditChannel)

Activity audit throught comunication channles

Array
lastActivityDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

name
string (CommunicationChannelName) [ 1 .. 35 ] characters
Example: "Email"

Channel used to communicate with a party. Possible Values: Email, Fax, File, Online, PostalService, LiveSupport, ATM, IVR, Kiosk, Mobile, OnlineBanking, Phone, SMS, Card, InPerson.

activityType
string (AuditActivityType) [ 1 .. 35 ] characters

Maintenance activity of a resource. Possible values: Transaction, Modification, Deposit, Withdrawal.

amount
string (PositiveAmountInCents) <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: 0

Array of objects (Restriction)

Access and operation restrictions at Party level.

Array
name
required
string [ 1 .. 60 ] characters
Example: "WireTransferIn"

Name of the restriction in PascalCase. Possible values: WireTransferIn, WireTransferOut, ForeignIncomingWires, ForeignOutgoingWires, ACHTransfers, InternetBankingTransfer, InternetView, InternetInquiry, ForeignOutgoingIran, Withdrawals, Renew, Transfers

restrictionPurpose
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
enableIndicator
boolean
Example: true

Indicates whether the capability is allowed or not.

validFrom
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

validUntil
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

object (PlaceAndDateOfBirth)

Date and place of birth of a person.

countrySubdivision
string (CountrySubdivision) [ 1 .. 35 ] characters
Example: "Oregon"

Name of a country subdivision such as state, region, county.

townName
string (TownName) [ 1 .. 35 ] characters
Example: "Tualatin"

Name of a built-up area, with defined boundaries, and a local government.

country
string (CountryCode) ^([A-Z]{2,2})?$
Example: "US"

Country name obtained from the United Nations (ISO 3166, Alpha-2 code).

birthDate
string <date>
Example: "2022-04-17"

Date on which a person is born.

signature
string <byte> (DigitalSignature) [ 1 .. 13654 ] characters
Example: {"0":83,"1":109,"2":70,"3":117,"4":90,"5":83,"6":66,"7":67,"8":97,"9":88,"10":74,"11":114,"12":97,"13":87,"14":52,"15":61}

Binary data of 10K maximum, base64 encoded.

signatureVerificationId
string (SignatureVerificationId) [ 1 .. 36 ] characters
Example: "0dd926fe-1ca2-11ed-861d-0242ac120002"

This field contains the key of the CISA validation record.

object (PersonContactDetails)

Specifies the contact details of a person.

object (StructuredName)

The structured name is used to initialize the person name with the format

firstName
required
string [ 1 .. 200 ] characters
Example: "Mary"

Person given first name.

middleName
string [ 1 .. 200 ] characters
Example: "Joe"

Person given middle name.

lastName
required
string [ 1 .. 200 ] characters
Example: "Smith"

Person surname.

suffix
string [ 1 .. 20 ] characters
Example: "PhD"

A name suffix in the Western English-Language naming tradition, follows a person's full name and provides additional information about the person. Possible Values: PhD, Snr, Jnr. Generation order should be expressed with roman numerals: I, II, III, IV, V.

prefix
string [ 1 .. 20 ] characters
Example: "Dr."

Name prefixes are typically Dr., Mr., Mrs., Ms.

name
string [ 1 .. 350 ] characters
Example: "Jane Birkin"

Preferred name to contact the person

Array of objects (Phone)
Array
number
required
string (PhoneNumber) ^\+[0-9]{1,3}-[0-9()+\-]{1,30}$
Example: "+1-415-731359"

The collection of information which identifies a specific phone or FAX number as defined by telecom services.

extension
string <= 5 characters

Phone Number Extension.

phoneType
string [ 1 .. 35 ] characters

Type of phone address. Possible values are:
Mobile, Landline, Fax, Pager, Modem

phonePurpose
string [ 1 .. 35 ] characters

Purpose of the phone address. Possible values are: Business, Personal, International.

primaryIndicator
boolean (PrimaryContactIndicator)

Indicates whether the contact informacion is primary.

object (HourOfTheDay)
comment
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
object

The period of use of the phone information.

Array of objects (Email)
Array
emailAddress
string [ 1 .. 2048 ] characters

Address for electronic mail (e-mail).

emailPurpose
string [ 1 .. 35 ] characters
Example: "Statements"

Purpose of the e-mail address. Possible values: Marketing, Statements, Business, Administrative

primaryIndicator
boolean (PrimaryContactIndicator)

Indicates whether the contact informacion is primary.

jobTitle
string (JobTitle) [ 1 .. 35 ] characters
Example: "Head of Documentation"

Title of the function in an organization.

department
string [ 1 .. 35 ] characters
Example: "Sales"

Identification of a division of a large Organization or building.

Array of objects (CommunicationChannel)
Array
channel
string (CommunicationChannelName) [ 1 .. 35 ] characters
Example: "Email"

Channel used to communicate with a party. Possible Values: Email, Fax, File, Online, PostalService, LiveSupport, ATM, IVR, Kiosk, Mobile, OnlineBanking, Phone, SMS, Card, InPerson.

channelIdentification
string (CommunicationChannelIdentification) [ 1 .. 128 ] characters
Example: "011-02010020202"

Communication value such as phone number or email address.

channelPurpose
string (CommunicationChannelPurpose) [ 1 .. 40 ] characters
Example: "Alert"

Communication purpose of the channel. Possible values: Alerts, PrivacyNotices

codeWord
string

A party is asked for a codeword to verify their identity trought a communication channel

alertIndicator
any

Indicates whether the channel is used for enterprise alerts

object (CommunicationChannelHistory)
primaryIndicator
boolean (PrimaryContactIndicator)

Indicates whether the contact informacion is primary.

preferredMethod
string (CommunicationChannelName) [ 1 .. 35 ] characters
Example: "Email"

Channel used to communicate with a party. Possible Values: Email, Fax, File, Online, PostalService, LiveSupport, ATM, IVR, Kiosk, Mobile, OnlineBanking, Phone, SMS, Card, InPerson.

preferredLanguage
string (PreferredLanguage) [ 1 .. 35 ] characters
Example: "English"

Language of the contact person. Names according to the language list provided in the ISO 639-1 codes. Some possible values: Chinese, Spanish, French, English, Japanese, Italian, German.

headOfHousehold
boolean
Example: true

Indicates whether the person pay the costs of supporting a house.

civilStatus
string (CivilStatus) [ 1 .. 17 ] characters
Example: "Single"

Specifies the civil status of a person. Possible ISO 20022 compliant values names are: Single, Married, LegallyDivorced, Divorced, Widowed, StableUnion

object (StructuredName)

The structured name is used to initialize the person name with the format

firstName
required
string [ 1 .. 200 ] characters
Example: "Mary"

Person given first name.

middleName
string [ 1 .. 200 ] characters
Example: "Joe"

Person given middle name.

lastName
required
string [ 1 .. 200 ] characters
Example: "Smith"

Person surname.

suffix
string [ 1 .. 20 ] characters
Example: "PhD"

A name suffix in the Western English-Language naming tradition, follows a person's full name and provides additional information about the person. Possible Values: PhD, Snr, Jnr. Generation order should be expressed with roman numerals: I, II, III, IV, V.

prefix
string [ 1 .. 20 ] characters
Example: "Dr."

Name prefixes are typically Dr., Mr., Mrs., Ms.

gender
string (Gender) [ 1 .. 36 ] characters
Example: "Female"

Specifies the gender of the person. Possible Values: Female, Male, NonBinary

race
string (Race) [ 1 .. 35 ] characters
Example: "Director"

Categorization of humans based on shared physical qualities. Possible Values: NativeAmerican, African, Hispanic, White, Asian

profession
string (Profession) <= 35 characters
Example: "Artist"

Professional Designation or name of the occupation of a person.

jobTitle
string (JobTitle) [ 1 .. 35 ] characters
Example: "Head of Documentation"

Title of the function in an organization.

residentialStatus
string (ResidentialStatus) [ 1 .. 35 ] characters
Example: "Permanent"

Residential status of an individual. Possible values: Permanent, Resident, NonResident, Rents, Owns

minorIndicator
boolean (MinorIndicator)

Indicates whether the person is a legal minor.

Array of objects (Citizenship)
Array
fromDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period starts.

upToDateTime
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time at which the contract validity period ends.

periodNumber
integer

Sequence number of the period.

country
string (CountryCode) ^([A-Z]{2,2})?$
Example: "US"

Country name obtained from the United Nations (ISO 3166, Alpha-2 code).

countryOfResidence
string (CountryCode) ^([A-Z]{2,2})?$
Example: "US"

Country name obtained from the United Nations (ISO 3166, Alpha-2 code).

object (PersonProfile)

Information to support Know Your Customer (KYC) processes.

riskLevel
string (RiskLevel) [ 1 .. 35 ] characters
Example: "Permanent"

Specifies the customer’s money laundering risk. Possible values: High, Medium, Low, None.

bSARiskCode
integer (BSARiskCode) <= 10
Example: 0

Used to identify customers that present a risk to the bank as defined by the Bank Secrecy Act. For example, use this code to identify and monitor accounts suspected of fraud, kiting or money laundering.

object (CreditReview)

A credit review is a periodic assessment of an individual’s or businesses' credit profile.

object (Frequency)

Specifies an event frequency

lastReviewDate
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time if the last credit review.

nextReviewDate
string <date-time>
Example: "2022-04-17T08:00:00Z"

Date and time if the next credit review.

creditQuality
string (CreditQuality) [ 1 .. 35 ] characters
Example: "UpperMediumGrade"

Credit quality rating of an issuer or financial obligation. Possible Values: DefaultImminent, ExtremelySpeculative, HighGrade, HighlySpeculative, InDefault, LowerMediumGrade, NonInvestmentGradeSpeculative, Prime, SubstantialRisk, UpperMediumGrade

creditScore
integer
creditBureauReportCode
string

Code used for reporting to the credit bureaus. This code is used to report the trade line of a credit account to the credit bureau agencies.

oFACReportingIndicator
boolean

Indicates whether the party is to be excluded from OFAC Reporting.

previousFinancialInstitution
string (PartyName) [ 1 .. 350 ] characters
Example: "Jane Birkin"

Name by which a party is known and which is usually used to identify that party.

referredByWhom
string [ 1 .. 350 ] characters
Example: "Jane Birkin"

Name by which a party is known and which is usually used to identify that party.

moneyLaunderingCheck
string (MoneyLaunderingCheck)
Example: "AuthorizedCredit"

Specifies the status of money laundering identification procedures. Possible Values: PassedNotChecked, ExemptBelowLimit, ClientMoneyTypeExempt, AuthorizedCredit, PostalOrElectronicPaymentExempt

knowYourCustomerCheck
string (KnowYourCustomerCheckType) [ 1 .. 36 ] characters
Example: "Ordinary"

Specifies the type of Know Your Customer (KYC) or anti-money laundering due diligence to which the investor has been subjected. Possible Values: Ordinary, Simple, Enhanced.

object (TemporalDuration)

Describes a temporal duration.

unit
required
string [ 1 .. 36 ] characters
Example: "Months"

Unit that describes the duration.

value
required
integer <= 999

Value of the duration in number of units.

dateAtCurrentAddress
string <date>
Example: "2022-04-17"

Date of Residence in the current household.

sourceOfWealth
string [ 1 .. 1025 ] characters
Example: "This is a description."

Indicates the main sources of the money.

politicalAffiliation
string

Indicates the political affiliation of the Party. Possible values could be: Democrat, Independent, Republican.

lostCustomerDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

lostCustomerReason
string (LostCustomerReason) [ 1 .. 35 ] characters
Example: "Deceased"

Used for regulatory purposes by the bank to track how long closed account history has been maintained for a customer. Possible values are: Competition, Deceased, Dissatisfied, Moved, MergedEntity, CeasedOperation

Array of objects (ServicerAlert)

Customer alerts to be received by the account servicer.

Array
alertName
string (AlertName) [ 1 .. 35 ] characters
Example: "CreditBureauAlert"

An alert notification received by the bank. Possible values: CreditBureauAlert, CustomerAlert, PaymentCard

alertType
string (AlertType) [ 1 .. 35 ] characters
Example: "Warning"

An alert notification type. Possible values: Warning, Urgent.

alertCode
string [ 1 .. 36 ] characters
message
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
lastAlertDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

object (CustomerIdentificationProgram)

CIP requires that financial firms must obtain four pieces of identifying information about a client.

certificateDocument
Array of strings (CertificateDocumentName) [ items [ 1 .. 60 ] characters ]
Example: ["IdentityCard"]

Documents used to certify the customer identity

certificationStatus
string (CertificationStatus) [ 1 .. 60 ] characters
Example: "CertifiedLevel1"

Customer Identification Program (CIP) status. Designates the type of verification used for Customer Identification. This status could be obtained from a specific software the bank is using. Possible Values: NotCertified, CertifiedLevel1, CertifiedLevel2, CertifiedLevel3, FraudCheckOnly, Level1Check, Level2FraudCheck.

certificationDate
string <date-time> (DateAndTime)
Example: "2022-04-17T08:00:00Z"
object (Frequency)

Specifies an event frequency

customerConductClassification
string (CustomerConductClassification) [ 1 .. 35 ] characters

Assessment of the customer’s behaviour at the time of the account opening application. Possible Values: Standard, NonStandard, Reluctant.

familyMedicalInsuranceIndicator
boolean
Example: true

Indicates if the person has family medical insurance coverage available.

object (AmountRange)

Range an amount

minAmount
string (PositiveAmountInCents) <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: 0

maxAmount
string (PositiveAmountInCents) <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: 0

residenceValue
string (PositiveAmountInCents) <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: 0

residenceMortage
string (PartyName) [ 1 .. 350 ] characters
Example: "Jane Birkin"

Name by which a party is known and which is usually used to identify that party.

employmentStatus
string (EmploymentStatus)

Represents available individual employment status. Possible Values: Contract, Employed, Homemaker, Retired, SelfEmployed, Student, Temporary, Unemployed.

vIPStatus
string (VIPStatus)
Example: "Elite"

Very Important People Program Status. Possible Values: Novice, Pro, Elite

Array of objects (Employment)
Array
employingPartyName
string (PartyName) [ 1 .. 350 ] characters
Example: "Jane Birkin"

Name by which a party is known and which is usually used to identify that party.

jobTitle
string (JobTitle) [ 1 .. 35 ] characters
Example: "Head of Documentation"

Title of the function in an organization.

employeeTerminationIndicator
boolean
Example: false
object (TemporalDuration)

Describes a temporal duration.

endDate
string <date> (Date)
Example: "2022-04-17"

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

object (Place)

Town, CountrySubdivision and Country .

object (ServicerMember)

The servicer member information is used to provide info to Regulation 0. The Regulation 0 is a Federal Reserve regulation that places limits and stipulations on the credit extensions a member bank can offer to its executive officers, principal shareholders, and directors.

insider
string (InsiderType) [ 1 .. 35 ] characters
Example: "Director"

Director, Employee, Officer, PrincipalShareholder, Shareholder, Executive.

familyRelationship
string [ 1 .. 40 ] characters
Example: "PrimaryServicerOfficer"

Insider familiar relation. Child, Spouse, Parent, Relative

institutionRelationship
string [ 1 .. 40 ] characters
Example: "PrimaryServicerOfficer"

Relation with the insider financial institution. Possible Values: AffiliateFinancialInstitution, HoldingCompany.

anualIncome
string (PositiveAmountInCents) <= 23 characters ^([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: 0

yearsOfEducation
integer
politicallyExposedPerson
boolean
Example: true

Indicates if the person is a politically exposed person (PEP). Is one who has been entrusted with a prominent public function. A PEP generally presents a higher risk for potential involvement in bribery and corruption.

privacyNoticedIndicator
boolean
Example: true

Indicates whether the person allow distributing personal information to third parties.

identityTheftServiceIndicator
boolean
Example: true

Indicates whether the person has subscribed to an Identity Theft service.

Array of objects (IdentityQuestion)
Array
question
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
answer
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
personId
required
string [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"

Person identifier code assigned by the account service institution.

status
string (InstructionStatus) [ 1 .. 35 ] characters
Example: "Queued"

Details about the processing of a request on party reference data (create, update, delete). Possible ISO compliant values are: Rejected, Completed, Queued.

Responses

Request samples

Content type
application/merge-patch+json
{
  • "uSDocumentedIndicator": true,
  • "identifiers": [
    ],
  • "name": "Jane Birkin",
  • "shortName": "Jane",
  • "nameTemplateId": "1",
  • "nameSoundExId": "1",
  • "partyBranchId": "SEA_1",
  • "comment": "This is a description.",
  • "relatedParties": [
    ],
  • "postalAddresses": [
    ],
  • "relationshipId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "relationshipLeadIndicator": true,
  • "residenceType": "Domestic",
  • "taxInformation": {
    },
  • "powerOfAttorney": {
    },
  • "supplementaryData": { },
  • "excludeMarketingIndicator": true,
  • "audit": {
    },
  • "restrictions": [
    ],
  • "placeAndDateOfBirth": {
    },
  • "signature": {
    },
  • "signatureVerificationId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "contact": {
    },
  • "headOfHousehold": true,
  • "civilStatus": "Single",
  • "structuredName": {
    },
  • "gender": "Female",
  • "race": "Director",
  • "profession": "Artist",
  • "jobTitle": "Head of Documentation",
  • "residentialStatus": "Permanent",
  • "minorIndicator": true,
  • "citizenships": [
    ],
  • "countryOfResidence": "US",
  • "profile": {
    },
  • "personId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "status": "Queued"
}

Response samples

Content type
application/json
{
  • "uSDocumentedIndicator": true,
  • "identifiers": [
    ],
  • "name": "Jane Birkin",
  • "shortName": "Jane",
  • "nameTemplateId": "1",
  • "nameSoundExId": "1",
  • "partyBranchId": "SEA_1",
  • "comment": "This is a description.",
  • "relatedParties": [
    ],
  • "postalAddresses": [
    ],
  • "relationshipId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "relationshipLeadIndicator": true,
  • "residenceType": "Domestic",
  • "taxInformation": {
    },
  • "powerOfAttorney": {
    },
  • "supplementaryData": { },
  • "excludeMarketingIndicator": true,
  • "audit": {
    },
  • "restrictions": [
    ],
  • "placeAndDateOfBirth": {
    },
  • "signature": {
    },
  • "signatureVerificationId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "contact": {
    },
  • "headOfHousehold": true,
  • "civilStatus": "Single",
  • "structuredName": {
    },
  • "gender": "Female",
  • "race": "Director",
  • "profession": "Artist",
  • "jobTitle": "Head of Documentation",
  • "residentialStatus": "Permanent",
  • "minorIndicator": true,
  • "citizenships": [
    ],
  • "countryOfResidence": "US",
  • "profile": {
    },
  • "personId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "status": "Queued"
}

Ledger Accounts

Retrieves a list of accounts matching the parameters.

Authorizations:
jwtopenIdConnect
query Parameters
accountId.eq
string (Id) [ 1 .. 36 ] characters
Example: accountId.eq=5fb9d4d6-1a3c-11ed-861d-0242ac120002
accountType.eq
string
accountBranchCode.eq
string
status.eq
string <date> (Date)
Example: status.eq=2022-04-17

A particular point in the progression of time in a calendar year expressed in the YYYY-MM-DD format.

accountNumber.eq
string (LedgerAccountNumber) <= 30 characters
Example: accountNumber.eq=1-001

Ledger account number used to identify different accounts. Also used for grouping and categorizing accounts. To make it easy for readers to locate specific accounts or to know what they're looking at instantly, each account typically contains human readable codes.

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Creates a ledger account or any internal working account of the bank.

Creates a ledger account, detailed or general, of the Chart of Accounts. Also can represent holding accounts, mirror accounts or working accounts that are required for the booking of a part of a transaction in the bank world. This is typically the case when amounts cannot immediately be booked on a final account for duty seggregation or processing reasons or in order to mirror bookings on external accounts, like nostro accounts, mirrow or holding account.

Authorizations:
jwtopenIdConnect
header Parameters
idempotencyId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Idempotency identifier used by the client when making repeated calls

servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Request Body schema: application/json
accountType
required
string (LedgerAccountType) [ 1 .. 35 ] characters
Example: "GeneralLedger"

Type of the Ledger Account. Possible values: GeneralLedger, DetailedLedger, Holding, Mirrow.

accountSubtype
string (LedgerAccountSubtype) [ 1 .. 35 ] characters
Example: "Asset"

Subtype of the Ledger Account. Possible values: Asset, Liability, Equity.

accountCategory
string (LedgerCategoryId) [ 1 .. 40 ] characters
Example: "1"

Unique identifier for the ledger account category. Is a grouping of Ledger Accounts. Its balance is equal to the sum of the balances of all contained accounts.

name
required
string (AccountName) [ 1 .. 70 ] characters
Example: "Hermes PD_CA 0002"

Name of the account. It provides an additional means of identification, and is designated by the account servicer in agreement with the account owner.

number
string (LedgerAccountNumber) <= 30 characters
Example: "1-001"

Ledger account number used to identify different accounts. Also used for grouping and categorizing accounts. To make it easy for readers to locate specific accounts or to know what they're looking at instantly, each account typically contains human readable codes.

accountPurpose
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
currency
string (CurrencyCode) = 3 characters ^([A-Z]{3})?$
Example: "USD"

Three contiguous letters for the representation of currencies and funds. Valid currency codes are registered with the ISO 4217 Maintenance Agency.

Array of objects (RelatedAccount)
Array
accountRelationType
required
string (AccountRelationType)
Example: "Child"

Account relation role. Possible values are: Parent, Child, Group.

accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: "0dd926fe-1ca2-11ed-861d-0242ac120002"

Identification assigned by the account service institution (Servicer).

accountNumber
string (AccountNumber) <= 30 characters
Example: "012345678"

The account number or Basic Bank Account Number (BBAN). A Basic Bank Account Number (BBAN) is a bank account number that includes the domestic bank code, branch identifier, and account number. It is a unique identifier for a bank account within a specific country.

accountType
required
string (RelatedAccountType) [ 1 .. 35 ] characters
Example: "Checking"

Type of the account. Some possible ISO 20022 compliant values are: Checking, CardAccount, CashPayment, Charges, CashIncome, Commission, ClearingParticipantSettlementAccount, LimitedLiquiditySavingsAccount, MarginalLending, MoneyMarket, NonResidentExternal, Overdraft, OverNightDeposit, Settlement, Salary, Savings, Tax, TransactingAccount, CashTrading, VirtualAccount, CreditCard, DebitCard, Universal, Investment, EpurseCard, CertificateOfDeposit, MoneyMarketChecking, RetirementAccount, StockOrBond, PrePaid, FleetCard, Cash, DebitAccount, CreditAccount, Benefit, HealthSavingsAccount, FlexibleSpendingAccount, ForBenefitOf, Estate, ClientTrustAccount, LawyersTrustAccount, KeoghPlanAccount, UniformTransfersToMinorsAct, UniformGiftsToMinorsAct, ReserveFunds, SelfDirectedBrokerage, Loan, Ledger.

name
string (AccountName) [ 1 .. 70 ] characters
Example: "Hermes PD_CA 0002"

Name of the account. It provides an additional means of identification, and is designated by the account servicer in agreement with the account owner.

supplementaryData
object (SupplementaryData)

Additional information that cannot be captured in the structured elements and/or any other specific block. If this information need to be converted in ISO Messages, must be ISO 20022 compliant: it requires development of a compliant message extension model and its components must be registered in the ISO 20022 Data Dictionary. https://www.iso20022.org/catalogue-messages/additional-content-messages/supplementary-data

Responses

Request samples

Content type
application/json
{
  • "accountType": "GeneralLedger",
  • "accountSubtype": "Asset",
  • "accountCategory": "1",
  • "name": "Hermes PD_CA 0002",
  • "number": "1-001",
  • "accountPurpose": "This is a description.",
  • "currency": "USD",
  • "relatedAccounts": [
    ],
  • "supplementaryData": { }
}

Response samples

Content type
application/json
{
  • "accountType": "GeneralLedger",
  • "accountSubtype": "Asset",
  • "accountCategory": "1",
  • "name": "Hermes PD_CA 0002",
  • "number": "1-001",
  • "accountPurpose": "This is a description.",
  • "currency": "USD",
  • "relatedAccounts": [
    ],
  • "supplementaryData": { },
  • "accountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "accountBranchCode": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "balances": [
    ],
  • "status": "Pending"
}

Retrieves a Ledger Account

Authorizations:
jwtopenIdConnect
path Parameters
accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: 0dd926fe-1ca2-11ed-861d-0242ac120002

Account Identification

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Responses

Response samples

Content type
application/json
{
  • "accountType": "GeneralLedger",
  • "accountSubtype": "Asset",
  • "accountCategory": "1",
  • "name": "Hermes PD_CA 0002",
  • "number": "1-001",
  • "accountPurpose": "This is a description.",
  • "currency": "USD",
  • "relatedAccounts": [
    ],
  • "supplementaryData": { },
  • "accountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "accountBranchCode": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "balances": [
    ],
  • "status": "Pending"
}

Updates an Account

Use the JSON Merge Patch standard https://tools.ietf.org/html/rfc7396

Authorizations:
jwtopenIdConnect
path Parameters
accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: 0dd926fe-1ca2-11ed-861d-0242ac120002

Account Identification

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Request Body schema: application/merge-patch+json
accountType
required
string (LedgerAccountType) [ 1 .. 35 ] characters
Example: "GeneralLedger"

Type of the Ledger Account. Possible values: GeneralLedger, DetailedLedger, Holding, Mirrow.

accountSubtype
string (LedgerAccountSubtype) [ 1 .. 35 ] characters
Example: "Asset"

Subtype of the Ledger Account. Possible values: Asset, Liability, Equity.

accountCategory
string (LedgerCategoryId) [ 1 .. 40 ] characters
Example: "1"

Unique identifier for the ledger account category. Is a grouping of Ledger Accounts. Its balance is equal to the sum of the balances of all contained accounts.

name
required
string (AccountName) [ 1 .. 70 ] characters
Example: "Hermes PD_CA 0002"

Name of the account. It provides an additional means of identification, and is designated by the account servicer in agreement with the account owner.

number
string (LedgerAccountNumber) <= 30 characters
Example: "1-001"

Ledger account number used to identify different accounts. Also used for grouping and categorizing accounts. To make it easy for readers to locate specific accounts or to know what they're looking at instantly, each account typically contains human readable codes.

accountPurpose
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
currency
string (CurrencyCode) = 3 characters ^([A-Z]{3})?$
Example: "USD"

Three contiguous letters for the representation of currencies and funds. Valid currency codes are registered with the ISO 4217 Maintenance Agency.

Array of objects (RelatedAccount)
Array
accountRelationType
required
string (AccountRelationType)
Example: "Child"

Account relation role. Possible values are: Parent, Child, Group.

accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: "0dd926fe-1ca2-11ed-861d-0242ac120002"

Identification assigned by the account service institution (Servicer).

accountNumber
string (AccountNumber) <= 30 characters
Example: "012345678"

The account number or Basic Bank Account Number (BBAN). A Basic Bank Account Number (BBAN) is a bank account number that includes the domestic bank code, branch identifier, and account number. It is a unique identifier for a bank account within a specific country.

accountType
required
string (RelatedAccountType) [ 1 .. 35 ] characters
Example: "Checking"

Type of the account. Some possible ISO 20022 compliant values are: Checking, CardAccount, CashPayment, Charges, CashIncome, Commission, ClearingParticipantSettlementAccount, LimitedLiquiditySavingsAccount, MarginalLending, MoneyMarket, NonResidentExternal, Overdraft, OverNightDeposit, Settlement, Salary, Savings, Tax, TransactingAccount, CashTrading, VirtualAccount, CreditCard, DebitCard, Universal, Investment, EpurseCard, CertificateOfDeposit, MoneyMarketChecking, RetirementAccount, StockOrBond, PrePaid, FleetCard, Cash, DebitAccount, CreditAccount, Benefit, HealthSavingsAccount, FlexibleSpendingAccount, ForBenefitOf, Estate, ClientTrustAccount, LawyersTrustAccount, KeoghPlanAccount, UniformTransfersToMinorsAct, UniformGiftsToMinorsAct, ReserveFunds, SelfDirectedBrokerage, Loan, Ledger.

name
string (AccountName) [ 1 .. 70 ] characters
Example: "Hermes PD_CA 0002"

Name of the account. It provides an additional means of identification, and is designated by the account servicer in agreement with the account owner.

supplementaryData
object (SupplementaryData)

Additional information that cannot be captured in the structured elements and/or any other specific block. If this information need to be converted in ISO Messages, must be ISO 20022 compliant: it requires development of a compliant message extension model and its components must be registered in the ISO 20022 Data Dictionary. https://www.iso20022.org/catalogue-messages/additional-content-messages/supplementary-data

accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: "0dd926fe-1ca2-11ed-861d-0242ac120002"

Identification assigned by the account service institution (Servicer).

accountBranchCode
string (Id) [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"
Array of objects (LedgerAccountBalance)
Array
balanceName
required
string (LedgerBalanceName) [ 1 .. 17 ] characters
Example: "Closing"

Specifies the nature of the ledger balance. Possible Values are: Closing, Pending, Posted, Available.

amount
required
string (AmountInCents) <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: -9999999999999.99999999

currency
string (CurrencyCode) = 3 characters ^([A-Z]{3})?$
Example: "USD"

Three contiguous letters for the representation of currencies and funds. Valid currency codes are registered with the ISO 4217 Maintenance Agency.

calculationDate
string <date-time>
Example: "2022-04-17T08:00:00Z"

Specifies the date and time at which the balance is calculated.

status
required
string (AccountStatus) [ 1 .. 35 ] characters
Example: "Pending"

Specifies the current state of an account. Possible ISO 20022 compliant values names are: Enable, Dormant, Disable, Deleted, Pending, Form.

Responses

Request samples

Content type
application/merge-patch+json
{
  • "accountType": "GeneralLedger",
  • "accountSubtype": "Asset",
  • "accountCategory": "1",
  • "name": "Hermes PD_CA 0002",
  • "number": "1-001",
  • "accountPurpose": "This is a description.",
  • "currency": "USD",
  • "relatedAccounts": [
    ],
  • "supplementaryData": { },
  • "accountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "accountBranchCode": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "balances": [
    ],
  • "status": "Pending"
}

Response samples

Content type
application/json
{
  • "accountType": "GeneralLedger",
  • "accountSubtype": "Asset",
  • "accountCategory": "1",
  • "name": "Hermes PD_CA 0002",
  • "number": "1-001",
  • "accountPurpose": "This is a description.",
  • "currency": "USD",
  • "relatedAccounts": [
    ],
  • "supplementaryData": { },
  • "accountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "accountBranchCode": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "balances": [
    ],
  • "status": "Pending"
}

Retrieves Account Balances

Authorizations:
jwtopenIdConnect
path Parameters
accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: 0dd926fe-1ca2-11ed-861d-0242ac120002

Account Identification

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Responses

Response samples

Content type
application/json
{
  • "accountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "accountNumber": "1-001",
  • "accountType": "GeneralLedger",
  • "balances": [
    ]
}

Retrieves Ledger Account Transactions

Authorizations:
jwtopenIdConnect
path Parameters
accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: 0dd926fe-1ca2-11ed-861d-0242ac120002

Account Identification

query Parameters
transactionId.eq
string (TransactionId) [ 1 .. 36 ] characters
Example: transactionId.eq=0dd926fe-1ca2-11ed-861d-0242ac120002

Unique reference as assigned by the account servicing institution to unambiguously identify the transaction.

status.eq
string (TransactionStatus) [ 1 .. 35 ] characters
Example: status.eq=Booked

Specifies the status of an entry on the books of the account servicer. Some possible ISO 20022 compliant values are: Booked, Future, Information, Pending.

amount.lte
string (AmountInCents) <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: amount.lte=100

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: -9999999999999.99999999

amount.gte
string (AmountInCents) <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: amount.gte=100

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: -9999999999999.99999999

creationDate.lte
string <date> (Date)
Example: creationDate.lte=2022-04-17

Input cycle date less than or equal

creationDate.gte
string <date> (Date)
Example: creationDate.gte=2022-04-17

Input cycle date greater than or equal

cursor
string

Specifies an opaque string value ( "no meaning" string value) at which start retrieving transactions. For instance, limit=5&cursor=62aef884fbe3470ce7d9a92140b09b17

limit
string

Specifies the number of resources to return in one request, specified as an integer from 1 to 100.

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

Pagination-Cursor
required
string

Pagination Cursor

Pagination-Total
required
string

Total number of resources.

Responses

Response samples

Content type
application/json
{
  • "accountId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "accountNumber": "1-001",
  • "accountType": "GeneralLedger",
  • "currentBalance": "100",
  • "transactions": [
    ]
}

Retrieves a list of internal transfers matching the parameters.

Authorizations:
jwtopenIdConnect
query Parameters
transferId.eq
string (Id) [ 1 .. 36 ] characters
Example: transferId.eq=5fb9d4d6-1a3c-11ed-861d-0242ac120002
sourceAccountId.eq
string (Id) [ 1 .. 36 ] characters
Example: sourceAccountId.eq=5fb9d4d6-1a3c-11ed-861d-0242ac120002
sourceAccountNumber.eq
string (AccountNumber) <= 30 characters
Example: sourceAccountNumber.eq=012345678

The account number or Basic Bank Account Number (BBAN). A Basic Bank Account Number (BBAN) is a bank account number that includes the domestic bank code, branch identifier, and account number. It is a unique identifier for a bank account within a specific country.

destinationAccountId.eq
string (Id) [ 1 .. 36 ] characters
Example: destinationAccountId.eq=5fb9d4d6-1a3c-11ed-861d-0242ac120002
destinationAccountNumber.eq
string (AccountNumber) <= 30 characters
Example: destinationAccountNumber.eq=012345678

The account number or Basic Bank Account Number (BBAN). A Basic Bank Account Number (BBAN) is a bank account number that includes the domestic bank code, branch identifier, and account number. It is a unique identifier for a bank account within a specific country.

amount.lte
string (AmountInCents) <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: amount.lte=100

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: -9999999999999.99999999

amount.gte
string (AmountInCents) <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: amount.gte=100

Number of monetary units where the size of the decimal part is defined by the currency. Note: total number of digits: 21 number of digits in fractional part: 8 maxInclusive: 9999999999999.99999999 minInclusive: -9999999999999.99999999

header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Internal Transfer Request

Instruction to transfer funds between ledger accounts, or between a holding account and a final account.

Authorizations:
jwtopenIdConnect
header Parameters
idempotencyId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Idempotency identifier used by the client when making repeated calls

servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Request Body schema: application/json
Array of objects (InternalTransferEntry)
Array
amount
string <= 23 characters ^-?([0]|([1-9][0-9]{0,12}))([.][0-9]{0,8})?$
Example: "100"

Amount of money to be moved between the debtor and creditor, before deduction of charges, expressed in the currency as ordered by the initiating party.

creditDebitIndicator
string (CreditDebitIndicator) [ 1 .. 17 ] characters
Example: "Credit"

Specifies if an operation is an increase or a decrease. Possible ISO 20022 compliant values names are: Credit, Debit.

accountId
string (AccountId) [ 1 .. 36 ] characters
Example: "0dd926fe-1ca2-11ed-861d-0242ac120002"

Identification assigned by the account service institution (Servicer).

purpose
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
reason
string (PaymentPurpose) [ 1 .. 60 ] characters
Example: "CashManagementTransfer"

Underlying reason for the payment transaction. Usage: Purpose is used to provide information concerning the nature of the payment. Possible Values: BillerSubscriberIdentification, BankLoanDelayedDrawFunding, BankLoanFees, BankLoanFundingMemo, BankLoanAccruedInterestPayment, BankLoanPrincipalPaydown, CardBulkClearing, CardPaymentWithCashBack, CashDisbursementCashSettlement, CashDisbursementWithSurcharging, CardDeferredPayment, OriginalCredit, QuasiCash, EPurseTopUp, FeeCollection, MobileTopUp, AccountManagement, CashManagementTransfer, CollectionPayment, CashDisbursementCashManagement, Deposit, IntraCompanyPayment, IntraPartyPayment, LiquidityManagement, Netting, BondForward, CrossCurrencyIRS, CCPClearedInitialMargin, CCPClearedVariationMargin, CCPClearedInitialMarginSegregatedCash, CreditDefaultSwap, CrossProduct, CreditSupport, CreditLine, EquityOption, EquitySwap, ExoticOption, ExchangeTradedDerivatives, FixedIncome, ForwardBrokerOwnedCashCollateral, ForwardClientOwnedCashCollateral, ForwardBrokerOwnedCashCollateralSegregated, ForwardClientOwnedSegregatedCashCollateral, DailyMarginOnListedDerivatives, MBSBrokerOwnedCashCollateral, MBSClientOwnedCashCollateral, FuturesInitialMargin, FuturesInitialMarginClientOwnedSegregatedCashCollateral, ClientOwnedOCCPledgedCollateral, OTCOptionBrokerOwnedCashCollateral, OTCOptionClientOwnedCashCollateral, OTCOptionBrokerOwnedSegregatedCashCollateral, OTCOptionClientOwnedCashSegregatedCashCollateral, FXOption, OTCDerivatives, RepurchaseAgreement, BilateralRepoBrokerOwnedCollateral, RepoClientOwnedCollateral, BilateralRepoBrokerOwnedSegregatedCashCollateral, BilateralRepoClientOwnedSegregatedCashCollateral, ReverseRepurchaseAgreement, SecuritiesBuySellSellBuyBack, SingleCurrencyIRSExotic, SingleCurrencyIRS, SecuritiesCrossProducts, BrokerOwnedCollateralShortSale, ClientOwnedCollateralShortSale, ShortSell, SecuritiesLendingAndBorrowing, SecuredLoan, SwapBrokerOwnedCashCollateral, SwapClientOwnedCashCollateral, Swaption, SwapsBrokerOwnedSegregatedCashCollateral, SwapsClientOwnedSegregatedCashCollateral, ToBeAnnounced, TBABrokerOwnedCashCollateral, TBAClientOwnedCashCollateral, TreasuryCrossProduct, AgriculturalTransfer, AccountsReceivablesEntry, BusinessExpenses, BackOfficeConversionEntry, CommercialPayment, Copyright, PurchaseSaleOfGoods, PurchaseSaleOfGoodsAndServices, PurchaseSaleOfGoodsAndServicesWithCashBack, LicenseFee, MobileP2BPayment, PointOfPurchaseEntry, Royalties, PurchaseSaleOfServices, ServiceCharges, Subscription, SupplierPayment, Commercial, CharityPayment, ConsumerThirdPartyConsolidatedPayment, MobileP2PPayment, GuaranteedEPayment, EPaymentReturn, NonGuaranteedEPayment, Epayment, CarLoanPrincipalRepayment, CompensationPayment, DebitCollectionPayment, GovernmentInsurance, PropertyLoanRepayment, PropertyLoanSettlement, InsurancePremiumCar, InsurancePremiumRefund, PaymentOfInsuranceClaim, InsurancePremium, Interest, LaborInsurance, LifeInsurance, Loan, LoanRepayment, PaymentBasedOnEnforcementOrder, PropertyInsurance, RentalLeaseGeneral, RecurringInstallmentPayment, TrustFund, ForwardForeignExchange, ForeignExchangeRelatedNetting, AdministrativeManagement, AdvancePayment, BearerCheckDomestic, BearerCheckForeign, BuildingMaintenance, BondForwardNetting, CapitalBuilding, CapitalBuildingRetirement, CreditCardPayment, CreditCardBill, CancellationFee, CardGeneratedDirectDebit, TradeSettlementPayment, Costs, CarparkCharges, DebitCardPayment, PrintedOrderDisbursement, DeliverAgainstPayment, Education, FactorUpdateRelatedPayment, FinancialAidInCaseOfNaturalDisaster, LatePaymentOfFeesAndCharges, PaymentOfFees, Gift, GovernmentPayment, IrrevocableCreditCardPayment, IrrevocableDebitCardPayment, InstalmentHirePurchaseAgreement, Installment, InvoicePayment, MultiCurrenyCheckDomestic, MultiCurrenyCheckForeign, MultipleServiceTypes, NotOtherwiseSpecified, OrderChequeDomestic, OrderChequeForeign, OpeningFee, PreauthorizedDebit, PaymentTerms, RepresentedCheckEntry, ReceiptPayment, Rebate, Refund, Rent, AccountOverdraftRepayment, ReimbursementOfAPreviousErroneousTransaction, BilateralRepoInternetNetting, RoundRobin, ReimbursementReceivedCreditTransfer, RelatedRequestToPay, ReceiveAgainstPayment, PaymentSlipInstruction, SplitPayments, Study, TBAPairOffNetting, TelecommunicationsBill, TownCouncilServiceCharges, TelephoneInitiatedTransaction, TMPGClaimPayment, TriPartyRepoInterest, TriPartyRepoNetting, TruncatedPaymentSlip, TravellerCheque, InternetInitiatedTransaction, InstantPayments, InstantPaymentsCancellation, InstantPaymentsForDonations, InstantPaymentsInECommerceWithoutAddressData, InstantPaymentsInECommerceWithAddressData, InstantPaymentsInECommerce, InstantPaymentsAtPOS, InstantPaymentsReturn, InstantPaymentsUnattendedVendingMachineWith2FA, InstantPaymentsUnattendedVendingMachineWithout2FA, Annuity, CustodianManagementFeeInhouse, CapitalFallingDueInhouse, CommodityTransfer, Derivatives, Dividend, ForeignExchange, Hedging, InvestmentAndSecurities, PreciousMetal, Savings, Securities, SecuritiesPurchaseInhouse, TreasuryPayment, UnitTrustPurchase, FuturesNettingPayment, Futures, AnesthesiaServices, ConvalescentCareFacility, DurableMedicaleEquipment, DentalServices, HomeHealthCare, HealthInsurance, HospitalCare, IntermediateCareFacility, LongTermCareFacility, MedicalAidFundContribution, MedicalAidRefund, MedicalServices, VisionCare, CreditDefaultEventPayment, SwapContractFinalPayment, SwapContractPartialPayment, SwapContractResetPayment, SwapContractUpfrontPayment, AdvisoryDonationCopyrightServices, ActiveEmploymentPolicy, Allowance, AlimonyPayment, BabyBonusScheme, ChildBenefit, UnemploymentDisabilityBenefit, BonusPayment, CashCompensationHelplessnessDisability, Commission, CompanySocialLoanPaymentToBank, GuaranteeFundRightsPayment, GovermentWarLegislationTransfer, HousingRelatedContribution, Payroll, PensionFundContribution, PensionPayment, PricePayment, RehabilitationSupport, SalaryPayment, SalaryPensionSumPayment, SocialSecurityBenefit, LendingBuyInNetting, LendingCashCollateralFreeMovement, LendingFees, LendingEquityMarkedToMarketCashCollateral, LendingFixedIncomeMarkedToMarketCashCollateral, LendingUnspecifiedTypeOfMarkedToMarketCashCollateral, LendingRebatePayments, LendingRevenuePayments, LendingClaimPayment, EstateTax, ForeignWorkerLevy, GoodsServicesTax, HousingTax, IncomeTax, NetIncomeTax, PropertyTax, RoadTax, TaxPayment, ValueAddedTaxPayment, WithHolding, TaxRefund, TrailerFeePayment, TrailerFeeRebate, NonUSMutualFundTrailerFeePayment, NonUSMutualFundTrailerFeeRebatePayment, Air, Bus, Ferry, Railway, RoadPricing, CableTVBill, ElectricityBill, Energies, GasBill, NetworkCharge, NetworkCommunication, OtherTelecomRelatedBill, TelephoneBill, Utilities, WaterBill, Bonds, CorporateActions-Bonds, CorporateActions-Equities, CreditCard, DebitCard, Diners, Equities, FleetCard, LowValueCredit, LowValueDebit, MoneyMarket, RapidPaymentInstruction, GamblingOrWageringPayment, LotteryPayment, Amex, ATM, AuthenticatedCollections, PropertyCompletionPayment, PropertyDeposit, PropertyLoanDisbursement, PropertyLoanRefinancing, GovernmentFamilyAllowance, GovernmentHousingAllowance, CashPenalties.

Responses

Request samples

Content type
application/json
{
  • "entries": [
    ],
  • "purpose": "This is a description.",
  • "reason": "CashManagementTransfer"
}

Response samples

Content type
application/json
{
  • "entries": [
    ],
  • "purpose": "This is a description.",
  • "reason": "CashManagementTransfer",
  • "date": "2022-04-17T08:00:00Z",
  • "transferId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "status": "Accepted"
}

Internal Transfer Status

Returns the status of an internal transfer.

Authorizations:
jwtopenIdConnect
path Parameters
transferId
required
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002
header Parameters
servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Responses

Response samples

Content type
application/json
{
  • "entries": [
    ],
  • "purpose": "This is a description.",
  • "reason": "CashManagementTransfer",
  • "date": "2022-04-17T08:00:00Z",
  • "transferId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "status": "Accepted"
}

Credit Transfer Cancellation

Request a transfer cancellation.

Authorizations:
jwtopenIdConnect
path Parameters
transferId
required
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002
header Parameters
idempotencyId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Idempotency identifier used by the client when making repeated calls

servicerId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Account Servicer Identification (Bank)

servicerBranchId
string (Id) [ 1 .. 36 ] characters
Example: 5fb9d4d6-1a3c-11ed-861d-0242ac120002

Identification of the account servicer institution at branch level or operation level.

Request Body schema: application/json
cancellationReason
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."

Responses

Request samples

Content type
application/json
{
  • "cancellationReason": "This is a description."
}

Response samples

Content type
application/json
{
  • "cancellationReason": "This is a description.",
  • "cancellationId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002"
}