Skip to main content

PortX ORCA Account Management (0.3.5)

Download OpenAPI specification:Download

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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

Identification of the account servicer institution at branch level or center 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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

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

Core-Validation-Mode
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
accountBranchId
string (ServicerBranchId) [ 1 .. 36 ] characters
Example: "SEA_1"

Identification of the account servicer institution at branch level or center level. To overlay the codes to produce a unique identifier the following expresion is used: BranchRegionCode-BranchSubdivisionCode.

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 [ 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.

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 or internally to connect to other applications.

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, CreditBackIdentification, UniversalLoanIdentifier, CommitmentNumber, RecordNumber, FlexDataRecordNumber

issuer
string [ 1 .. 35 ] characters

Entity that assigns the identification.

securedIndicator
boolean

Indicates whether the Account is secure.

securedType
string (SecuredAccountType) [ 1 .. 17 ] characters
Example: "Collateral"

Indicates how the account is secured. Possible Values: Collateral, Agent

object (AccountPaymentDetail)
numberOfPayments
integer

Number of loan payments.

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, Curtailment.

Array of objects (PaymentIdentification)
Array of objects (Balance)

Other payment amounts

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, Curtailment.

Array of objects (PaymentIdentification)
Array of objects (Balance)

Other payment amounts

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

Payment date

object

How often principal payments are due.

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.

numberOfTimes
integer
Example: 4

Number of times the event will be repeated.

object

How often interest payments are due.

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.

numberOfTimes
integer
Example: 4

Number of times the event will be repeated.

draftDayAdjuster
integer <= 31
Example: 30

Number of days before or after an automatic payment is debited from an account.

automaticIndicator
boolean

Indicates whether, prior to the loan going past due, a payment is automatic generated.

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

Specifies the type of Payment. Possible values: LiquidityTransfer, OnUs, ACH, Wire, NotOnUs

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

First payment date

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, Organization, Business, FormalPartnership, FormalTrust, Nominee, NonProfitOrganization, NotForProfitOrganization, ForProfit, EUResidualEntity, USGovernmentOrganization, GovernmentOrganization, LimitedLiabilityCompany, RegisteredInvestmentCompany, Entrepreneurial, Unincorporated, LimitedPartnership, LimitedLiabilityPartnership, BareOwner, Usufructuary, Fiduciary, ServicerEmployeeAccount, BusinessTrust, FamilyTrust, Estate, PublicFunds, NonUSGovernmentOrganization, Church.

balanceType
string (Balance Type)
Example: "Asset"

Account Balance Type. Possible Values: Asset, positive transaction amount increases balance; Liability, positive transaction amount decreases balance; Equity.

productId
string (ProductId) [ 1 .. 36 ] characters
Example: "PD_CA_0002"

Identification of the product offered by a financial institution to its customers.

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.

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: "San Diego"

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

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

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

object (PersonContactDetails)

Specifies the contact details of a person.

object (StructuredName)

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

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

Preferred name to contact the person

Array of objects (Phone)
Array of objects (Email)
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)
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, Operator, VRU, Telebanc.

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, Default.

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 (MasterAgreement)

A master agreement is a document that outlines the terms and conditions of an agreement between two or more parties. It's common to use a master agreement when there are multiple agreements in place with one company.

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

Account at Master Agreement level used as a reference for the Loan opening. Payments are auto-debited from this account.

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

Account at Master Agreement level used as a reference for the Loan opening. Payments are auto-debited from this account.

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 (AccountDetailedParty)
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
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, PowerOfAttorney, ContingentBeneficiary, Fiduciary,

partyAccountRoleCode
string
Example: "50"

Bank defined party account role.

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

Percentage value of the ownership that the party has in the account.

accountOwnerRelation
string [ 1 .. 40 ] characters
Example: "PrimaryServicerOfficer"

Identifies how the party is related to the owner of the account.

customerType
string (CustomerType)
Example: "Consumer"

A customer type of a bank account can be classified into different categories based on the account's features, purpose, and benefits. Possible Values: Personal, Business, Consumer, Organization, ThirdParty.

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, AssociatedAccount.

accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: "033-DDA-123456"

Identification assigned by the account service institution (Servicer). Could be encoded (UUID). Also may be used as composite account identifier when overlaying the account code parts. [branch-type-subtype-number]

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

Account used as a reference for the account opening.

Array of objects (SpotDate)
Array
name
string (SpotDateName) [ 1 .. 40 ] characters
Example: "Expiration"

Specifies the name of Loan projected date. Possible values por projected dates: Forecast, Expiration, LastNonFinancial

date
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 (Restriction)
Array
name
required
string [ 1 .. 60 ] characters
Example: "WireTransferIn"

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

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

Indicates whether the capability is allowed or not.

disableConditions
Array of strings (ConditionName) [ items [ 1 .. 36 ] characters ]
Example: ["Pending"]

Conditions that disabel the restriction.

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.

status
string (RestrictionStatus) [ 1 .. 36 ] characters
Example: "Pending"

Specifies the status of a restriction enablement request. Possible values: Active, Pending.

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, CashAdvance, ACHInTransfers, ACHOutTransfers

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

Specifies the type of risk management limit. Bilateral, NetBilateral, IndirectBilateral, Global, MandatoryBilateral, DiscretionaryBilateral, DirectDebit, SingleCustomerDirectDebit, SingleFinancialInstitutionDirectDebit, TotalDailyCustomerDirectDebit, TotalDailyFinancialInstitutionDirectDebit, AutoCollateralisation, UnsecuredCredit, ExternalGuarantee, Revolving, NotRevolving.

channelType
string [ 1 .. 30 ] characters

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

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

Amount limit

number
integer

Number limit.

enableIndicator
boolean
Example: true

Indicates whether the limit is enabled or not.

percentageIndicator
boolean

Indicates if the limit is calculated as a percentage.

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

temporaryIndicator
boolean
Example: true

Indicates whether the limit is temporary or not.

object (DatePeriod)
object

Renewal 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 (LimitHistory)

Historic values of a Limit

Array of objects (Balance)
object (FinancialStatement)

Specifies financial statement details.

object

The frequency of the regular statement.

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.

numberOfTimes
integer
Example: 4

Number of times the event will be repeated.

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, Operator, VRU, Telebanc.

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)
periodNumber
integer

Sequence number of the period.

periodName
string (PeriodName)

Time of the year or previous. Possible Values: YearToDate, MonthToDate, PreviousYear, BeginningPreviousYear, QuarterToDate, PreviousQuarter, YearEnd

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.

object (Period)
periodNumber
integer

Sequence number of the period.

periodName
string (PeriodName)

Time of the year or previous. Possible Values: YearToDate, MonthToDate, PreviousYear, BeginningPreviousYear, QuarterToDate, PreviousQuarter, YearEnd

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.

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

The date of the last statement.

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

The date of the statement previous from the last.

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

The date of the last regular statement.

accountNameIndicator
boolean

Indicates whether the account name is printed on the statement.

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, Default.

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 (InterestDayCountBasis) [ 1 .. 50 ] characters
Example: "Actual360"

An interest day count basis is a method used to calculate interest accrual over a period of time for loans and bonds. The method involves determining the number of days over which interest is being calculated, known as the accrual period. The resulting accrual period is then divided by a certain number to calculate the daily interest rate, which is applied to the principal balance to determine the interest payment. Possible Values: ActualActual, Actual360, Actual365, 365365, 360360, Monthly78ths, 365360, ActualSchedule, ScheduleSchedule.

calculationMethodOption
string (InterestComputationParameter) [ 1 .. 50 ] characters
Example: "LastInterest"

Specifies a parameter that apply at the interest day count basis. Possible Values: LastInterest, EqualPayment, InterestAndPrincipal, InterestSeparatedm, Amortized, AddOn, NegativeAmortization, Simple, FHLMC.

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

An accrued date is a hypothetical point in time when the interest should have been paid.

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.

object

The period funds are earning interest.

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

Indicates the compounding method used for interest calculations.

object

Frequency of the interest calculation and compounded during the term.

object (Frequency)

Specifies an event frequency

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 (InterestRenewalDetails)

Detailed interest attributes related to rate change and account maturity.

object (InterestCycle)

Set of parameters used to calculate an interest cycle.

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

The amount of automatic interest that was last posted to the account.

reportingIndicator
boolean

Identifies whether interest paid is reportable.

reportingOptions
Array of strings (InterestReportingOption) [ items [ 1 .. 35 ] characters ]
Example: ["Deposit"]
object (TaxForm)

Information of the form requested by the tax payer.

object

The frequency used in calculating the Regulation DD Annual Percentage Yield (APY) when the financial institution requires interest to be withdrawn (i.e. compounding interest is not an option.) The Regulation DD Compound Frequency overrides the interest frequency only in computing the APY. For example, an account with interest paid monthly by check but disclosed as annual compounding.

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

Annual Percentage Yield (APY) is a measure used in finance to express the total return on an investment, taking into account both the interest earned and the appreciation in the investment's value, over a specified period. It is expressed as a percentage and is often used for fixed income securities such as bonds, and money market accounts.

daysSinceLastAnniversary
integer

The number of calendar days processed since the last anniversary date

Array of objects (InterestCalculationRate)

Rates involve on interest calculation.

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

pastDueOptions
Array of strings[ items [ 1 .. 70 ] characters ]

Indicates how the Past Due Rate is applied to past due loans. After a loan payment is past due after certain days, interest is earned retroactively from the payment due date.

referenceRateName
string

Identifies the reference index for the debt instrument.

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

Margin over or under an index which determines the interest rate of an interest bearing instrument. Percentage to be added to or deducted from the index rate to calculate the effective rate.

spreadRateAmount
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

spreadRatePercentageIndicator
boolean
basisPointSpread
integer

Provides the number of basis points added to (if positive) or deducted from (if negative) the underlying reference rate to calculate the actual interest rate applicable for a given period at issuance of the floating rate instrument. Used to express differences in interest rates, for example, a difference of 0.10% is equivalen

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.

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.

exemptIndicator
boolean

Indicates whether the account is exempt of the charge.

calculationMethodCode
string [ 1 .. 60 ] characters

Servicer charge calculation code. Possible values: FIFO, older payment past due. LIFO, most recent payment past due

calculationMethodOptions
Array of strings[ items [ 1 .. 70 ] characters ]

Indicates other calculation method options for charge calculation.

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, Monthly78th

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.

maximumNumber
integer

Maximum Number of charges.

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

Minimum 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: "033-DDA-123456"

Identification assigned by the account service institution (Servicer). Could be encoded (UUID). Also may be used as composite account identifier when overlaying the account code parts. [branch-type-subtype-number]

object (Frequency)

Specifies an event frequency

Array of objects (Balance)
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, Operator, VRU, Telebanc.

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, NegativeBalance

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

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)
Array
name
string <= 50 characters
Example: "AccountingGroup"

Name of the code. Possible values are: AccountingGroup, CostCenter, DistributionGroup. Also values that may be overlayed on the identification: AccountNumber, AccountSubtype, AccountType. Also MICR numbers: MicrAccountNumber, The account number portion of a draft or line of credit MICR line. Other possible values: TaxIncentiveType, Preferredlanguage.

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 ]
object (AccountBillDetails)

Billing information of the payment

billingDay
integer <= 31
Example: 30

Identifies the day of the month that billing statements are generated.

billOption
string
Example: "Individual"

Indicates whether billing occurs for the account at the company level (consolidated) or at the individual account level. Possible values: Consolidated, Individual.

Array of objects (Balance)

Bill balances

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

Specifies the nature of the balance. Possible values: Current, Available, Pending, Opening, Blocked, Previous, PendingLedger, LastAnniversary, CurrentAccrued, PreviousAccrued, CurrentWithLastCalculus, CarriedAdjustment, PaidWithPenalties, Accrued, Penalty, CollectionLedger, LastLedger, CurrentLedger, Withheld, CurrentBooked, CurrentBook. Loan Balances: CashProceeds, the amount that a customer actually received, exclusive of insurance premiums, fees, and unearned discount; FinancedExpenses, indicates the amount of expenses an institution has financed for a borrower; TotalInterest; AdditionalInterest, if the date of the first payment is beyond one month from the note date, the interest for the odd days will be earned during the first interest period; DeferredUnsecuredPrincipal, is the outstanding balance of an unsecured debt. The DUPB includes any accrued interest that is yet to be paid by the borrower. The deferral typically occurs due to bankruptcy or debt relief proceedings, which temporarily halt collection efforts by the original creditor; Charge Balances: Earned, RealTimeDeliveryMaximum, Current, Financed, Prepaid, CurrentEarned, CurrentEarnedOtherEscrow, InterestPaidToDate, BasePaidToDate, TotalPastDue, Escrow, OtherEscrow, FinalAmount, FinalInterestAmount, Chapter4PreviousYear.

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

count
integer

Number of transactions added to the amount.

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.

periodNumber
integer

Sequence number of the period.

periodName
string (PeriodName)

Time of the year or previous. Possible Values: YearToDate, MonthToDate, PreviousYear, BeginningPreviousYear, QuarterToDate, PreviousQuarter, YearEnd

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.

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
{
  • "accountBranchId": "SEA_1",
  • "accountNumber": "012345678",
  • "accountType": "Checking",
  • "routingNumbers": [
    ],
  • "identifiers": [
    ],
  • "securedIndicator": true,
  • "securedType": "Collateral",
  • "payment": {
    },
  • "ownershipType": "SingleOwnerAccount",
  • "balanceType": "Asset",
  • "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",
  • "projectedDates": [
    ],
  • "restrictions": [
    ],
  • "limits": [
    ],
  • "statement": {
    },
  • "interests": [
    ],
  • "charges": [
    ],
  • "taxes": [
    ],
  • "communicationChannels": [
    ],
  • "relationshipId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "codes": [
    ],
  • "print": {
    },
  • "bill": {
    },
  • "servicerAlerts": [
    ],
  • "history": {
    },
  • "supplementaryData": { }
}

Response samples

Content type
{
  • "accountBranchId": "SEA_1",
  • "accountNumber": "012345678",
  • "accountType": "Checking",
  • "routingNumbers": [
    ],
  • "identifiers": [
    ],
  • "securedIndicator": true,
  • "securedType": "Collateral",
  • "payment": {
    },
  • "ownershipType": "SingleOwnerAccount",
  • "balanceType": "Asset",
  • "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",
  • "projectedDates": [
    ],
  • "restrictions": [
    ],
  • "limits": [
    ],
  • "statement": {
    },
  • "interests": [
    ],
  • "charges": [
    ],
  • "taxes": [
    ],
  • "communicationChannels": [
    ],
  • "relationshipId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "codes": [
    ],
  • "print": {
    },
  • "bill": {
    },
  • "servicerAlerts": [
    ],
  • "history": {
    },
  • "supplementaryData": { },
  • "ammountCalculationDate": "2022-04-17T08:00:00Z",
  • "transactionDates": [
    ],
  • "balances": [
    ],
  • "plasticCount": 0,
  • "cards": [
    ],
  • "accountId": "033-DDA-123456",
  • "standingOrders": [
    ],
  • "audit": {
    },
  • "status": {
    }
}

Retrieves an Account

Authorizations:
jwtopenIdConnect
path Parameters
accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: 033-DDA-123456

Account Identification

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

Account Servicer Identification (Bank)

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

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

Responses

Response samples

Content type
application/json
{
  • "accountBranchId": "SEA_1",
  • "accountNumber": "012345678",
  • "accountType": "Checking",
  • "routingNumbers": [
    ],
  • "identifiers": [
    ],
  • "securedIndicator": true,
  • "securedType": "Collateral",
  • "payment": {
    },
  • "ownershipType": "SingleOwnerAccount",
  • "balanceType": "Asset",
  • "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",
  • "projectedDates": [
    ],
  • "restrictions": [
    ],
  • "limits": [
    ],
  • "statement": {
    },
  • "interests": [
    ],
  • "charges": [
    ],
  • "taxes": [
    ],
  • "communicationChannels": [
    ],
  • "relationshipId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "codes": [
    ],
  • "print": {
    },
  • "bill": {
    },
  • "servicerAlerts": [
    ],
  • "history": {
    },
  • "supplementaryData": { },
  • "ammountCalculationDate": "2022-04-17T08:00:00Z",
  • "transactionDates": [
    ],
  • "balances": [
    ],
  • "plasticCount": 0,
  • "cards": [
    ],
  • "accountId": "033-DDA-123456",
  • "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: 033-DDA-123456

Account Identification

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

Account Servicer Identification (Bank)

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

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

Core-Validation-Mode
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
accountBranchId
string [ 1 .. 36 ] characters
Example: "SEA_1"

Identification of the account servicer institution at branch level or center level. To overlay the codes to produce a unique identifier the following expresion is used: BranchRegionCode-BranchSubdivisionCode.

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.

accountType
required
string [ 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.

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 or internally to connect to other applications.

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, CreditBackIdentification, UniversalLoanIdentifier, CommitmentNumber, RecordNumber, FlexDataRecordNumber

issuer
string [ 1 .. 35 ] characters

Entity that assigns the identification.

securedIndicator
boolean

Indicates whether the Account is secure.

securedType
string (SecuredAccountType) [ 1 .. 17 ] characters
Example: "Collateral"

Indicates how the account is secured. Possible Values: Collateral, Agent

object (AccountPaymentDetail)
numberOfPayments
integer

Number of loan payments.

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, Curtailment.

Array of objects (PaymentIdentification)
Array of objects (Balance)

Other payment amounts

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, Curtailment.

Array of objects (PaymentIdentification)
Array of objects (Balance)

Other payment amounts

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

Payment date

object

How often principal payments are due.

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.

numberOfTimes
integer
Example: 4

Number of times the event will be repeated.

object

How often interest payments are due.

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.

numberOfTimes
integer
Example: 4

Number of times the event will be repeated.

draftDayAdjuster
integer <= 31
Example: 30

Number of days before or after an automatic payment is debited from an account.

automaticIndicator
boolean

Indicates whether, prior to the loan going past due, a payment is automatic generated.

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

Specifies the type of Payment. Possible values: LiquidityTransfer, OnUs, ACH, Wire, NotOnUs

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

First payment date

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, Organization, Business, FormalPartnership, FormalTrust, Nominee, NonProfitOrganization, NotForProfitOrganization, ForProfit, EUResidualEntity, USGovernmentOrganization, GovernmentOrganization, LimitedLiabilityCompany, RegisteredInvestmentCompany, Entrepreneurial, Unincorporated, LimitedPartnership, LimitedLiabilityPartnership, BareOwner, Usufructuary, Fiduciary, ServicerEmployeeAccount, BusinessTrust, FamilyTrust, Estate, PublicFunds, NonUSGovernmentOrganization, Church.

balanceType
string (Balance Type)
Example: "Asset"

Account Balance Type. Possible Values: Asset, positive transaction amount increases balance; Liability, positive transaction amount decreases balance; Equity.

productId
string (ProductId) [ 1 .. 36 ] characters
Example: "PD_CA_0002"

Identification of the product offered by a financial institution to its customers.

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.

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: "San Diego"

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

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

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

object (PersonContactDetails)

Specifies the contact details of a person.

object (StructuredName)

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

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

Preferred name to contact the person

Array of objects (Phone)
Array of objects (Email)
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)
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, Operator, VRU, Telebanc.

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, Default.

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 (MasterAgreement)

A master agreement is a document that outlines the terms and conditions of an agreement between two or more parties. It's common to use a master agreement when there are multiple agreements in place with one company.

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

Account at Master Agreement level used as a reference for the Loan opening. Payments are auto-debited from this account.

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

Account at Master Agreement level used as a reference for the Loan opening. Payments are auto-debited from this account.

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 (AccountDetailedParty)
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
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, PowerOfAttorney, ContingentBeneficiary, Fiduciary,

partyAccountRoleCode
string
Example: "50"

Bank defined party account role.

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

Percentage value of the ownership that the party has in the account.

accountOwnerRelation
string [ 1 .. 40 ] characters
Example: "PrimaryServicerOfficer"

Identifies how the party is related to the owner of the account.

customerType
string (CustomerType)
Example: "Consumer"

A customer type of a bank account can be classified into different categories based on the account's features, purpose, and benefits. Possible Values: Personal, Business, Consumer, Organization, ThirdParty.

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, AssociatedAccount.

accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: "033-DDA-123456"

Identification assigned by the account service institution (Servicer). Could be encoded (UUID). Also may be used as composite account identifier when overlaying the account code parts. [branch-type-subtype-number]

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

Account used as a reference for the account opening.

Array of objects (SpotDate)
Array
name
string (SpotDateName) [ 1 .. 40 ] characters
Example: "Expiration"

Specifies the name of Loan projected date. Possible values por projected dates: Forecast, Expiration, LastNonFinancial

date
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 (Restriction)
Array
name
required
string [ 1 .. 60 ] characters
Example: "WireTransferIn"

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

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

Indicates whether the capability is allowed or not.

disableConditions
Array of strings (ConditionName) [ items [ 1 .. 36 ] characters ]
Example: ["Pending"]

Conditions that disabel the restriction.

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.

status
string (RestrictionStatus) [ 1 .. 36 ] characters
Example: "Pending"

Specifies the status of a restriction enablement request. Possible values: Active, Pending.

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, CashAdvance, ACHInTransfers, ACHOutTransfers

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

Specifies the type of risk management limit. Bilateral, NetBilateral, IndirectBilateral, Global, MandatoryBilateral, DiscretionaryBilateral, DirectDebit, SingleCustomerDirectDebit, SingleFinancialInstitutionDirectDebit, TotalDailyCustomerDirectDebit, TotalDailyFinancialInstitutionDirectDebit, AutoCollateralisation, UnsecuredCredit, ExternalGuarantee, Revolving, NotRevolving.

channelType
string [ 1 .. 30 ] characters

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

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

Amount limit

number
integer

Number limit.

enableIndicator
boolean
Example: true

Indicates whether the limit is enabled or not.

percentageIndicator
boolean

Indicates if the limit is calculated as a percentage.

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

temporaryIndicator
boolean
Example: true

Indicates whether the limit is temporary or not.

object (DatePeriod)
object

Renewal 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 (LimitHistory)

Historic values of a Limit

Array of objects (Balance)
object (FinancialStatement)

Specifies financial statement details.

object

The frequency of the regular statement.

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.

numberOfTimes
integer
Example: 4

Number of times the event will be repeated.

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, Operator, VRU, Telebanc.

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)
periodNumber
integer

Sequence number of the period.

periodName
string (PeriodName)

Time of the year or previous. Possible Values: YearToDate, MonthToDate, PreviousYear, BeginningPreviousYear, QuarterToDate, PreviousQuarter, YearEnd

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.

object (Period)
periodNumber
integer

Sequence number of the period.

periodName
string (PeriodName)

Time of the year or previous. Possible Values: YearToDate, MonthToDate, PreviousYear, BeginningPreviousYear, QuarterToDate, PreviousQuarter, YearEnd

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.

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

The date of the last statement.

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

The date of the statement previous from the last.

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

The date of the last regular statement.

accountNameIndicator
boolean

Indicates whether the account name is printed on the statement.

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, Default.

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 (InterestDayCountBasis) [ 1 .. 50 ] characters
Example: "Actual360"

An interest day count basis is a method used to calculate interest accrual over a period of time for loans and bonds. The method involves determining the number of days over which interest is being calculated, known as the accrual period. The resulting accrual period is then divided by a certain number to calculate the daily interest rate, which is applied to the principal balance to determine the interest payment. Possible Values: ActualActual, Actual360, Actual365, 365365, 360360, Monthly78ths, 365360, ActualSchedule, ScheduleSchedule.

calculationMethodOption
string (InterestComputationParameter) [ 1 .. 50 ] characters
Example: "LastInterest"

Specifies a parameter that apply at the interest day count basis. Possible Values: LastInterest, EqualPayment, InterestAndPrincipal, InterestSeparatedm, Amortized, AddOn, NegativeAmortization, Simple, FHLMC.

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

An accrued date is a hypothetical point in time when the interest should have been paid.

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.

object

The period funds are earning interest.

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

Indicates the compounding method used for interest calculations.

object

Frequency of the interest calculation and compounded during the term.

object (Frequency)

Specifies an event frequency

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 (InterestRenewalDetails)

Detailed interest attributes related to rate change and account maturity.

object (InterestCycle)

Set of parameters used to calculate an interest cycle.

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

The amount of automatic interest that was last posted to the account.

reportingIndicator
boolean

Identifies whether interest paid is reportable.

reportingOptions
Array of strings (InterestReportingOption) [ items [ 1 .. 35 ] characters ]
Example: ["Deposit"]
object (TaxForm)

Information of the form requested by the tax payer.

object

The frequency used in calculating the Regulation DD Annual Percentage Yield (APY) when the financial institution requires interest to be withdrawn (i.e. compounding interest is not an option.) The Regulation DD Compound Frequency overrides the interest frequency only in computing the APY. For example, an account with interest paid monthly by check but disclosed as annual compounding.

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

Annual Percentage Yield (APY) is a measure used in finance to express the total return on an investment, taking into account both the interest earned and the appreciation in the investment's value, over a specified period. It is expressed as a percentage and is often used for fixed income securities such as bonds, and money market accounts.

daysSinceLastAnniversary
integer

The number of calendar days processed since the last anniversary date

Array of objects (InterestCalculationRate)

Rates involve on interest calculation.

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

pastDueOptions
Array of strings[ items [ 1 .. 70 ] characters ]

Indicates how the Past Due Rate is applied to past due loans. After a loan payment is past due after certain days, interest is earned retroactively from the payment due date.

referenceRateName
string

Identifies the reference index for the debt instrument.

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

Margin over or under an index which determines the interest rate of an interest bearing instrument. Percentage to be added to or deducted from the index rate to calculate the effective rate.

spreadRateAmount
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

spreadRatePercentageIndicator
boolean
basisPointSpread
integer

Provides the number of basis points added to (if positive) or deducted from (if negative) the underlying reference rate to calculate the actual interest rate applicable for a given period at issuance of the floating rate instrument. Used to express differences in interest rates, for example, a difference of 0.10% is equivalen

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.

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.

exemptIndicator
boolean

Indicates whether the account is exempt of the charge.

calculationMethodCode
string [ 1 .. 60 ] characters

Servicer charge calculation code. Possible values: FIFO, older payment past due. LIFO, most recent payment past due

calculationMethodOptions
Array of strings[ items [ 1 .. 70 ] characters ]

Indicates other calculation method options for charge calculation.

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, Monthly78th

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.

maximumNumber
integer

Maximum Number of charges.

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

Minimum 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: "033-DDA-123456"

Identification assigned by the account service institution (Servicer). Could be encoded (UUID). Also may be used as composite account identifier when overlaying the account code parts. [branch-type-subtype-number]

object (Frequency)

Specifies an event frequency

Array of objects (Balance)
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, Operator, VRU, Telebanc.

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, NegativeBalance

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

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)
Array
name
string <= 50 characters
Example: "AccountingGroup"

Name of the code. Possible values are: AccountingGroup, CostCenter, DistributionGroup. Also values that may be overlayed on the identification: AccountNumber, AccountSubtype, AccountType. Also MICR numbers: MicrAccountNumber, The account number portion of a draft or line of credit MICR line. Other possible values: TaxIncentiveType, Preferredlanguage.

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 ]
object (AccountBillDetails)

Billing information of the payment

billingDay
integer <= 31
Example: 30

Identifies the day of the month that billing statements are generated.

billOption
string
Example: "Individual"

Indicates whether billing occurs for the account at the company level (consolidated) or at the individual account level. Possible values: Consolidated, Individual.

Array of objects (Balance)

Bill balances

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

Specifies the nature of the balance. Possible values: Current, Available, Pending, Opening, Blocked, Previous, PendingLedger, LastAnniversary, CurrentAccrued, PreviousAccrued, CurrentWithLastCalculus, CarriedAdjustment, PaidWithPenalties, Accrued, Penalty, CollectionLedger, LastLedger, CurrentLedger, Withheld, CurrentBooked, CurrentBook. Loan Balances: CashProceeds, the amount that a customer actually received, exclusive of insurance premiums, fees, and unearned discount; FinancedExpenses, indicates the amount of expenses an institution has financed for a borrower; TotalInterest; AdditionalInterest, if the date of the first payment is beyond one month from the note date, the interest for the odd days will be earned during the first interest period; DeferredUnsecuredPrincipal, is the outstanding balance of an unsecured debt. The DUPB includes any accrued interest that is yet to be paid by the borrower. The deferral typically occurs due to bankruptcy or debt relief proceedings, which temporarily halt collection efforts by the original creditor; Charge Balances: Earned, RealTimeDeliveryMaximum, Current, Financed, Prepaid, CurrentEarned, CurrentEarnedOtherEscrow, InterestPaidToDate, BasePaidToDate, TotalPastDue, Escrow, OtherEscrow, FinalAmount, FinalInterestAmount, Chapter4PreviousYear.

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

count
integer

Number of transactions added to the amount.

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.

periodNumber
integer

Sequence number of the period.

periodName
string (PeriodName)

Time of the year or previous. Possible Values: YearToDate, MonthToDate, PreviousYear, BeginningPreviousYear, QuarterToDate, PreviousQuarter, YearEnd

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.

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

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

Specifies the date and time at which the all the balances amount were calculated.

Array of objects (SpotDate)

Specifies the date and time of transaction events.

Array
name
string (SpotDateName) [ 1 .. 40 ] characters
Example: "Expiration"

Specifies the name of Loan projected date. Possible values por projected dates: Forecast, Expiration, LastNonFinancial

date
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 (Balance)
Array
balanceName
required
string (BalanceName) [ 1 .. 40 ] characters
Example: "Available"

Specifies the nature of the balance. Possible values: Current, Available, Pending, Opening, Blocked, Previous, PendingLedger, LastAnniversary, CurrentAccrued, PreviousAccrued, CurrentWithLastCalculus, CarriedAdjustment, PaidWithPenalties, Accrued, Penalty, CollectionLedger, LastLedger, CurrentLedger, Withheld, CurrentBooked, CurrentBook. Loan Balances: CashProceeds, the amount that a customer actually received, exclusive of insurance premiums, fees, and unearned discount; FinancedExpenses, indicates the amount of expenses an institution has financed for a borrower; TotalInterest; AdditionalInterest, if the date of the first payment is beyond one month from the note date, the interest for the odd days will be earned during the first interest period; DeferredUnsecuredPrincipal, is the outstanding balance of an unsecured debt. The DUPB includes any accrued interest that is yet to be paid by the borrower. The deferral typically occurs due to bankruptcy or debt relief proceedings, which temporarily halt collection efforts by the original creditor; Charge Balances: Earned, RealTimeDeliveryMaximum, Current, Financed, Prepaid, CurrentEarned, CurrentEarnedOtherEscrow, InterestPaidToDate, BasePaidToDate, TotalPastDue, Escrow, OtherEscrow, FinalAmount, FinalInterestAmount, Chapter4PreviousYear.

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

count
integer

Number of transactions added to the amount.

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.

periodNumber
integer

Sequence number of the period.

periodName
string (PeriodName)

Time of the year or previous. Possible Values: YearToDate, MonthToDate, PreviousYear, BeginningPreviousYear, QuarterToDate, PreviousQuarter, YearEnd

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.

plasticCount
integer

Number of plastic cards issued which are associated to the account.

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"
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 (Period)

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

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

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, Operator, VRU, Telebanc.

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 communication 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, Operator, VRU, Telebanc.

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

Maintenance activity of a resource. Possible values: Transaction, Modification, Deposit, Withdrawal, Creation, DirectDeposit, CardActivation, CardActivation, CardActivationByCallerId, CardActivationByCodeAndCallerId.

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.

statusName
string (AccountStatus) [ 1 .. 35 ] characters
Example: "Active"

Specifies the current primary status of an account. Possible values are: Enabled, Dormant, Disable, Deleted, Pending, Form. Pending, Denied, Review, Approve, ChargeOff, Active, PaymentPastDue, Bankruptcy, AuthorizationProhibited, InterestProhibited.

statusDateAndTime
string <date-time> (DateAndTime)
Example: "2022-04-17T08:00:00Z"
reason
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
{
  • "accountBranchId": "SEA_1",
  • "accountNumber": "012345678",
  • "accountType": "Checking",
  • "routingNumbers": [
    ],
  • "identifiers": [
    ],
  • "securedIndicator": true,
  • "securedType": "Collateral",
  • "payment": {
    },
  • "ownershipType": "SingleOwnerAccount",
  • "balanceType": "Asset",
  • "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",
  • "projectedDates": [
    ],
  • "restrictions": [
    ],
  • "limits": [
    ],
  • "statement": {
    },
  • "interests": [
    ],
  • "charges": [
    ],
  • "taxes": [
    ],
  • "communicationChannels": [
    ],
  • "relationshipId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "codes": [
    ],
  • "print": {
    },
  • "bill": {
    },
  • "servicerAlerts": [
    ],
  • "history": {
    },
  • "supplementaryData": { },
  • "ammountCalculationDate": "2022-04-17T08:00:00Z",
  • "transactionDates": [
    ],
  • "balances": [
    ],
  • "plasticCount": 0,
  • "cards": [
    ],
  • "standingOrders": [
    ],
  • "audit": {
    },
  • "status": {
    }
}

Response samples

Content type
{
  • "accountBranchId": "SEA_1",
  • "accountNumber": "012345678",
  • "accountType": "Checking",
  • "routingNumbers": [
    ],
  • "identifiers": [
    ],
  • "securedIndicator": true,
  • "securedType": "Collateral",
  • "payment": {
    },
  • "ownershipType": "SingleOwnerAccount",
  • "balanceType": "Asset",
  • "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",
  • "projectedDates": [
    ],
  • "restrictions": [
    ],
  • "limits": [
    ],
  • "statement": {
    },
  • "interests": [
    ],
  • "charges": [
    ],
  • "taxes": [
    ],
  • "communicationChannels": [
    ],
  • "relationshipId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "codes": [
    ],
  • "print": {
    },
  • "bill": {
    },
  • "servicerAlerts": [
    ],
  • "history": {
    },
  • "supplementaryData": { },
  • "ammountCalculationDate": "2022-04-17T08:00:00Z",
  • "transactionDates": [
    ],
  • "balances": [
    ],
  • "plasticCount": 0,
  • "cards": [
    ],
  • "accountId": "033-DDA-123456",
  • "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: 033-DDA-123456

Account Identification

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

Account Servicer Identification (Bank)

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

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

Core-Validation-Mode
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
{
  • "accountBranchId": "SEA_1",
  • "accountNumber": "012345678",
  • "accountType": "Checking",
  • "routingNumbers": [
    ],
  • "identifiers": [
    ],
  • "securedIndicator": true,
  • "securedType": "Collateral",
  • "payment": {
    },
  • "ownershipType": "SingleOwnerAccount",
  • "balanceType": "Asset",
  • "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",
  • "projectedDates": [
    ],
  • "restrictions": [
    ],
  • "limits": [
    ],
  • "statement": {
    },
  • "interests": [
    ],
  • "charges": [
    ],
  • "taxes": [
    ],
  • "communicationChannels": [
    ],
  • "relationshipId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "codes": [
    ],
  • "print": {
    },
  • "bill": {
    },
  • "servicerAlerts": [
    ],
  • "history": {
    },
  • "supplementaryData": { },
  • "ammountCalculationDate": "2022-04-17T08:00:00Z",
  • "transactionDates": [
    ],
  • "balances": [
    ],
  • "plasticCount": 0,
  • "cards": [
    ],
  • "accountId": "033-DDA-123456",
  • "standingOrders": [
    ],
  • "audit": {
    },
  • "status": {
    }
}

Retrieves Account Balances

Authorizations:
jwtopenIdConnect
path Parameters
accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: 033-DDA-123456

Account Identification

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

Account Servicer Identification (Bank)

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

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

Responses

Response samples

Content type
application/json
{
  • "accountId": "033-DDA-123456",
  • "accountNumber": "012345678",
  • "accountType": "Checking",
  • "ownershipType": "SingleOwnerAccount",
  • "balances": [
    ]
}

Retrieves Account Identifiers

Authorizations:
jwtopenIdConnect
path Parameters
accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: 033-DDA-123456

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
{
  • "accountBranchId": "SEA_1",
  • "accountNumber": "012345678",
  • "accountType": "Checking",
  • "routingNumbers": [
    ],
  • "identifiers": [
    ],
  • "accountId": "033-DDA-123456",
  • "ownershipType": "SingleOwnerAccount"
}

Retrieves Account Parties

Authorizations:
jwtopenIdConnect
path Parameters
accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: 033-DDA-123456

Account Identification

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

Account Servicer Identification (Bank)

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

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

Responses

Response samples

Content type
application/json
{
  • "accountId": "033-DDA-123456",
  • "accountNumber": "012345678",
  • "accountType": "Checking",
  • "ownershipType": "SingleOwnerAccount",
  • "parties": [
    ]
}

Retrieves Account Owners

Authorizations:
jwtopenIdConnect
path Parameters
accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: 033-DDA-123456

Account Identification

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

Account Servicer Identification (Bank)

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

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

Responses

Response samples

Content type
application/json
{
  • "accountId": "033-DDA-123456",
  • "accountNumber": "012345678",
  • "accountType": "Checking",
  • "ownershipType": "SingleOwnerAccount",
  • "owners": [
    ]
}

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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

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

Responses

Response samples

Content type
application/json
{
  • "personId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "personName": "Jane Birkin",
  • "accounts": [
    ]
}

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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

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

Responses

Response samples

Content type
application/json
{
  • "organizationId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "organizationName": "Jane Birkin",
  • "organizationType": "Corporation",
  • "accounts": [
    ]
}

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.

status.eq
string (PartyStatus) [ 1 .. 35 ] characters
Example: status.eq=GoodStanding

Specifies the current primary status of a party. Possible values are: GoodStanding, FraudAlert, BadCustomer, Active, Delinquent, Default, HighRisk, UnderReview.

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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

Identification of the account servicer institution at branch level or center 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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

Identification of the account servicer institution at branch level or center 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, TaxId

issuer
string
Example: "Baltimore"

Entity that assigns the identification.

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

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

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.

verificationDate
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 center level. To overlay the codes to produce a unique identifier the following expresion is used: BranchRegionCode-BranchSubdivisionCode.

customerSinceDate
string <date-time> (DateAndTime)
Example: "2022-04-17T08:00:00Z"
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

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

Type of relation between parties. Possible values Between Organizations and persons are: ResponsibleParty, Owner, ControlPerson, BeneficialOwner, PrimaryContact, SecondaryContact, VicePresident, President, Treasurer, Secretary, Partner. Between Persons and Organizations: Business, Organization. For Trusts: Trustor, Trustee. Between organizations: Subsidiary, ParentOrganization, Branch. Between parties and external entities: AccountOpenningOfficer, CustomerServiceOfficer, PrimaryServicerOfficer, SecondaryServicerOfficer, SalesPerson, ReferralOfficer. Between financial institutions: AffiliateFinancialInstitution, HoldingCompany. Between persons: Spouse, Aunt, Brother, Companion, Daugther, Father, Friend, Granddaugther, Grandmother, Grandfather, Grandson, Husband, Mother, Nephew, Niece, Sister, Son, Uncle, Wife, Child, Grandparent. Grandchild, Sibling, Parent, Partner.

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
addressCode
string

This code is used to identify parties that share the same address or to associate an existing address with a specific party. Providing this code eliminates the need to separately enter the address details.

addressBookIndicator
string

If true, the address is kept in the system even if the person is no longer a customer.

addressType
string
Example: "Postal"

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

addressPurpose
string
Example: "Billing"

Specifies the purpose of an address, in PascalCase form. Possible values are: MailTo, DeliveryTo, Billing, Tax, ForeignTaxRecipient PlaceOfOperation, PlaceOfRegistration, Marketing, Statements, Business, Administrative, PreviousPlace, Headquarter, BranchStore, Property, Military, Secondary, Personal.

primaryIndicator
boolean (PrimaryContactIndicator)

Indicates whether the contact informacion is primary.

careOf
string [ 1 .. 100 ] characters
Example: "C/O Company Name"

Identifies an addressee that is accepting the correspondence for the intended recipient. Using care of ensures the correspondence reaches the right recipient rather than getting returned to the sender.

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-6884"

Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail. In US may consists of two parts: the five-digit ZIP Code '97062' and the ZIP+4 Code '6884'.

carrierRoute
string (CarrierRoute) [ 1 .. 4 ] characters
Example: "C001"

A Carrier Route is a designated geographic area assigned to individual postal carriers by the United States Postal Service (USPS) to facilitate efficient mail delivery within specific regions.

censusTract
string (CensusTract) = 5 characters
Example: "12345"

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

censusBlock
string (CensusBlock) = 4 characters
Example: "1234"

Census blocks are used to partition counties into smaller areas for the purpose of collecting and presenting census data.

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: "San Diego"

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

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

Specific location name within the town.

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

Identifies a subdivision within a country sub-division.

countyName
string [ 1 .. 35 ] characters
Example: "Cook"

Identifies a county 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.

temporaryIndicator
boolean
Example: true

Indicates whether the address is temporary or not.

object

The period of use of the address information.

Array of objects (GenericCode)

Codes related to postal address or internal handling codes asociated with the address. Possible Values: HandlingCode, HandlingCodeOption.

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

Customer principal relationship. This entity 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.

taxReportingIndicator
boolean

Account tax reporting typically involves obtaining and submitting records related to your tax obligations. For individuals, this may include income, qualifying deductions, and investment gains or losses. Businesses, on the other hand, have additional complexities, such as tracking funds directed towards specific business expenses and shareholders.

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

verificationDate
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.

taxStatus
string
Example: "Exempt"

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

exemptionCode
string <= 4
Example: "0"

Indicates the reason why taxes were not withheld from the gross income being reported for a NRA. These codes are used to specify the type of income, the applicable tax treaty, or the Internal Revenue Code section that allows for the exemption from withholding. The use of these codes is subject to certain conditions and limitations, and withholding agents are responsible for verifying the NRA's eligibility for the exemption and for reporting the income and exemption codes accurately to the IRS.

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

Human readable reason why taxes were not withheld.

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.

onFileIndicator
boolean

Indicates weather the bank establish the appropriate tax treatment of any interest or other income earned on the account related to the form.

taxStatus
string
Example: "Exempt"

Exempt, Expired, Certified.

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, NRATax, Chapter3, Chapter4.

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.

taxStatus
string

Exempt, Expired, Certified, Retain.

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.

Array of objects (TaxFormCode)

Codes provided by the IRS on forms.

Array
name
string (TaxFormName) [ 1 .. 35 ] characters

Indicates a code name provided by the IRS on the form. Possible Values: Chapter3, Chapter4, Income, Exempt, Province, CountryResidence, AmendedNumber, CountryTax

code
string <= 3

Indicates the code number 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

Code provided by the IRS on forms.

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

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

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 <= 2 characters

IRS country code table.

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.

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: "San Diego"

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

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

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

object (PersonContactDetails)

Specifies the contact details of a person.

object (StructuredName)

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

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

Preferred name to contact the person

Array of objects (Phone)
Array of objects (Email)
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)
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, Operator, VRU, Telebanc.

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, Default.

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: "033-DDA-123456"

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, Operator, VRU, Telebanc.

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 communication 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, Operator, VRU, Telebanc.

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

Maintenance activity of a resource. Possible values: Transaction, Modification, Deposit, Withdrawal, Creation, DirectDeposit, CardActivation, CardActivation, CardActivationByCallerId, CardActivationByCodeAndCallerId.

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: TransferIn, TransferOut, WireTransferIn, WireTransferOut, ACHTransferIn, ACHTransferOut, ForeignIncomingWires, ForeignOutgoingWires, ACHTransfers, InternetBankingTransfer, InternetView, InternetInquiry, ForeignOutgoingIran, Withdrawals, Renew, Transfers, AdvanceTransfer

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

Indicates whether the capability is allowed or not.

disableConditions
Array of strings (ConditionName) [ items [ 1 .. 36 ] characters ]
Example: ["Pending"]

Conditions that disabel the restriction.

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.

status
string (RestrictionStatus) [ 1 .. 36 ] characters
Example: "Pending"

Specifies the status of a restriction enablement request. Possible values: Active, Pending.

Array of objects (GenericCode)

Codes to clasify parties. Possible code names: Priority.

Array
name
string [ 1 .. 50 ] characters
Example: "Incoming Wire"

Name of the code in PascalCase.

value
string [ 1 .. 35 ] characters
Example: "195"

Code value to identify the type of transaction.

webPage
string^[(http(s)?):\/\/(www\.)?a-zA-Z0-9@:%._\+~#=]...
Example: "http://portx.io"

Party web page

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: "San Diego"

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

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.

country
string (CountryCallingCode) <= 3 characters

Country calling codes, country dial-in codes, international subscriber dialing (ISD) codes, or most commonly, telephone country codes. Country codes are defined by the International Telecommunication Union (ITU) in ITU-T standards E.123 and E.164. The prefixes enable international direct dialing (IDD).

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 (TimeOfTheDay)
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, Personal

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, Operator, VRU, Telebanc.

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, NegativeBalance

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

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, Operator, VRU, Telebanc.

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, Default.

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, NativeHawaiian, NativeAlaskan, Mixed.

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.

educationLevel
string (EducationLevel) [ 1 .. 35 ] characters
Example: null

Possible education levels: NoFormalEducation, ElementarySchool, MiddleSchool, HighSchool, VocationalSchool, AssociateDegree, BachelorDegree, MasterDegree, DoctorateDegree, ProfessionalDegree, LessThanHighSchool, College

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

Residential status of an individual. Possible values: Rents, Owns, Lease.

immigrationStatus
string (ImmigrationStatus) [ 1 .. 35 ] characters
Example: "Permanent"

Immigration status of an individual. Possible values: Resident, NonResident, ResidentAlien, NonResidentAlien.

minorIndicator
boolean (MinorIndicator)

Indicates whether the person is a legal minor.

Array of objects (Citizenship)
Array
periodNumber
integer

Sequence number of the period.

periodName
string (PeriodName)

Time of the year or previous. Possible Values: YearToDate, MonthToDate, PreviousYear, BeginningPreviousYear, QuarterToDate, PreviousQuarter, YearEnd

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.

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.

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

Array of objects (CreditRankingScale)
creditReportAddressIndicatorCode
string

is a code or marker used by credit reporting agencies to indicate a match or mismatch between the address supplied in an inquiry and the address they have on file for a consumer.

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

Information provided by the Consumer Credit Report.

consumerCreditReportDate
string <date-time> (DateAndTime)
Example: "2022-04-17T08:00:00Z"
creditBureauReportCode
string
Example: "30"

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.

eCOACode
string

The ECOA code indicates how customer account information is reported to the Credit Bureau in keeping with the Equal Credit Opportunity Act.

cTRExemptIndicator
boolean

Currency transaction report (CTR) exemption. A CTR is a report that must be filed by banks for any transaction involving currency of $10,000 or more. However, certain entities and transactions are exempt from this reporting requirement.

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

customerType
string (CustomerType)
Example: "Consumer"

A customer type of a bank account can be classified into different categories based on the account's features, purpose, and benefits. Possible Values: Personal, Business, Consumer, Organization, ThirdParty.

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.

militaryMemberIndicator
boolean

Indicates whether the person is is service member/military.

object (DatePeriod)
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.

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 (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

employmentStatus
string (EmploymentStatus)

Represents available individual employment status. Possible values: Contract, Employed, Homemaker, Retired, SelfEmployed, Student, Temporary, Unemployed, BankEmployed.

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.

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

Professional Designation or name of the occupation of a person.

employmentStatus
string

Possible Values: Contract, Employed, Homemaker, Retired, SelfEmployed, Student, Temporary, Unemployed, BankEmployed, FullTime, PartTime, PaidLeave.

object

Indicates an internal code used by the bank to determine a profession description.

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 .

insiderType
string (InsiderType) [ 1 .. 35 ] characters
Example: "Director"

The insider type 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. Possible values: Director, Employee, Officer, PrincipalShareholder, Shareholder, Executive, ServiceCorporationEmployee, Child, Spouse, Parent, Relative, AffiliateFinancialInstitution, HoldingCompany, MainShareHolder, RelationshipInterest.

employeeIndicator
boolean

Indicates whether is a bank employer.

annualIncome
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

monthlyIncome
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

grossMonthPayAmount
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

netMonthPayAmount
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

monthPayDate
string <date-time> (DateAndTime)
Example: "2022-04-17T08:00:00Z"
yearsOfEducation
integer
politicallyExposedPerson
boolean
Example: true

Indicates whether 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 [ 1 .. 1025 ] characters
Example: "This is a description."

The text with the question.

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

Unique identifier of the security question used to identify the customer. Possible values: PlaceOfBirth, County, FavoriteColor, FavoriteNumber, FavoriteDate.

identityQuestionType
string (IdentityQuestionType) <= 130 characters
Example: "FavoriteColor"

Security questions. Possible Values: MotherMaidenName, CityOfBirth, HighSchoolName, FatherMiddleName, SchoolMascot, ResidenceCounty, MotherBirthMonth, 1stEmployerName, ElementarySchoolName, 1stChildMiddleName, PetName, AnniversaryDate, ResidenceCityIn2000, FirstCar, FavoriteArtist, FavoriteColor, FavoriteHobby, FavoriteMovie, FavoriteSportTeam, FavoriteTeacher

answer
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
message
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
coveredByMilitaryLendingActIndicator
boolean

Indicates if the borrower is covered under the Military Lending Act.

Responses

Request samples

Content type
application/json
{
  • "uSDocumentedIndicator": true,
  • "identifiers": [
    ],
  • "name": "Jane Birkin",
  • "shortName": "Jane",
  • "nameTemplateId": "1",
  • "nameSoundExId": "1",
  • "partyBranchId": "SEA_1",
  • "customerSinceDate": "2022-04-17T08:00:00Z",
  • "comment": "This is a description.",
  • "relatedParties": [
    ],
  • "postalAddresses": [
    ],
  • "relationshipId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "relationshipLeadIndicator": true,
  • "residenceType": "Domestic",
  • "taxInformation": {
    },
  • "powerOfAttorney": {
    },
  • "supplementaryData": { },
  • "excludeMarketingIndicator": true,
  • "audit": {
    },
  • "restrictions": [
    ],
  • "codes": [
    ],
  • "webPage": "http://portx.io",
  • "placeAndDateOfBirth": {
    },
  • "signature": {
    },
  • "signatureVerificationId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "contact": {
    },
  • "headOfHousehold": true,
  • "civilStatus": "Single",
  • "structuredName": {
    },
  • "gender": "Female",
  • "race": "Director",
  • "profession": "Artist",
  • "jobTitle": "Head of Documentation",
  • "educationLevel": null,
  • "residentialStatus": "Permanent",
  • "immigrationStatus": "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",
  • "customerSinceDate": "2022-04-17T08:00:00Z",
  • "comment": "This is a description.",
  • "relatedParties": [
    ],
  • "postalAddresses": [
    ],
  • "relationshipId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "relationshipLeadIndicator": true,
  • "residenceType": "Domestic",
  • "taxInformation": {
    },
  • "powerOfAttorney": {
    },
  • "supplementaryData": { },
  • "excludeMarketingIndicator": true,
  • "audit": {
    },
  • "restrictions": [
    ],
  • "codes": [
    ],
  • "webPage": "http://portx.io",
  • "placeAndDateOfBirth": {
    },
  • "signature": {
    },
  • "signatureVerificationId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "contact": {
    },
  • "headOfHousehold": true,
  • "civilStatus": "Single",
  • "structuredName": {
    },
  • "gender": "Female",
  • "race": "Director",
  • "profession": "Artist",
  • "jobTitle": "Head of Documentation",
  • "educationLevel": null,
  • "residentialStatus": "Permanent",
  • "immigrationStatus": "Permanent",
  • "minorIndicator": true,
  • "citizenships": [
    ],
  • "countryOfResidence": "US",
  • "profile": {
    },
  • "personId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "status": "GoodStanding"
}

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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

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

Responses

Response samples

Content type
application/json
{
  • "uSDocumentedIndicator": true,
  • "identifiers": [
    ],
  • "name": "Jane Birkin",
  • "shortName": "Jane",
  • "nameTemplateId": "1",
  • "nameSoundExId": "1",
  • "partyBranchId": "SEA_1",
  • "customerSinceDate": "2022-04-17T08:00:00Z",
  • "comment": "This is a description.",
  • "relatedParties": [
    ],
  • "postalAddresses": [
    ],
  • "relationshipId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "relationshipLeadIndicator": true,
  • "residenceType": "Domestic",
  • "taxInformation": {
    },
  • "powerOfAttorney": {
    },
  • "supplementaryData": { },
  • "excludeMarketingIndicator": true,
  • "audit": {
    },
  • "restrictions": [
    ],
  • "codes": [
    ],
  • "webPage": "http://portx.io",
  • "placeAndDateOfBirth": {
    },
  • "signature": {
    },
  • "signatureVerificationId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "contact": {
    },
  • "headOfHousehold": true,
  • "civilStatus": "Single",
  • "structuredName": {
    },
  • "gender": "Female",
  • "race": "Director",
  • "profession": "Artist",
  • "jobTitle": "Head of Documentation",
  • "educationLevel": null,
  • "residentialStatus": "Permanent",
  • "immigrationStatus": "Permanent",
  • "minorIndicator": true,
  • "citizenships": [
    ],
  • "countryOfResidence": "US",
  • "profile": {
    },
  • "personId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "status": "GoodStanding"
}

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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

Identification of the account servicer institution at branch level or center 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, TaxId

issuer
string
Example: "Baltimore"

Entity that assigns the identification.

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

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

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.

verificationDate
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 center level. To overlay the codes to produce a unique identifier the following expresion is used: BranchRegionCode-BranchSubdivisionCode.

customerSinceDate
string <date-time> (DateAndTime)
Example: "2022-04-17T08:00:00Z"
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

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

Type of relation between parties. Possible values Between Organizations and persons are: ResponsibleParty, Owner, ControlPerson, BeneficialOwner, PrimaryContact, SecondaryContact, VicePresident, President, Treasurer, Secretary, Partner. Between Persons and Organizations: Business, Organization. For Trusts: Trustor, Trustee. Between organizations: Subsidiary, ParentOrganization, Branch. Between parties and external entities: AccountOpenningOfficer, CustomerServiceOfficer, PrimaryServicerOfficer, SecondaryServicerOfficer, SalesPerson, ReferralOfficer. Between financial institutions: AffiliateFinancialInstitution, HoldingCompany. Between persons: Spouse, Aunt, Brother, Companion, Daugther, Father, Friend, Granddaugther, Grandmother, Grandfather, Grandson, Husband, Mother, Nephew, Niece, Sister, Son, Uncle, Wife, Child, Grandparent. Grandchild, Sibling, Parent, Partner.

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
addressCode
string

This code is used to identify parties that share the same address or to associate an existing address with a specific party. Providing this code eliminates the need to separately enter the address details.

addressBookIndicator
string

If true, the address is kept in the system even if the person is no longer a customer.

addressType
string
Example: "Postal"

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

addressPurpose
string
Example: "Billing"

Specifies the purpose of an address, in PascalCase form. Possible values are: MailTo, DeliveryTo, Billing, Tax, ForeignTaxRecipient PlaceOfOperation, PlaceOfRegistration, Marketing, Statements, Business, Administrative, PreviousPlace, Headquarter, BranchStore, Property, Military, Secondary, Personal.

primaryIndicator
boolean (PrimaryContactIndicator)

Indicates whether the contact informacion is primary.

careOf
string [ 1 .. 100 ] characters
Example: "C/O Company Name"

Identifies an addressee that is accepting the correspondence for the intended recipient. Using care of ensures the correspondence reaches the right recipient rather than getting returned to the sender.

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-6884"

Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail. In US may consists of two parts: the five-digit ZIP Code '97062' and the ZIP+4 Code '6884'.

carrierRoute
string (CarrierRoute) [ 1 .. 4 ] characters
Example: "C001"

A Carrier Route is a designated geographic area assigned to individual postal carriers by the United States Postal Service (USPS) to facilitate efficient mail delivery within specific regions.

censusTract
string (CensusTract) = 5 characters
Example: "12345"

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

censusBlock
string (CensusBlock) = 4 characters
Example: "1234"

Census blocks are used to partition counties into smaller areas for the purpose of collecting and presenting census data.

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: "San Diego"

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

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

Specific location name within the town.

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

Identifies a subdivision within a country sub-division.

countyName
string [ 1 .. 35 ] characters
Example: "Cook"

Identifies a county 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.

temporaryIndicator
boolean
Example: true

Indicates whether the address is temporary or not.

object

The period of use of the address information.

Array of objects (GenericCode)

Codes related to postal address or internal handling codes asociated with the address. Possible Values: HandlingCode, HandlingCodeOption.

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

Customer principal relationship. This entity 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.

taxReportingIndicator
boolean

Account tax reporting typically involves obtaining and submitting records related to your tax obligations. For individuals, this may include income, qualifying deductions, and investment gains or losses. Businesses, on the other hand, have additional complexities, such as tracking funds directed towards specific business expenses and shareholders.

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

verificationDate
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.

taxStatus
string
Example: "Exempt"

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

exemptionCode
string <= 4
Example: "0"

Indicates the reason why taxes were not withheld from the gross income being reported for a NRA. These codes are used to specify the type of income, the applicable tax treaty, or the Internal Revenue Code section that allows for the exemption from withholding. The use of these codes is subject to certain conditions and limitations, and withholding agents are responsible for verifying the NRA's eligibility for the exemption and for reporting the income and exemption codes accurately to the IRS.

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

Human readable reason why taxes were not withheld.

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.

onFileIndicator
boolean

Indicates weather the bank establish the appropriate tax treatment of any interest or other income earned on the account related to the form.

taxStatus
string
Example: "Exempt"

Exempt, Expired, Certified.

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, NRATax, Chapter3, Chapter4.

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.

taxStatus
string

Exempt, Expired, Certified, Retain.

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.

Array of objects (TaxFormCode)

Codes provided by the IRS on forms.

Array
name
string (TaxFormName) [ 1 .. 35 ] characters

Indicates a code name provided by the IRS on the form. Possible Values: Chapter3, Chapter4, Income, Exempt, Province, CountryResidence, AmendedNumber, CountryTax

code
string <= 3

Indicates the code number 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

Code provided by the IRS on forms.

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

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

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 <= 2 characters

IRS country code table.

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.

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: "San Diego"

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

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

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

object (PersonContactDetails)

Specifies the contact details of a person.

object (StructuredName)

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

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

Preferred name to contact the person

Array of objects (Phone)
Array of objects (Email)
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)
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, Operator, VRU, Telebanc.

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, Default.

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: "033-DDA-123456"

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, Operator, VRU, Telebanc.

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 communication 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, Operator, VRU, Telebanc.

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

Maintenance activity of a resource. Possible values: Transaction, Modification, Deposit, Withdrawal, Creation, DirectDeposit, CardActivation, CardActivation, CardActivationByCallerId, CardActivationByCodeAndCallerId.

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: TransferIn, TransferOut, WireTransferIn, WireTransferOut, ACHTransferIn, ACHTransferOut, ForeignIncomingWires, ForeignOutgoingWires, ACHTransfers, InternetBankingTransfer, InternetView, InternetInquiry, ForeignOutgoingIran, Withdrawals, Renew, Transfers, AdvanceTransfer

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

Indicates whether the capability is allowed or not.

disableConditions
Array of strings (ConditionName) [ items [ 1 .. 36 ] characters ]
Example: ["Pending"]

Conditions that disabel the restriction.

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.

status
string (RestrictionStatus) [ 1 .. 36 ] characters
Example: "Pending"

Specifies the status of a restriction enablement request. Possible values: Active, Pending.

Array of objects (GenericCode)

Codes to clasify parties. Possible code names: Priority.

Array
name
string [ 1 .. 50 ] characters
Example: "Incoming Wire"

Name of the code in PascalCase.

value
string [ 1 .. 35 ] characters
Example: "195"

Code value to identify the type of transaction.

webPage
string^[(http(s)?):\/\/(www\.)?a-zA-Z0-9@:%._\+~#=]...
Example: "http://portx.io"

Party web page

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: "San Diego"

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

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.

country
string (CountryCallingCode) <= 3 characters

Country calling codes, country dial-in codes, international subscriber dialing (ISD) codes, or most commonly, telephone country codes. Country codes are defined by the International Telecommunication Union (ITU) in ITU-T standards E.123 and E.164. The prefixes enable international direct dialing (IDD).

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 (TimeOfTheDay)
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, Personal

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, Operator, VRU, Telebanc.

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, NegativeBalance

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

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, Operator, VRU, Telebanc.

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, Default.

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, NativeHawaiian, NativeAlaskan, Mixed.

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.

educationLevel
string (EducationLevel) [ 1 .. 35 ] characters
Example: null

Possible education levels: NoFormalEducation, ElementarySchool, MiddleSchool, HighSchool, VocationalSchool, AssociateDegree, BachelorDegree, MasterDegree, DoctorateDegree, ProfessionalDegree, LessThanHighSchool, College

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

Residential status of an individual. Possible values: Rents, Owns, Lease.

immigrationStatus
string (ImmigrationStatus) [ 1 .. 35 ] characters
Example: "Permanent"

Immigration status of an individual. Possible values: Resident, NonResident, ResidentAlien, NonResidentAlien.

minorIndicator
boolean (MinorIndicator)

Indicates whether the person is a legal minor.

Array of objects (Citizenship)
Array
periodNumber
integer

Sequence number of the period.

periodName
string (PeriodName)

Time of the year or previous. Possible Values: YearToDate, MonthToDate, PreviousYear, BeginningPreviousYear, QuarterToDate, PreviousQuarter, YearEnd

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.

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.

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

Array of objects (CreditRankingScale)
creditReportAddressIndicatorCode
string

is a code or marker used by credit reporting agencies to indicate a match or mismatch between the address supplied in an inquiry and the address they have on file for a consumer.

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

Information provided by the Consumer Credit Report.

consumerCreditReportDate
string <date-time> (DateAndTime)
Example: "2022-04-17T08:00:00Z"
creditBureauReportCode
string
Example: "30"

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.

eCOACode
string

The ECOA code indicates how customer account information is reported to the Credit Bureau in keeping with the Equal Credit Opportunity Act.

cTRExemptIndicator
boolean

Currency transaction report (CTR) exemption. A CTR is a report that must be filed by banks for any transaction involving currency of $10,000 or more. However, certain entities and transactions are exempt from this reporting requirement.

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

customerType
string (CustomerType)
Example: "Consumer"

A customer type of a bank account can be classified into different categories based on the account's features, purpose, and benefits. Possible Values: Personal, Business, Consumer, Organization, ThirdParty.

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.

militaryMemberIndicator
boolean

Indicates whether the person is is service member/military.

object (DatePeriod)
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.

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 (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

employmentStatus
string (EmploymentStatus)

Represents available individual employment status. Possible values: Contract, Employed, Homemaker, Retired, SelfEmployed, Student, Temporary, Unemployed, BankEmployed.

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.

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

Professional Designation or name of the occupation of a person.

employmentStatus
string

Possible Values: Contract, Employed, Homemaker, Retired, SelfEmployed, Student, Temporary, Unemployed, BankEmployed, FullTime, PartTime, PaidLeave.

object

Indicates an internal code used by the bank to determine a profession description.

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 .

insiderType
string (InsiderType) [ 1 .. 35 ] characters
Example: "Director"

The insider type 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. Possible values: Director, Employee, Officer, PrincipalShareholder, Shareholder, Executive, ServiceCorporationEmployee, Child, Spouse, Parent, Relative, AffiliateFinancialInstitution, HoldingCompany, MainShareHolder, RelationshipInterest.

employeeIndicator
boolean

Indicates whether is a bank employer.

annualIncome
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

monthlyIncome
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

grossMonthPayAmount
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

netMonthPayAmount
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

monthPayDate
string <date-time> (DateAndTime)
Example: "2022-04-17T08:00:00Z"
yearsOfEducation
integer
politicallyExposedPerson
boolean
Example: true

Indicates whether 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 [ 1 .. 1025 ] characters
Example: "This is a description."

The text with the question.

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

Unique identifier of the security question used to identify the customer. Possible values: PlaceOfBirth, County, FavoriteColor, FavoriteNumber, FavoriteDate.

identityQuestionType
string (IdentityQuestionType) <= 130 characters
Example: "FavoriteColor"

Security questions. Possible Values: MotherMaidenName, CityOfBirth, HighSchoolName, FatherMiddleName, SchoolMascot, ResidenceCounty, MotherBirthMonth, 1stEmployerName, ElementarySchoolName, 1stChildMiddleName, PetName, AnniversaryDate, ResidenceCityIn2000, FirstCar, FavoriteArtist, FavoriteColor, FavoriteHobby, FavoriteMovie, FavoriteSportTeam, FavoriteTeacher

answer
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
message
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
coveredByMilitaryLendingActIndicator
boolean

Indicates if the borrower is covered under the Military Lending Act.

status
string (PartyStatus) [ 1 .. 35 ] characters
Example: "GoodStanding"

Specifies the current primary status of a party. Possible values are: GoodStanding, FraudAlert, BadCustomer, Active, Delinquent, Default, HighRisk, UnderReview.

Responses

Request samples

Content type
application/merge-patch+json
{
  • "uSDocumentedIndicator": true,
  • "identifiers": [
    ],
  • "name": "Jane Birkin",
  • "shortName": "Jane",
  • "nameTemplateId": "1",
  • "nameSoundExId": "1",
  • "partyBranchId": "SEA_1",
  • "customerSinceDate": "2022-04-17T08:00:00Z",
  • "comment": "This is a description.",
  • "relatedParties": [
    ],
  • "postalAddresses": [
    ],
  • "relationshipId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "relationshipLeadIndicator": true,
  • "residenceType": "Domestic",
  • "taxInformation": {
    },
  • "powerOfAttorney": {
    },
  • "supplementaryData": { },
  • "excludeMarketingIndicator": true,
  • "audit": {
    },
  • "restrictions": [
    ],
  • "codes": [
    ],
  • "webPage": "http://portx.io",
  • "placeAndDateOfBirth": {
    },
  • "signature": {
    },
  • "signatureVerificationId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "contact": {
    },
  • "headOfHousehold": true,
  • "civilStatus": "Single",
  • "structuredName": {
    },
  • "gender": "Female",
  • "race": "Director",
  • "profession": "Artist",
  • "jobTitle": "Head of Documentation",
  • "educationLevel": null,
  • "residentialStatus": "Permanent",
  • "immigrationStatus": "Permanent",
  • "minorIndicator": true,
  • "citizenships": [
    ],
  • "countryOfResidence": "US",
  • "profile": {
    },
  • "status": "GoodStanding"
}

Response samples

Content type
application/json
{
  • "uSDocumentedIndicator": true,
  • "identifiers": [
    ],
  • "name": "Jane Birkin",
  • "shortName": "Jane",
  • "nameTemplateId": "1",
  • "nameSoundExId": "1",
  • "partyBranchId": "SEA_1",
  • "customerSinceDate": "2022-04-17T08:00:00Z",
  • "comment": "This is a description.",
  • "relatedParties": [
    ],
  • "postalAddresses": [
    ],
  • "relationshipId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "relationshipLeadIndicator": true,
  • "residenceType": "Domestic",
  • "taxInformation": {
    },
  • "powerOfAttorney": {
    },
  • "supplementaryData": { },
  • "excludeMarketingIndicator": true,
  • "audit": {
    },
  • "restrictions": [
    ],
  • "codes": [
    ],
  • "webPage": "http://portx.io",
  • "placeAndDateOfBirth": {
    },
  • "signature": {
    },
  • "signatureVerificationId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "contact": {
    },
  • "headOfHousehold": true,
  • "civilStatus": "Single",
  • "structuredName": {
    },
  • "gender": "Female",
  • "race": "Director",
  • "profession": "Artist",
  • "jobTitle": "Head of Documentation",
  • "educationLevel": null,
  • "residentialStatus": "Permanent",
  • "immigrationStatus": "Permanent",
  • "minorIndicator": true,
  • "citizenships": [
    ],
  • "countryOfResidence": "US",
  • "profile": {
    },
  • "personId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "status": "GoodStanding"
}

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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

Identification of the account servicer institution at branch level or center 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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

Identification of the account servicer institution at branch level or center 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 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 center level. To overlay the codes to produce a unique identifier the following expresion is used: BranchRegionCode-BranchSubdivisionCode.

customerSinceDate
string <date-time> (DateAndTime)
Example: "2022-04-17T08:00:00Z"
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

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

Type of relation between parties. Possible values Between Organizations and persons are: ResponsibleParty, Owner, ControlPerson, BeneficialOwner, PrimaryContact, SecondaryContact, VicePresident, President, Treasurer, Secretary, Partner. Between Persons and Organizations: Business, Organization. For Trusts: Trustor, Trustee. Between organizations: Subsidiary, ParentOrganization, Branch. Between parties and external entities: AccountOpenningOfficer, CustomerServiceOfficer, PrimaryServicerOfficer, SecondaryServicerOfficer, SalesPerson, ReferralOfficer. Between financial institutions: AffiliateFinancialInstitution, HoldingCompany. Between persons: Spouse, Aunt, Brother, Companion, Daugther, Father, Friend, Granddaugther, Grandmother, Grandfather, Grandson, Husband, Mother, Nephew, Niece, Sister, Son, Uncle, Wife, Child, Grandparent. Grandchild, Sibling, Parent, Partner.

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
addressCode
string

This code is used to identify parties that share the same address or to associate an existing address with a specific party. Providing this code eliminates the need to separately enter the address details.

addressBookIndicator
string

If true, the address is kept in the system even if the person is no longer a customer.

addressType
string
Example: "Postal"

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

addressPurpose
string
Example: "Billing"

Specifies the purpose of an address, in PascalCase form. Possible values are: MailTo, DeliveryTo, Billing, Tax, ForeignTaxRecipient PlaceOfOperation, PlaceOfRegistration, Marketing, Statements, Business, Administrative, PreviousPlace, Headquarter, BranchStore, Property, Military, Secondary, Personal.

primaryIndicator
boolean (PrimaryContactIndicator)

Indicates whether the contact informacion is primary.

careOf
string [ 1 .. 100 ] characters
Example: "C/O Company Name"

Identifies an addressee that is accepting the correspondence for the intended recipient. Using care of ensures the correspondence reaches the right recipient rather than getting returned to the sender.

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-6884"

Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail. In US may consists of two parts: the five-digit ZIP Code '97062' and the ZIP+4 Code '6884'.

carrierRoute
string (CarrierRoute) [ 1 .. 4 ] characters
Example: "C001"

A Carrier Route is a designated geographic area assigned to individual postal carriers by the United States Postal Service (USPS) to facilitate efficient mail delivery within specific regions.

censusTract
string (CensusTract) = 5 characters
Example: "12345"

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

censusBlock
string (CensusBlock) = 4 characters
Example: "1234"

Census blocks are used to partition counties into smaller areas for the purpose of collecting and presenting census data.

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: "San Diego"

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

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

Specific location name within the town.

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

Identifies a subdivision within a country sub-division.

countyName
string [ 1 .. 35 ] characters
Example: "Cook"

Identifies a county 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.

temporaryIndicator
boolean
Example: true

Indicates whether the address is temporary or not.

object

The period of use of the address information.

Array of objects (GenericCode)

Codes related to postal address or internal handling codes asociated with the address. Possible Values: HandlingCode, HandlingCodeOption.

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

Customer principal relationship. This entity 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.

taxReportingIndicator
boolean

Account tax reporting typically involves obtaining and submitting records related to your tax obligations. For individuals, this may include income, qualifying deductions, and investment gains or losses. Businesses, on the other hand, have additional complexities, such as tracking funds directed towards specific business expenses and shareholders.

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

verificationDate
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.

taxStatus
string
Example: "Exempt"

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

exemptionCode
string <= 4
Example: "0"

Indicates the reason why taxes were not withheld from the gross income being reported for a NRA. These codes are used to specify the type of income, the applicable tax treaty, or the Internal Revenue Code section that allows for the exemption from withholding. The use of these codes is subject to certain conditions and limitations, and withholding agents are responsible for verifying the NRA's eligibility for the exemption and for reporting the income and exemption codes accurately to the IRS.

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

Human readable reason why taxes were not withheld.

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.

onFileIndicator
boolean

Indicates weather the bank establish the appropriate tax treatment of any interest or other income earned on the account related to the form.

taxStatus
string
Example: "Exempt"

Exempt, Expired, Certified.

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, NRATax, Chapter3, Chapter4.

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.

taxStatus
string

Exempt, Expired, Certified, Retain.

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.

Array of objects (TaxFormCode)

Codes provided by the IRS on forms.

Array
name
string (TaxFormName) [ 1 .. 35 ] characters

Indicates a code name provided by the IRS on the form. Possible Values: Chapter3, Chapter4, Income, Exempt, Province, CountryResidence, AmendedNumber, CountryTax

code
string <= 3

Indicates the code number 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

Code provided by the IRS on forms.

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

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

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 <= 2 characters

IRS country code table.

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.

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: "San Diego"

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

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

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

object (PersonContactDetails)

Specifies the contact details of a person.

object (StructuredName)

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

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

Preferred name to contact the person

Array of objects (Phone)
Array of objects (Email)
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)
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, Operator, VRU, Telebanc.

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, Default.

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: "033-DDA-123456"

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, Operator, VRU, Telebanc.

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 communication 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, Operator, VRU, Telebanc.

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

Maintenance activity of a resource. Possible values: Transaction, Modification, Deposit, Withdrawal, Creation, DirectDeposit, CardActivation, CardActivation, CardActivationByCallerId, CardActivationByCodeAndCallerId.

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: TransferIn, TransferOut, WireTransferIn, WireTransferOut, ACHTransferIn, ACHTransferOut, ForeignIncomingWires, ForeignOutgoingWires, ACHTransfers, InternetBankingTransfer, InternetView, InternetInquiry, ForeignOutgoingIran, Withdrawals, Renew, Transfers, AdvanceTransfer

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

Indicates whether the capability is allowed or not.

disableConditions
Array of strings (ConditionName) [ items [ 1 .. 36 ] characters ]
Example: ["Pending"]

Conditions that disabel the restriction.

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.

status
string (RestrictionStatus) [ 1 .. 36 ] characters
Example: "Pending"

Specifies the status of a restriction enablement request. Possible values: Active, Pending.

Array of objects (GenericCode)

Codes to clasify parties. Possible code names: Priority.

Array
name
string [ 1 .. 50 ] characters
Example: "Incoming Wire"

Name of the code in PascalCase.

value
string [ 1 .. 35 ] characters
Example: "195"

Code value to identify the type of transaction.

webPage
string^[(http(s)?):\/\/(www\.)?a-zA-Z0-9@:%._\+~#=]...
Example: "http://portx.io"

Party web page

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, PublicAgency, Association, Church.

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.

lineOfBusiness
string [ 1 .. 35 ] characters

The line of business refers to the specific industry or market segment that a company operates. This helps to further define the target market and focus marketing efforts on reaching and serving the needs of that specific group. Possible Values: ConsumerGoods, ConsumerCervices, SmallBusiness, Corporate.

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.

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

Array of objects (CreditRankingScale)
creditReportAddressIndicatorCode
string

is a code or marker used by credit reporting agencies to indicate a match or mismatch between the address supplied in an inquiry and the address they have on file for a consumer.

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

Information provided by the Consumer Credit Report.

consumerCreditReportDate
string <date-time> (DateAndTime)
Example: "2022-04-17T08:00:00Z"
creditBureauReportCode
string
Example: "30"

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.

eCOACode
string

The ECOA code indicates how customer account information is reported to the Credit Bureau in keeping with the Equal Credit Opportunity Act.

cTRExemptIndicator
boolean

Currency transaction report (CTR) exemption. A CTR is a report that must be filed by banks for any transaction involving currency of $10,000 or more. However, certain entities and transactions are exempt from this reporting requirement.

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

customerType
string (CustomerType)
Example: "Consumer"

A customer type of a bank account can be classified into different categories based on the account's features, purpose, and benefits. Possible Values: Personal, Business, Consumer, Organization, ThirdParty.

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.

annualSales
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: "San Diego"

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

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.

country
string (CountryCallingCode) <= 3 characters

Country calling codes, country dial-in codes, international subscriber dialing (ISD) codes, or most commonly, telephone country codes. Country codes are defined by the International Telecommunication Union (ITU) in ITU-T standards E.123 and E.164. The prefixes enable international direct dialing (IDD).

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 (TimeOfTheDay)
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, Personal

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, Operator, VRU, Telebanc.

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, NegativeBalance

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

primaryIndicator
boolean (PrimaryContactIndicator)

Indicates whether the contact informacion is primary.

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, Default.

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",
  • "customerSinceDate": "2022-04-17T08:00:00Z",
  • "comment": "This is a description.",
  • "relatedParties": [
    ],
  • "postalAddresses": [
    ],
  • "relationshipId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "relationshipLeadIndicator": true,
  • "residenceType": "Domestic",
  • "taxInformation": {
    },
  • "powerOfAttorney": {
    },
  • "supplementaryData": { },
  • "excludeMarketingIndicator": true,
  • "audit": {
    },
  • "restrictions": [
    ],
  • "codes": [
    ],
  • "webPage": "http://portx.io",
  • "organizationType": "Corporation",
  • "organizationPurpose": "This is a description.",
  • "legalName": "Jane",
  • "tradingName": "Jane",
  • "registrationDate": "2022-04-17",
  • "establishmentDate": "2022-04-17",
  • "merchantCategory": "482",
  • "nAICSCode": "54",
  • "lineOfBusiness": "string",
  • "sector": "string",
  • "organizationProfile": {
    },
  • "contact": {
    },
  • "logo": {
    }
}

Response samples

Content type
application/json
{
  • "identifiers": [
    ],
  • "name": "Jane Birkin",
  • "shortName": "Jane",
  • "nameTemplateId": "1",
  • "nameSoundExId": "1",
  • "partyBranchId": "SEA_1",
  • "customerSinceDate": "2022-04-17T08:00:00Z",
  • "comment": "This is a description.",
  • "relatedParties": [
    ],
  • "postalAddresses": [
    ],
  • "relationshipId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "relationshipLeadIndicator": true,
  • "residenceType": "Domestic",
  • "taxInformation": {
    },
  • "powerOfAttorney": {
    },
  • "supplementaryData": { },
  • "excludeMarketingIndicator": true,
  • "audit": {
    },
  • "restrictions": [
    ],
  • "codes": [
    ],
  • "webPage": "http://portx.io",
  • "organizationType": "Corporation",
  • "organizationPurpose": "This is a description.",
  • "legalName": "Jane",
  • "tradingName": "Jane",
  • "registrationDate": "2022-04-17",
  • "establishmentDate": "2022-04-17",
  • "merchantCategory": "482",
  • "nAICSCode": "54",
  • "lineOfBusiness": "string",
  • "sector": "string",
  • "organizationProfile": {
    },
  • "contact": {
    },
  • "logo": {
    },
  • "organizationId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "status": "GoodStanding"
}

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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

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

Responses

Response samples

Content type
application/json
{
  • "identifiers": [
    ],
  • "name": "Jane Birkin",
  • "shortName": "Jane",
  • "nameTemplateId": "1",
  • "nameSoundExId": "1",
  • "partyBranchId": "SEA_1",
  • "customerSinceDate": "2022-04-17T08:00:00Z",
  • "comment": "This is a description.",
  • "relatedParties": [
    ],
  • "postalAddresses": [
    ],
  • "relationshipId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "relationshipLeadIndicator": true,
  • "residenceType": "Domestic",
  • "taxInformation": {
    },
  • "powerOfAttorney": {
    },
  • "supplementaryData": { },
  • "excludeMarketingIndicator": true,
  • "audit": {
    },
  • "restrictions": [
    ],
  • "codes": [
    ],
  • "webPage": "http://portx.io",
  • "organizationType": "Corporation",
  • "organizationPurpose": "This is a description.",
  • "legalName": "Jane",
  • "tradingName": "Jane",
  • "registrationDate": "2022-04-17",
  • "establishmentDate": "2022-04-17",
  • "merchantCategory": "482",
  • "nAICSCode": "54",
  • "lineOfBusiness": "string",
  • "sector": "string",
  • "organizationProfile": {
    },
  • "contact": {
    },
  • "logo": {
    },
  • "organizationId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "status": "GoodStanding"
}

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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

Identification of the account servicer institution at branch level or center 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 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 center level. To overlay the codes to produce a unique identifier the following expresion is used: BranchRegionCode-BranchSubdivisionCode.

customerSinceDate
string <date-time> (DateAndTime)
Example: "2022-04-17T08:00:00Z"
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

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

Type of relation between parties. Possible values Between Organizations and persons are: ResponsibleParty, Owner, ControlPerson, BeneficialOwner, PrimaryContact, SecondaryContact, VicePresident, President, Treasurer, Secretary, Partner. Between Persons and Organizations: Business, Organization. For Trusts: Trustor, Trustee. Between organizations: Subsidiary, ParentOrganization, Branch. Between parties and external entities: AccountOpenningOfficer, CustomerServiceOfficer, PrimaryServicerOfficer, SecondaryServicerOfficer, SalesPerson, ReferralOfficer. Between financial institutions: AffiliateFinancialInstitution, HoldingCompany. Between persons: Spouse, Aunt, Brother, Companion, Daugther, Father, Friend, Granddaugther, Grandmother, Grandfather, Grandson, Husband, Mother, Nephew, Niece, Sister, Son, Uncle, Wife, Child, Grandparent. Grandchild, Sibling, Parent, Partner.

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
addressCode
string

This code is used to identify parties that share the same address or to associate an existing address with a specific party. Providing this code eliminates the need to separately enter the address details.

addressBookIndicator
string

If true, the address is kept in the system even if the person is no longer a customer.

addressType
string
Example: "Postal"

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

addressPurpose
string
Example: "Billing"

Specifies the purpose of an address, in PascalCase form. Possible values are: MailTo, DeliveryTo, Billing, Tax, ForeignTaxRecipient PlaceOfOperation, PlaceOfRegistration, Marketing, Statements, Business, Administrative, PreviousPlace, Headquarter, BranchStore, Property, Military, Secondary, Personal.

primaryIndicator
boolean (PrimaryContactIndicator)

Indicates whether the contact informacion is primary.

careOf
string [ 1 .. 100 ] characters
Example: "C/O Company Name"

Identifies an addressee that is accepting the correspondence for the intended recipient. Using care of ensures the correspondence reaches the right recipient rather than getting returned to the sender.

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-6884"

Identifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail. In US may consists of two parts: the five-digit ZIP Code '97062' and the ZIP+4 Code '6884'.

carrierRoute
string (CarrierRoute) [ 1 .. 4 ] characters
Example: "C001"

A Carrier Route is a designated geographic area assigned to individual postal carriers by the United States Postal Service (USPS) to facilitate efficient mail delivery within specific regions.

censusTract
string (CensusTract) = 5 characters
Example: "12345"

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

censusBlock
string (CensusBlock) = 4 characters
Example: "1234"

Census blocks are used to partition counties into smaller areas for the purpose of collecting and presenting census data.

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: "San Diego"

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

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

Specific location name within the town.

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

Identifies a subdivision within a country sub-division.

countyName
string [ 1 .. 35 ] characters
Example: "Cook"

Identifies a county 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.

temporaryIndicator
boolean
Example: true

Indicates whether the address is temporary or not.

object

The period of use of the address information.

Array of objects (GenericCode)

Codes related to postal address or internal handling codes asociated with the address. Possible Values: HandlingCode, HandlingCodeOption.

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

Customer principal relationship. This entity 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.

taxReportingIndicator
boolean

Account tax reporting typically involves obtaining and submitting records related to your tax obligations. For individuals, this may include income, qualifying deductions, and investment gains or losses. Businesses, on the other hand, have additional complexities, such as tracking funds directed towards specific business expenses and shareholders.

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

verificationDate
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.

taxStatus
string
Example: "Exempt"

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

exemptionCode
string <= 4
Example: "0"

Indicates the reason why taxes were not withheld from the gross income being reported for a NRA. These codes are used to specify the type of income, the applicable tax treaty, or the Internal Revenue Code section that allows for the exemption from withholding. The use of these codes is subject to certain conditions and limitations, and withholding agents are responsible for verifying the NRA's eligibility for the exemption and for reporting the income and exemption codes accurately to the IRS.

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

Human readable reason why taxes were not withheld.

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.

onFileIndicator
boolean

Indicates weather the bank establish the appropriate tax treatment of any interest or other income earned on the account related to the form.

taxStatus
string
Example: "Exempt"

Exempt, Expired, Certified.

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, NRATax, Chapter3, Chapter4.

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.

taxStatus
string

Exempt, Expired, Certified, Retain.

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.

Array of objects (TaxFormCode)

Codes provided by the IRS on forms.

Array
name
string (TaxFormName) [ 1 .. 35 ] characters

Indicates a code name provided by the IRS on the form. Possible Values: Chapter3, Chapter4, Income, Exempt, Province, CountryResidence, AmendedNumber, CountryTax

code
string <= 3

Indicates the code number 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

Code provided by the IRS on forms.

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

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

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 <= 2 characters

IRS country code table.

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.

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: "San Diego"

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

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

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

object (PersonContactDetails)

Specifies the contact details of a person.

object (StructuredName)

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

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

Preferred name to contact the person

Array of objects (Phone)
Array of objects (Email)
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)
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, Operator, VRU, Telebanc.

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, Default.

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: "033-DDA-123456"

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, Operator, VRU, Telebanc.

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 communication 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, Operator, VRU, Telebanc.

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

Maintenance activity of a resource. Possible values: Transaction, Modification, Deposit, Withdrawal, Creation, DirectDeposit, CardActivation, CardActivation, CardActivationByCallerId, CardActivationByCodeAndCallerId.

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: TransferIn, TransferOut, WireTransferIn, WireTransferOut, ACHTransferIn, ACHTransferOut, ForeignIncomingWires, ForeignOutgoingWires, ACHTransfers, InternetBankingTransfer, InternetView, InternetInquiry, ForeignOutgoingIran, Withdrawals, Renew, Transfers, AdvanceTransfer

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

Indicates whether the capability is allowed or not.

disableConditions
Array of strings (ConditionName) [ items [ 1 .. 36 ] characters ]
Example: ["Pending"]

Conditions that disabel the restriction.

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.

status
string (RestrictionStatus) [ 1 .. 36 ] characters
Example: "Pending"

Specifies the status of a restriction enablement request. Possible values: Active, Pending.

Array of objects (GenericCode)

Codes to clasify parties. Possible code names: Priority.

Array
name
string [ 1 .. 50 ] characters
Example: "Incoming Wire"

Name of the code in PascalCase.

value
string [ 1 .. 35 ] characters
Example: "195"

Code value to identify the type of transaction.

webPage
string^[(http(s)?):\/\/(www\.)?a-zA-Z0-9@:%._\+~#=]...
Example: "http://portx.io"

Party web page

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, PublicAgency, Association, Church.

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.

lineOfBusiness
string [ 1 .. 35 ] characters

The line of business refers to the specific industry or market segment that a company operates. This helps to further define the target market and focus marketing efforts on reaching and serving the needs of that specific group. Possible Values: ConsumerGoods, ConsumerCervices, SmallBusiness, Corporate.

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.

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

Array of objects (CreditRankingScale)
creditReportAddressIndicatorCode
string

is a code or marker used by credit reporting agencies to indicate a match or mismatch between the address supplied in an inquiry and the address they have on file for a consumer.

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

Information provided by the Consumer Credit Report.

consumerCreditReportDate
string <date-time> (DateAndTime)
Example: "2022-04-17T08:00:00Z"
creditBureauReportCode
string
Example: "30"

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.

eCOACode
string

The ECOA code indicates how customer account information is reported to the Credit Bureau in keeping with the Equal Credit Opportunity Act.

cTRExemptIndicator
boolean

Currency transaction report (CTR) exemption. A CTR is a report that must be filed by banks for any transaction involving currency of $10,000 or more. However, certain entities and transactions are exempt from this reporting requirement.

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

customerType
string (CustomerType)
Example: "Consumer"

A customer type of a bank account can be classified into different categories based on the account's features, purpose, and benefits. Possible Values: Personal, Business, Consumer, Organization, ThirdParty.

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.

annualSales
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: "San Diego"

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

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.

country
string (CountryCallingCode) <= 3 characters

Country calling codes, country dial-in codes, international subscriber dialing (ISD) codes, or most commonly, telephone country codes. Country codes are defined by the International Telecommunication Union (ITU) in ITU-T standards E.123 and E.164. The prefixes enable international direct dialing (IDD).

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 (TimeOfTheDay)
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, Personal

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, Operator, VRU, Telebanc.

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, NegativeBalance

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

primaryIndicator
boolean (PrimaryContactIndicator)

Indicates whether the contact informacion is primary.

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, Default.

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.

status
string (PartyStatus) [ 1 .. 35 ] characters
Example: "GoodStanding"

Specifies the current primary status of a party. Possible values are: GoodStanding, FraudAlert, BadCustomer, Active, Delinquent, Default, HighRisk, UnderReview.

Responses

Request samples

Content type
application/merge-patch+json
{
  • "identifiers": [
    ],
  • "name": "Jane Birkin",
  • "shortName": "Jane",
  • "nameTemplateId": "1",
  • "nameSoundExId": "1",
  • "partyBranchId": "SEA_1",
  • "customerSinceDate": "2022-04-17T08:00:00Z",
  • "comment": "This is a description.",
  • "relatedParties": [
    ],
  • "postalAddresses": [
    ],
  • "relationshipId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "relationshipLeadIndicator": true,
  • "residenceType": "Domestic",
  • "taxInformation": {
    },
  • "powerOfAttorney": {
    },
  • "supplementaryData": { },
  • "excludeMarketingIndicator": true,
  • "audit": {
    },
  • "restrictions": [
    ],
  • "codes": [
    ],
  • "webPage": "http://portx.io",
  • "organizationType": "Corporation",
  • "organizationPurpose": "This is a description.",
  • "legalName": "Jane",
  • "tradingName": "Jane",
  • "registrationDate": "2022-04-17",
  • "establishmentDate": "2022-04-17",
  • "merchantCategory": "482",
  • "nAICSCode": "54",
  • "lineOfBusiness": "string",
  • "sector": "string",
  • "organizationProfile": {
    },
  • "contact": {
    },
  • "logo": {
    },
  • "status": "GoodStanding"
}

Response samples

Content type
application/json
{
  • "identifiers": [
    ],
  • "name": "Jane Birkin",
  • "shortName": "Jane",
  • "nameTemplateId": "1",
  • "nameSoundExId": "1",
  • "partyBranchId": "SEA_1",
  • "customerSinceDate": "2022-04-17T08:00:00Z",
  • "comment": "This is a description.",
  • "relatedParties": [
    ],
  • "postalAddresses": [
    ],
  • "relationshipId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "relationshipLeadIndicator": true,
  • "residenceType": "Domestic",
  • "taxInformation": {
    },
  • "powerOfAttorney": {
    },
  • "supplementaryData": { },
  • "excludeMarketingIndicator": true,
  • "audit": {
    },
  • "restrictions": [
    ],
  • "codes": [
    ],
  • "webPage": "http://portx.io",
  • "organizationType": "Corporation",
  • "organizationPurpose": "This is a description.",
  • "legalName": "Jane",
  • "tradingName": "Jane",
  • "registrationDate": "2022-04-17",
  • "establishmentDate": "2022-04-17",
  • "merchantCategory": "482",
  • "nAICSCode": "54",
  • "lineOfBusiness": "string",
  • "sector": "string",
  • "organizationProfile": {
    },
  • "contact": {
    },
  • "logo": {
    },
  • "organizationId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "status": "GoodStanding"
}

Transactions

Account Transactions Management

Creates a Credit Transaction

Authorizations:
jwtopenIdConnect
path Parameters
accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: 033-DDA-123456

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 values are: CustomerCheque, CertifiedCustomerCheque, BankCheque, Draft, ElectronicDraft.

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

Check amount

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

Check currency

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).

availabilityFloat
string

It refers to the time delay between when a check is deposited and when the funds become available for withdrawal. Possible Values: ImmediateWithdrawal, LocalCheck, NonLocalCheck

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: 033-DDA-123456

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 values are: CustomerCheque, CertifiedCustomerCheque, BankCheque, Draft, ElectronicDraft.

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

Check amount

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

Check currency

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).

availabilityFloat
string

It refers to the time delay between when a check is deposited and when the funds become available for withdrawal. Possible Values: ImmediateWithdrawal, LocalCheck, NonLocalCheck

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: 033-DDA-123456

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": "033-DDA-123456",
  • "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 Account Cards

Authorizations:
jwtopenIdConnect
path Parameters
accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: 033-DDA-123456

Account Identification

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

Account Servicer Identification (Bank)

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

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

Responses

Response samples

Content type
application/json
{
  • "accountId": "033-DDA-123456",
  • "accountNumber": "012345678",
  • "accountType": "Checking",
  • "ownershipType": "SingleOwnerAccount",
  • "cards": [
    ]
}

Requires a Payment Card Activation

Requires a Payment Card Activation

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

Card 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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

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

Request Body schema: application/json
Array of objects (PaymentCardIdentification)
Array
identification
string [ 1 .. 34 ] characters

Identification assigned by an institution or internally to connect to other applications.

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

Name of the identification scheme, in PascalCase. Possible values are: MemberNumber, CardNumber, NonTransToken.

issuer
string [ 1 .. 35 ] characters

Entity that assigns the identification.

Responses

Request samples

Content type
application/json
{
  • "identifiers": [
    ]
}

Response samples

Content type
application/json
{
  • "identifiers": [
    ],
  • "fundingSourceType": "Credit",
  • "productId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "businessIndicator": true,
  • "digitalIndicator": true,
  • "cardBranchId": "SEA_1",
  • "number": "1234567890123456789",
  • "cardHolderType": "Primary",
  • "nameOnCard": "Jane Birkin",
  • "businessNameOnCard": "Jane Birkin",
  • "art": {
    },
  • "referenceAccountId": "033-DDA-123456",
  • "relatedAccounts": [
    ],
  • "startDate": "2022-04-17",
  • "expiryDate": "2022-12",
  • "orderedDate": "2022-04-17",
  • "activationDates": [
    ],
  • "activationAttempts": 0,
  • "securityCode": "103",
  • "pIN": "1031",
  • "pINRetries": 3,
  • "sequenceNumber": "1",
  • "brand": "Visa",
  • "limits": [
    ],
  • "interests": [
    ],
  • "restrictions": [
    ],
  • "charges": [
    ],
  • "algorithms": [
    ],
  • "supplementaryData": { },
  • "cardId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "cardHolder": {
    },
  • "statement": {
    },
  • "offers": [
    ],
  • "status": "Active",
  • "statusDate": "2022-04-17T08:00:00Z",
  • "statusReason": "Active",
  • "history": {
    },
  • "servicerAlerts": [
    ]
}

Retrieves the cards associated with a specific 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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

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

Responses

Response samples

Content type
application/json
{
  • "personId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "personName": "Jane Birkin",
  • "cards": [
    ]
}

Creates a card associated with a specific person.

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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

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

Request Body schema: application/json
Array of objects (PaymentCardIdentification)
Array
identification
string [ 1 .. 34 ] characters

Identification assigned by an institution or internally to connect to other applications.

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

Name of the identification scheme, in PascalCase. Possible values are: MemberNumber, CardNumber, NonTransToken.

issuer
string [ 1 .. 35 ] characters

Entity that assigns the identification.

fundingSourceType
string (CardFundingSourceType) [ 1 .. 35 ] characters
Example: "Credit"

Specifies the funding source type of payment card. Possible Values: Credit, Debit, Prepaid, Charge, DeferredDebit, CreditGateway.

productId
required
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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: "SEA_1"

Identification of the account servicer institution at branch level or center level. To overlay the codes to produce a unique identifier the following expresion is used: BranchRegionCode-BranchSubdivisionCode.

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.

object (PaymentCardArt)

Art associated with the card

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

Display label for the specific image

imageUri
string <uri>

The URI link of a PNG, JPG or GIF image with proportions defined by ISO 8710 ID-1 with 340x210 ratio and width no greater than 512 pixels. The image at this URI must be accessible at all times, with no additional authentication headers. Typically this is an image resource located in the data provider's public web site or Content Delivery Network

referenceAccountId
string [ 1 .. 36 ] characters
Example: "033-DDA-123456"

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, AssociatedAccount.

accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: "033-DDA-123456"

Identification assigned by the account service institution (Servicer). Could be encoded (UUID). Also may be used as composite account identifier when overlaying the account code parts. [branch-type-subtype-number]

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

Array of objects (SpotDate)
Array
name
string (SpotDateName) [ 1 .. 40 ] characters
Example: "Expiration"

Specifies the name of Loan projected date. Possible values por projected dates: Forecast, Expiration, LastNonFinancial

date
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.

activationAttempts
number

Indicates the number of activation attempts since the last reset. Applies to debit cards only.

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, CashAdvance, ACHInTransfers, ACHOutTransfers

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

Specifies the type of risk management limit. Bilateral, NetBilateral, IndirectBilateral, Global, MandatoryBilateral, DiscretionaryBilateral, DirectDebit, SingleCustomerDirectDebit, SingleFinancialInstitutionDirectDebit, TotalDailyCustomerDirectDebit, TotalDailyFinancialInstitutionDirectDebit, AutoCollateralisation, UnsecuredCredit, ExternalGuarantee, Revolving, NotRevolving.

channelType
string [ 1 .. 30 ] characters

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

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

Amount limit

number
integer

Number limit.

enableIndicator
boolean
Example: true

Indicates whether the limit is enabled or not.

percentageIndicator
boolean

Indicates if the limit is calculated as a percentage.

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

temporaryIndicator
boolean
Example: true

Indicates whether the limit is temporary or not.

object (DatePeriod)
object

Renewal 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 (LimitHistory)

Historic values of a Limit

Array of objects (Balance)
Array of objects (InterestCalculationDescriptor)
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 (InterestDayCountBasis) [ 1 .. 50 ] characters
Example: "Actual360"

An interest day count basis is a method used to calculate interest accrual over a period of time for loans and bonds. The method involves determining the number of days over which interest is being calculated, known as the accrual period. The resulting accrual period is then divided by a certain number to calculate the daily interest rate, which is applied to the principal balance to determine the interest payment. Possible Values: ActualActual, Actual360, Actual365, 365365, 360360, Monthly78ths, 365360, ActualSchedule, ScheduleSchedule.

calculationMethodOption
string (InterestComputationParameter) [ 1 .. 50 ] characters
Example: "LastInterest"

Specifies a parameter that apply at the interest day count basis. Possible Values: LastInterest, EqualPayment, InterestAndPrincipal, InterestSeparatedm, Amortized, AddOn, NegativeAmortization, Simple, FHLMC.

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.

object

The period funds are earning interest.

object (Frequency)

Specifies an event frequency

Array of objects (Balance)

Total amounts related to an interest

rateName
string (RateName) [ 1 .. 40 ] characters
Example: "Available"

Specifies the name of the rate. Possible values: Original, Actual, LastAnniversary, Effective, Current, Future, Base, Floor, Ceiling, OverSplit, UnderSplit.

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

amount
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 (Restriction)
Array
name
required
string [ 1 .. 60 ] characters
Example: "WireTransferIn"

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

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

Indicates whether the capability is allowed or not.

disableConditions
Array of strings (ConditionName) [ items [ 1 .. 36 ] characters ]
Example: ["Pending"]

Conditions that disabel the restriction.

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.

status
string (RestrictionStatus) [ 1 .. 36 ] characters
Example: "Pending"

Specifies the status of a restriction enablement request. Possible values: Active, Pending.

Array of objects (ChargeCalculationDescriptor)
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.

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.

exemptIndicator
boolean

Indicates whether the account is exempt of the 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
{
  • "identifiers": [
    ],
  • "fundingSourceType": "Credit",
  • "productId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "businessIndicator": true,
  • "digitalIndicator": true,
  • "cardBranchId": "SEA_1",
  • "number": "1234567890123456789",
  • "cardHolderType": "Primary",
  • "nameOnCard": "Jane Birkin",
  • "businessNameOnCard": "Jane Birkin",
  • "art": {
    },
  • "referenceAccountId": "033-DDA-123456",
  • "relatedAccounts": [
    ],
  • "startDate": "2022-04-17",
  • "expiryDate": "2022-12",
  • "orderedDate": "2022-04-17",
  • "activationDates": [
    ],
  • "activationAttempts": 0,
  • "securityCode": "103",
  • "pIN": "1031",
  • "pINRetries": 3,
  • "sequenceNumber": "1",
  • "brand": "Visa",
  • "limits": [
    ],
  • "interests": [
    ],
  • "restrictions": [
    ],
  • "charges": [
    ],
  • "algorithms": [
    ],
  • "supplementaryData": { }
}

Response samples

Content type
application/json
{
  • "identifiers": [
    ],
  • "fundingSourceType": "Credit",
  • "productId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "businessIndicator": true,
  • "digitalIndicator": true,
  • "cardBranchId": "SEA_1",
  • "number": "1234567890123456789",
  • "cardHolderType": "Primary",
  • "nameOnCard": "Jane Birkin",
  • "businessNameOnCard": "Jane Birkin",
  • "art": {
    },
  • "referenceAccountId": "033-DDA-123456",
  • "relatedAccounts": [
    ],
  • "startDate": "2022-04-17",
  • "expiryDate": "2022-12",
  • "orderedDate": "2022-04-17",
  • "activationDates": [
    ],
  • "activationAttempts": 0,
  • "securityCode": "103",
  • "pIN": "1031",
  • "pINRetries": 3,
  • "sequenceNumber": "1",
  • "brand": "Visa",
  • "limits": [
    ],
  • "interests": [
    ],
  • "restrictions": [
    ],
  • "charges": [
    ],
  • "algorithms": [
    ],
  • "supplementaryData": { },
  • "cardId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "cardHolder": {
    },
  • "statement": {
    },
  • "offers": [
    ],
  • "status": "Active",
  • "statusDate": "2022-04-17T08:00:00Z",
  • "statusReason": "Active",
  • "history": {
    },
  • "servicerAlerts": [
    ]
}

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, CreditGateway.

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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

Identification of the account servicer institution at branch level or center 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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

Identification of the account servicer institution at branch level or center 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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

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

Request Body schema: application/merge-patch+json
Array of objects (PaymentCardIdentification)
Array
identification
string [ 1 .. 34 ] characters

Identification assigned by an institution or internally to connect to other applications.

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

Name of the identification scheme, in PascalCase. Possible values are: MemberNumber, CardNumber, NonTransToken.

issuer
string [ 1 .. 35 ] characters

Entity that assigns the identification.

fundingSourceType
string (CardFundingSourceType) [ 1 .. 35 ] characters
Example: "Credit"

Specifies the funding source type of payment card. Possible Values: Credit, Debit, Prepaid, Charge, DeferredDebit, CreditGateway.

productId
required
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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: "SEA_1"

Identification of the account servicer institution at branch level or center level. To overlay the codes to produce a unique identifier the following expresion is used: BranchRegionCode-BranchSubdivisionCode.

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.

object (PaymentCardArt)

Art associated with the card

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

Display label for the specific image

imageUri
string <uri>

The URI link of a PNG, JPG or GIF image with proportions defined by ISO 8710 ID-1 with 340x210 ratio and width no greater than 512 pixels. The image at this URI must be accessible at all times, with no additional authentication headers. Typically this is an image resource located in the data provider's public web site or Content Delivery Network

referenceAccountId
string [ 1 .. 36 ] characters
Example: "033-DDA-123456"

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, AssociatedAccount.

accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: "033-DDA-123456"

Identification assigned by the account service institution (Servicer). Could be encoded (UUID). Also may be used as composite account identifier when overlaying the account code parts. [branch-type-subtype-number]

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

Array of objects (SpotDate)
Array
name
string (SpotDateName) [ 1 .. 40 ] characters
Example: "Expiration"

Specifies the name of Loan projected date. Possible values por projected dates: Forecast, Expiration, LastNonFinancial

date
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.

activationAttempts
number

Indicates the number of activation attempts since the last reset. Applies to debit cards only.

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, CashAdvance, ACHInTransfers, ACHOutTransfers

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

Specifies the type of risk management limit. Bilateral, NetBilateral, IndirectBilateral, Global, MandatoryBilateral, DiscretionaryBilateral, DirectDebit, SingleCustomerDirectDebit, SingleFinancialInstitutionDirectDebit, TotalDailyCustomerDirectDebit, TotalDailyFinancialInstitutionDirectDebit, AutoCollateralisation, UnsecuredCredit, ExternalGuarantee, Revolving, NotRevolving.

channelType
string [ 1 .. 30 ] characters

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

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

Amount limit

number
integer

Number limit.

enableIndicator
boolean
Example: true

Indicates whether the limit is enabled or not.

percentageIndicator
boolean

Indicates if the limit is calculated as a percentage.

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

temporaryIndicator
boolean
Example: true

Indicates whether the limit is temporary or not.

object (DatePeriod)
object

Renewal 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 (LimitHistory)

Historic values of a Limit

Array of objects (Balance)
Array of objects (InterestCalculationDescriptor)
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 (InterestDayCountBasis) [ 1 .. 50 ] characters
Example: "Actual360"

An interest day count basis is a method used to calculate interest accrual over a period of time for loans and bonds. The method involves determining the number of days over which interest is being calculated, known as the accrual period. The resulting accrual period is then divided by a certain number to calculate the daily interest rate, which is applied to the principal balance to determine the interest payment. Possible Values: ActualActual, Actual360, Actual365, 365365, 360360, Monthly78ths, 365360, ActualSchedule, ScheduleSchedule.

calculationMethodOption
string (InterestComputationParameter) [ 1 .. 50 ] characters
Example: "LastInterest"

Specifies a parameter that apply at the interest day count basis. Possible Values: LastInterest, EqualPayment, InterestAndPrincipal, InterestSeparatedm, Amortized, AddOn, NegativeAmortization, Simple, FHLMC.

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.

object

The period funds are earning interest.

object (Frequency)

Specifies an event frequency

Array of objects (Balance)

Total amounts related to an interest

rateName
string (RateName) [ 1 .. 40 ] characters
Example: "Available"

Specifies the name of the rate. Possible values: Original, Actual, LastAnniversary, Effective, Current, Future, Base, Floor, Ceiling, OverSplit, UnderSplit.

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

amount
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 (Restriction)
Array
name
required
string [ 1 .. 60 ] characters
Example: "WireTransferIn"

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

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

Indicates whether the capability is allowed or not.

disableConditions
Array of strings (ConditionName) [ items [ 1 .. 36 ] characters ]
Example: ["Pending"]

Conditions that disabel the restriction.

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.

status
string (RestrictionStatus) [ 1 .. 36 ] characters
Example: "Pending"

Specifies the status of a restriction enablement request. Possible values: Active, Pending.

Array of objects (ChargeCalculationDescriptor)
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.

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.

exemptIndicator
boolean

Indicates whether the account is exempt of the 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

object

Card holder person description

object (CreditCardStatement)

Credit Card statement details.

object

The frequency of the regular statement.

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.

numberOfTimes
integer
Example: 4

Number of times the event will be repeated.

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, Operator, VRU, Telebanc.

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)
periodNumber
integer

Sequence number of the period.

periodName
string (PeriodName)

Time of the year or previous. Possible Values: YearToDate, MonthToDate, PreviousYear, BeginningPreviousYear, QuarterToDate, PreviousQuarter, YearEnd

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.

object (Period)
periodNumber
integer

Sequence number of the period.

periodName
string (PeriodName)

Time of the year or previous. Possible Values: YearToDate, MonthToDate, PreviousYear, BeginningPreviousYear, QuarterToDate, PreviousQuarter, YearEnd

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.

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

The date of the last statement.

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

The date of the statement previous from the last.

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

The date of the last regular statement.

accountNameIndicator
boolean

Indicates whether the account name is printed on the statement.

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, Default.

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 (CardStatusReason) [ 1 .. 60 ] characters
Example: "Active"

Specifies the status reason of payment card. Some possible values are: ActivationBeforeAvailableDate, CardRecordNotFound, CardLostOrStolen, NoActivationRequired, ActivationRequired, ExpDateNotMatch, AlreadyActivated, AttemptAfterDeadline, MaxAttemprsExceeded, CallerIdInvalid, ActivationCodeInvalid, PinCheckNotPerformed, InvalidActivationMethod, IvrAuthorizationFailed, FirstPinId

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
{
  • "identifiers": [
    ],
  • "fundingSourceType": "Credit",
  • "productId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "businessIndicator": true,
  • "digitalIndicator": true,
  • "cardBranchId": "SEA_1",
  • "number": "1234567890123456789",
  • "cardHolderType": "Primary",
  • "nameOnCard": "Jane Birkin",
  • "businessNameOnCard": "Jane Birkin",
  • "art": {
    },
  • "referenceAccountId": "033-DDA-123456",
  • "relatedAccounts": [
    ],
  • "startDate": "2022-04-17",
  • "expiryDate": "2022-12",
  • "orderedDate": "2022-04-17",
  • "activationDates": [
    ],
  • "activationAttempts": 0,
  • "securityCode": "103",
  • "pIN": "1031",
  • "pINRetries": 3,
  • "sequenceNumber": "1",
  • "brand": "Visa",
  • "limits": [
    ],
  • "interests": [
    ],
  • "restrictions": [
    ],
  • "charges": [
    ],
  • "algorithms": [
    ],
  • "supplementaryData": { },
  • "cardHolder": { },
  • "statement": {
    },
  • "offers": [
    ],
  • "status": "Active",
  • "statusDate": "2022-04-17T08:00:00Z",
  • "statusReason": "Active",
  • "history": {
    },
  • "servicerAlerts": [
    ]
}

Response samples

Content type
application/json
{
  • "identifiers": [
    ],
  • "fundingSourceType": "Credit",
  • "productId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "businessIndicator": true,
  • "digitalIndicator": true,
  • "cardBranchId": "SEA_1",
  • "number": "1234567890123456789",
  • "cardHolderType": "Primary",
  • "nameOnCard": "Jane Birkin",
  • "businessNameOnCard": "Jane Birkin",
  • "art": {
    },
  • "referenceAccountId": "033-DDA-123456",
  • "relatedAccounts": [
    ],
  • "startDate": "2022-04-17",
  • "expiryDate": "2022-12",
  • "orderedDate": "2022-04-17",
  • "activationDates": [
    ],
  • "activationAttempts": 0,
  • "securityCode": "103",
  • "pIN": "1031",
  • "pINRetries": 3,
  • "sequenceNumber": "1",
  • "brand": "Visa",
  • "limits": [
    ],
  • "interests": [
    ],
  • "restrictions": [
    ],
  • "charges": [
    ],
  • "algorithms": [
    ],
  • "supplementaryData": { },
  • "cardId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "cardHolder": {
    },
  • "statement": {
    },
  • "offers": [
    ],
  • "status": "Active",
  • "statusDate": "2022-04-17T08:00:00Z",
  • "statusReason": "Active",
  • "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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

Identification of the account servicer institution at branch level or center 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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

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

Responses

Response samples

Content type
application/json
{
  • "uSDocumentedIndicator": true,
  • "identifiers": [
    ],
  • "name": "Jane Birkin",
  • "shortName": "Jane",
  • "nameTemplateId": "1",
  • "nameSoundExId": "1",
  • "partyBranchId": "SEA_1",
  • "customerSinceDate": "2022-04-17T08:00:00Z",
  • "comment": "This is a description.",
  • "relatedParties": [
    ],
  • "postalAddresses": [
    ],
  • "relationshipId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "relationshipLeadIndicator": true,
  • "residenceType": "Domestic",
  • "taxInformation": {
    },
  • "powerOfAttorney": {
    },
  • "supplementaryData": { },
  • "excludeMarketingIndicator": true,
  • "audit": {
    },
  • "restrictions": [
    ],
  • "codes": [
    ],
  • "webPage": "http://portx.io",
  • "placeAndDateOfBirth": {
    },
  • "signature": {
    },
  • "signatureVerificationId": "0dd926fe-1ca2-11ed-861d-0242ac120002",
  • "contact": {
    },
  • "headOfHousehold": true,
  • "civilStatus": "Single",
  • "structuredName": {
    },
  • "gender": "Female",
  • "race": "Director",
  • "profession": "Artist",
  • "jobTitle": "Head of Documentation",
  • "educationLevel": null,
  • "residentialStatus": "Permanent",
  • "immigrationStatus": "Permanent",
  • "minorIndicator": true,
  • "citizenships": [
    ],
  • "countryOfResidence": "US",
  • "profile": {
    },
  • "personId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "status": "GoodStanding"
}

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

Retrieves personal loan exposure.

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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

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

Responses

Response samples

Content type
application/json
{
  • "personId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "personName": "Jane Birkin",
  • "personStatus": "GoodStanding",
  • "taxInformation": {
    },
  • "creditRankingScales": [
    ],
  • "balances": [
    ],
  • "loans": [
    ]
}

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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

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

Request Body schema: application/json
accountBranchId
string (ServicerBranchId) [ 1 .. 36 ] characters
Example: "SEA_1"

Identification of the account servicer institution at branch level or center level. To overlay the codes to produce a unique identifier the following expresion is used: BranchRegionCode-BranchSubdivisionCode.

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
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.

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 or internally to connect to other applications.

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, CreditBackIdentification, UniversalLoanIdentifier, CommitmentNumber, RecordNumber, FlexDataRecordNumber

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 center level. To overlay the codes to produce a unique identifier the following expresion is used: BranchRegionCode-BranchSubdivisionCode.

loanType
required
string (LoanType) [ 1 .. 35 ] characters
Example: "Personal"

Type of the account. Possible BIAN compliant values are: Loan, Personal, Consumer,
Corporate, Lease, Syndicated, Mortgage, Conforming, Merchandising, LineOfCredit, RevolvingCredit, LoanAgainstSecurities, DirectDepositAdvance

recourseType
string (LoanRecourseType) [ 1 .. 35 ] characters
Example: "FullRecourse"

For indirect loans, the Recourse Code indicates the type of recourse that the financial institution has on the loan. Possible Values: NoRecourse, PartialRecourse, FullRecourse, FullRepurchase, PartialRepurchase, LimitedRepurchase, AsPerAgreement.

balanceType
string (Balance Type)
Example: "Asset"

Account Balance Type. Possible Values: Asset, positive transaction amount increases balance; Liability, positive transaction amount decreases balance; Equity.

lendingRelationType
string (LoanLendingRelationType) [ 1 .. 35 ] characters
Example: "Direct"

Type of lending relationship betweent the lender and the borrower. Possible Values: Direct, Dealer, BoughtParticipation, SoldParticipation, ServicedParticipation, Indirect.

securedLoanIndicator
boolean

Indicates whether the Loan is secure.

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, Organization, Business, FormalPartnership, FormalTrust, Nominee, NonProfitOrganization, NotForProfitOrganization, ForProfit, EUResidualEntity, USGovernmentOrganization, GovernmentOrganization, LimitedLiabilityCompany, RegisteredInvestmentCompany, Entrepreneurial, Unincorporated, LimitedPartnership, LimitedLiabilityPartnership, BareOwner, Usufructuary, Fiduciary, ServicerEmployeeAccount, BusinessTrust, FamilyTrust, Estate, PublicFunds, NonUSGovernmentOrganization, Church.

productId
string (ProductId) [ 1 .. 36 ] characters
Example: "PD_CA_0002"

Identification of the product offered by a financial institution to its customers.

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.

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: "San Diego"

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

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

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

object (PersonContactDetails)

Specifies the contact details of a person.

object (StructuredName)

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

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

Preferred name to contact the person

Array of objects (Phone)
Array of objects (Email)
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)
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, Operator, VRU, Telebanc.

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, Default.

contractType
string (LoanContractType) [ 1 .. 40 ] characters
Example: "Regular"

Type of the loan contract. Possible values: Regular, MasterAgreement, MasterCommitment, LineOfCredit, LetterOfCredit, Tranche, MasterMorgage.

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

Loan amount as defined in the contract.

creditReduceByOptions
string (LimitSubstractOptions) [ 1 .. 35 ] characters

Indicates which balance is subtracted determine the available limit. Possible values: CurrentPrincipalBalance, CurrentMaximumCredit, FundsNotAvailableAfterPayOff, FundsAvailableAtPayOff, LongTermDebtAdvances.

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.

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

The day a loan contract originally took effect and the day interest began to accrue.

object (MasterAgreement)

A master agreement is a document that outlines the terms and conditions of an agreement between two or more parties. It's common to use a master agreement when there are multiple agreements in place with one company.

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

Account at Master Agreement level used as a reference for the Loan opening. Payments are auto-debited from this account.

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

Account at Master Agreement level used as a reference for the Loan opening. Payments are auto-debited from this account.

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.

object (MasterAgreement)

A master agreement is a document that outlines the terms and conditions of an agreement between two or more parties. It's common to use a master agreement when there are multiple agreements in place with one company.

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

Account at Master Agreement level used as a reference for the Loan opening. Payments are auto-debited from this account.

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

Account at Master Agreement level used as a reference for the Loan opening. Payments are auto-debited from this account.

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.

object (LoanCollateral)

Provides details of contract collaterals

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

Total of the collaterals as an amount.

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

The original loan amount divided by the original collateral value. For loans with maximum credit, the ratio is the original maximum credit divided by the original collateral value.

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

The pledge is the physical collateral, it is provided by the borrower as security for the loan. The required Pledge LTV on loans serves as a measure to ensure the stability of the banking system. By establishing a maximum LTV ratio, banks can maintain a level of resilience to potential risks associated with loans.

Array of objects (Collateral)
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 (InterestDayCountBasis) [ 1 .. 50 ] characters
Example: "Actual360"

An interest day count basis is a method used to calculate interest accrual over a period of time for loans and bonds. The method involves determining the number of days over which interest is being calculated, known as the accrual period. The resulting accrual period is then divided by a certain number to calculate the daily interest rate, which is applied to the principal balance to determine the interest payment. Possible Values: ActualActual, Actual360, Actual365, 365365, 360360, Monthly78ths, 365360, ActualSchedule, ScheduleSchedule.

calculationMethodOption
string (InterestComputationParameter) [ 1 .. 50 ] characters
Example: "LastInterest"

Specifies a parameter that apply at the interest day count basis. Possible Values: LastInterest, EqualPayment, InterestAndPrincipal, InterestSeparatedm, Amortized, AddOn, NegativeAmortization, Simple, FHLMC.

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

An accrued date is a hypothetical point in time when the interest should have been paid.

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.

object

The period funds are earning interest.

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

Indicates the compounding method used for interest calculations.

object

Frequency of the interest calculation and compounded during the term.

object (Frequency)

Specifies an event frequency

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 (InterestRenewalDetails)

Detailed interest attributes related to rate change and account maturity.

object (InterestCycle)

Set of parameters used to calculate an interest cycle.

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

The amount of automatic interest that was last posted to the account.

reportingIndicator
boolean

Identifies whether interest paid is reportable.

reportingOptions
Array of strings (InterestReportingOption) [ items [ 1 .. 35 ] characters ]
Example: ["Deposit"]
object (TaxForm)

Information of the form requested by the tax payer.

object

The frequency used in calculating the Regulation DD Annual Percentage Yield (APY) when the financial institution requires interest to be withdrawn (i.e. compounding interest is not an option.) The Regulation DD Compound Frequency overrides the interest frequency only in computing the APY. For example, an account with interest paid monthly by check but disclosed as annual compounding.

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

Annual Percentage Yield (APY) is a measure used in finance to express the total return on an investment, taking into account both the interest earned and the appreciation in the investment's value, over a specified period. It is expressed as a percentage and is often used for fixed income securities such as bonds, and money market accounts.

daysSinceLastAnniversary
integer

The number of calendar days processed since the last anniversary date

Array of objects (InterestCalculationRate)

Rates involve on interest calculation.

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

pastDueOptions
Array of strings[ items [ 1 .. 70 ] characters ]

Indicates how the Past Due Rate is applied to past due loans. After a loan payment is past due after certain days, interest is earned retroactively from the payment due date.

referenceRateName
string

Identifies the reference index for the debt instrument.

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

Margin over or under an index which determines the interest rate of an interest bearing instrument. Percentage to be added to or deducted from the index rate to calculate the effective rate.

spreadRateAmount
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

spreadRatePercentageIndicator
boolean
basisPointSpread
integer

Provides the number of basis points added to (if positive) or deducted from (if negative) the underlying reference rate to calculate the actual interest rate applicable for a given period at issuance of the floating rate instrument. Used to express differences in interest rates, for example, a difference of 0.10% is equivalen

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.

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.

exemptIndicator
boolean

Indicates whether the account is exempt of the charge.

calculationMethodCode
string [ 1 .. 60 ] characters

Servicer charge calculation code. Possible values: FIFO, older payment past due. LIFO, most recent payment past due

calculationMethodOptions
Array of strings[ items [ 1 .. 70 ] characters ]

Indicates other calculation method options for charge calculation.

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, Monthly78th

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.

maximumNumber
integer

Maximum Number of charges.

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

Minimum 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: "033-DDA-123456"

Identification assigned by the account service institution (Servicer). Could be encoded (UUID). Also may be used as composite account identifier when overlaying the account code parts. [branch-type-subtype-number]

object (Frequency)

Specifies an event frequency

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

Amount during the trial period. The loan trial period is typically an agreed-upon phase within the loan contract during which the borrower has the option to explore and experience the loan product without being committed to the full loan amount.

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

The loan term is the period of time that a loan is repaid, calculated from the date of the initial loan disbursement.

object (TemporalDuration)

Describes a temporal duration.

timesExtended
integer <= 100

The number of times the loan has been extended over its term.

timesRenewed
integer <= 100

The number of times the loan has been renewed over its term.

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, Curtailment.

Array of objects (PaymentIdentification)
Array of objects (Balance)

Other payment amounts

billingOption
string <= 20 characters

AutomaticPayment: This billing option allows the borrower to choose the "automatic payment" method for their loan. The borrower will specify their preferred payment day, usually the 1st or the last day of the month. The lender will automatically debit the borrower's bank account on the specified payment day, without the need for any manual intervention. RegularBilling: In this billing option, the borrower will be responsible for making their loan payments manually. The borrower must pay the interest and the principal amount at regular intervals, usually monthly, quarterly, or annually. LumpSumPayment: In this billing option, the borrower is required to pay off the entire loan balance in a single payment, usually at the end of the loan term. This payment includes both the outstanding principal amount and the accumulated interest. NegotiatedBillingOption: In this option, the lender and the borrower may negotiate and agree on a unique payment schedule that best suits their individual financial situations. This option may involve customized payment frequencies, additional payment fees, or a combination of automatic and manual payment options. AcceleratedBillingOption: In this billing option, the borrower may choose to make extra loan payments, either as a lump sum or over a specific period. This can potentially reduce the overall interest payments and loan repayment period.

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.

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

Account used as a reference for the Loan opening. Payments are auto-debited from this account.

required
Array of objects (AccountDetailedParty)
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
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, PowerOfAttorney, ContingentBeneficiary, Fiduciary,

partyAccountRoleCode
string
Example: "50"

Bank defined party account role.

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

Percentage value of the ownership that the party has in the account.

accountOwnerRelation
string [ 1 .. 40 ] characters
Example: "PrimaryServicerOfficer"

Identifies how the party is related to the owner of the account.

customerType
string (CustomerType)
Example: "Consumer"

A customer type of a bank account can be classified into different categories based on the account's features, purpose, and benefits. Possible Values: Personal, Business, Consumer, Organization, ThirdParty.

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

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

accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: "033-DDA-123456"

Identification assigned by the account service institution (Servicer). Could be encoded (UUID). Also may be used as composite account identifier when overlaying the account code parts. [branch-type-subtype-number]

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

Amount of money borrowed (excluding interest).

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

Interest on the principal amount.

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

Current final repayment date. The maturity date is automatically calculated based upon the first scheduled payment date, the scheduled payment frequency, and the number of payments.

object (MortageLoan)

Mortage information of a Loan

fHAStateNumber
string [ 1 .. 2 ]
Example: "99"

Federal Housing Administration's (FHA) two-digit state code, which is used to identify the state where a mortgage loan is originated or where the property is located.

fHACountyNumber
string [ 1 .. 2 ]
Example: "88"

Federal Housing Administration's (FHA) two-digit county code, which is used to identify the state where a mortgage loan is originated or where the property is located.

censusTract
string (CensusTract) = 5 characters
Example: "12345"

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

censusBlock
string (CensusBlock) = 4 characters
Example: "1234"

Census blocks are used to partition counties into smaller areas for the purpose of collecting and presenting census data.

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

hMDAReportingIndicator
boolean

Indicates whether the loan is subject of HMDA reporting. The Home Mortgage Disclosure Act (HMDA) is a federal law in the United States that requires most mortgage lenders to report information about the mortgage loans they originate or purchase.

hMDAOcupationStatus
string <= 36
Example: "Vacant"

Indicates whether the property associated with a mortgage loan is owner-occupied, investor-owned, or vacant. Possible Values: OwnerOccupied, InvestorOwned, Vacant.

hMDAPropertyType
string <= 36
Example: "OneToFourFamily"

Indicates the type of property associated with a mortgage loan. Possible values: OneToFourFamily, MultiFamily, SingleFamily, ManufacturedHome.

programs
string <= 36
Example: "FHA"

Mortgage programs are financing options offered by various government agencies, private lenders, and other organizations to help individuals and families purchase or refinance real estate. Possible Values: FHA, FmHA, VA, HomeImprovement, USDA, Jumbo.

rateForecastDays
integer

Adjustable Rate Mortgage (ARM) is a type of mortgage loan in which the interest rate changes periodically throughout the life of the loan. ARM Rate Forecast Days represent the number of days for which the lender provides a forecast of the ARM interest rate.

Array of objects (SpotDate)
Array
name
string (SpotDateName) [ 1 .. 40 ] characters
Example: "Expiration"

Specifies the name of Loan projected date. Possible values por projected dates: Forecast, Expiration, LastNonFinancial

date
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 (Restriction)
Array
name
required
string [ 1 .. 60 ] characters
Example: "WireTransferIn"

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

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

Indicates whether the capability is allowed or not.

disableConditions
Array of strings (ConditionName) [ items [ 1 .. 36 ] characters ]
Example: ["Pending"]

Conditions that disabel the restriction.

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.

status
string (RestrictionStatus) [ 1 .. 36 ] characters
Example: "Pending"

Specifies the status of a restriction enablement request. Possible values: Active, Pending.

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, CashAdvance, ACHInTransfers, ACHOutTransfers

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

Specifies the type of risk management limit. Bilateral, NetBilateral, IndirectBilateral, Global, MandatoryBilateral, DiscretionaryBilateral, DirectDebit, SingleCustomerDirectDebit, SingleFinancialInstitutionDirectDebit, TotalDailyCustomerDirectDebit, TotalDailyFinancialInstitutionDirectDebit, AutoCollateralisation, UnsecuredCredit, ExternalGuarantee, Revolving, NotRevolving.

channelType
string [ 1 .. 30 ] characters

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

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

Amount limit

number
integer

Number limit.

enableIndicator
boolean
Example: true

Indicates whether the limit is enabled or not.

percentageIndicator
boolean

Indicates if the limit is calculated as a percentage.

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

temporaryIndicator
boolean
Example: true

Indicates whether the limit is temporary or not.

object (DatePeriod)
object

Renewal 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 (LimitHistory)

Historic values of a Limit

Array of objects (Balance)
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 (InterestDayCountBasis) [ 1 .. 50 ] characters
Example: "Actual360"

An interest day count basis is a method used to calculate interest accrual over a period of time for loans and bonds. The method involves determining the number of days over which interest is being calculated, known as the accrual period. The resulting accrual period is then divided by a certain number to calculate the daily interest rate, which is applied to the principal balance to determine the interest payment. Possible Values: ActualActual, Actual360, Actual365, 365365, 360360, Monthly78ths, 365360, ActualSchedule, ScheduleSchedule.

calculationMethodOption
string (InterestComputationParameter) [ 1 .. 50 ] characters
Example: "LastInterest"

Specifies a parameter that apply at the interest day count basis. Possible Values: LastInterest, EqualPayment, InterestAndPrincipal, InterestSeparatedm, Amortized, AddOn, NegativeAmortization, Simple, FHLMC.

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

An accrued date is a hypothetical point in time when the interest should have been paid.

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.

object

The period funds are earning interest.

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

Indicates the compounding method used for interest calculations.

object

Frequency of the interest calculation and compounded during the term.

object (Frequency)

Specifies an event frequency

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 (InterestRenewalDetails)

Detailed interest attributes related to rate change and account maturity.

object (InterestCycle)

Set of parameters used to calculate an interest cycle.

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

The amount of automatic interest that was last posted to the account.

reportingIndicator
boolean

Identifies whether interest paid is reportable.

reportingOptions
Array of strings (InterestReportingOption) [ items [ 1 .. 35 ] characters ]
Example: ["Deposit"]
object (TaxForm)

Information of the form requested by the tax payer.

object

The frequency used in calculating the Regulation DD Annual Percentage Yield (APY) when the financial institution requires interest to be withdrawn (i.e. compounding interest is not an option.) The Regulation DD Compound Frequency overrides the interest frequency only in computing the APY. For example, an account with interest paid monthly by check but disclosed as annual compounding.

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

Annual Percentage Yield (APY) is a measure used in finance to express the total return on an investment, taking into account both the interest earned and the appreciation in the investment's value, over a specified period. It is expressed as a percentage and is often used for fixed income securities such as bonds, and money market accounts.

daysSinceLastAnniversary
integer

The number of calendar days processed since the last anniversary date

Array of objects (InterestCalculationRate)

Rates involve on interest calculation.

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

pastDueOptions
Array of strings[ items [ 1 .. 70 ] characters ]

Indicates how the Past Due Rate is applied to past due loans. After a loan payment is past due after certain days, interest is earned retroactively from the payment due date.

referenceRateName
string

Identifies the reference index for the debt instrument.

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

Margin over or under an index which determines the interest rate of an interest bearing instrument. Percentage to be added to or deducted from the index rate to calculate the effective rate.

spreadRateAmount
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

spreadRatePercentageIndicator
boolean
basisPointSpread
integer

Provides the number of basis points added to (if positive) or deducted from (if negative) the underlying reference rate to calculate the actual interest rate applicable for a given period at issuance of the floating rate instrument. Used to express differences in interest rates, for example, a difference of 0.10% is equivalen

object (FinancialStatement)

Specifies financial statement details.

object

The frequency of the regular statement.

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.

numberOfTimes
integer
Example: 4

Number of times the event will be repeated.

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, Operator, VRU, Telebanc.

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)
periodNumber
integer

Sequence number of the period.

periodName
string (PeriodName)

Time of the year or previous. Possible Values: YearToDate, MonthToDate, PreviousYear, BeginningPreviousYear, QuarterToDate, PreviousQuarter, YearEnd

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.

object (Period)
periodNumber
integer

Sequence number of the period.

periodName
string (PeriodName)

Time of the year or previous. Possible Values: YearToDate, MonthToDate, PreviousYear, BeginningPreviousYear, QuarterToDate, PreviousQuarter, YearEnd

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.

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

The date of the last statement.

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

The date of the statement previous from the last.

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

The date of the last regular statement.

accountNameIndicator
boolean

Indicates whether the account name is printed on the statement.

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, Default.

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.

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

Account loundery risk level

Array of objects (CreditRankingScale)

Borrower credit ranking scores

Array
name
string (CreditRankingScaleName) [ 1 .. 35 ] characters
Example: "StandardAndPoors"

Most commonly used credit ranking scales. Possible Values: StandardAndPoors, MoodysInvestors. Also other values: Original, 1, 2, 3.

score
string [ 2 .. 10 ]
Example: "AAA"
object (BankruptcyProfile)
chapter
string [ 1 .. 10 ]
Example: "11"

The section on the Bankruptcy Code that sets out the rules and procedures for a particular type of bankruptcy. Possible Values: 7, 11, 13, 12, and 9.

status
string [ 1 .. 40 ]
Example: "Petition"

Bankruptcy status. Possible values: Petition, Discharged, DebtReaffirmation, DebtReaffirmationRescinded, PlanConfirmed, PlanCompleted, Withdrawn.

statementOption
string [ 1 .. 40 ]
Example: "RegularBillingStatement"

Statement option. Possible Values: RegularBillingStatement, BankruptcyBillingStatement

object

Indicates the frequency that the history profile payment status is established. Values are dependent upon credit bureau standards.

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.

numberOfTimes
integer
Example: 4

Number of times the event will be repeated.

paymentHistoryOption
string [ 1 .. 40 ]
Example: "NotRecalculate"

Indicates whether the Payment History Profile will be recalculated. Possible Values: Default, NotRecalculate, RecalculateAndSetToDefault, RecalculateAndSetToNot.

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
{
  • "accountBranchId": "SEA_1",
  • "accountNumber": "012345678",
  • "accountType": "Checking",
  • "routingNumbers": [
    ],
  • "identifiers": [
    ],
  • "loanBranchId": "SEA_1",
  • "loanType": "Personal",
  • "recourseType": "FullRecourse",
  • "balanceType": "Asset",
  • "lendingRelationType": "Direct",
  • "securedLoanIndicator": true,
  • "ownershipType": "SingleOwnerAccount",
  • "productId": "PD_CA_0002",
  • "name": "Hermes PD_CA 0002",
  • "accountPurpose": "This is a description.",
  • "currency": "USD",
  • "contract": {
    },
  • "parties": [
    ],
  • "relatedAccounts": [
    ],
  • "principalAmount": "100",
  • "interestAmount": "100",
  • "maturityDate": "2022-04-17",
  • "mortage": {
    },
  • "rateForecastDays": 0,
  • "projectedDates": [
    ],
  • "restrictions": [
    ],
  • "limits": [
    ],
  • "interests": [
    ],
  • "statement": {
    },
  • "profile": {
    },
  • "supplementaryData": { }
}

Response samples

Content type
application/json
{
  • "accountBranchId": "SEA_1",
  • "accountNumber": "012345678",
  • "accountType": "Checking",
  • "routingNumbers": [
    ],
  • "identifiers": [
    ],
  • "loanBranchId": "SEA_1",
  • "loanType": "Personal",
  • "recourseType": "FullRecourse",
  • "balanceType": "Asset",
  • "lendingRelationType": "Direct",
  • "securedLoanIndicator": true,
  • "ownershipType": "SingleOwnerAccount",
  • "productId": "PD_CA_0002",
  • "name": "Hermes PD_CA 0002",
  • "accountPurpose": "This is a description.",
  • "currency": "USD",
  • "contract": {
    },
  • "parties": [
    ],
  • "relatedAccounts": [
    ],
  • "principalAmount": "100",
  • "interestAmount": "100",
  • "maturityDate": "2022-04-17",
  • "mortage": {
    },
  • "rateForecastDays": 0,
  • "projectedDates": [
    ],
  • "restrictions": [
    ],
  • "limits": [
    ],
  • "interests": [
    ],
  • "statement": {
    },
  • "profile": {
    },
  • "supplementaryData": { },
  • "ammountCalculationDate": "2022-04-17T08:00:00Z",
  • "transactionDates": [
    ],
  • "balances": [
    ],
  • "accountId": "033-DDA-123456",
  • "relatedCards": [
    ],
  • "payment": {
    },
  • "unscheduledPrincipalReduction": "100",
  • "totalReappliedReduction": "100",
  • "accruedCapitalisationAmount": "100",
  • "reviewDateEvents": [
    ],
  • "status": {
    },
  • "payOff": {
    }
}

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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

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

Responses

Response samples

Content type
application/json
{
  • "accountBranchId": "SEA_1",
  • "accountNumber": "012345678",
  • "accountType": "Checking",
  • "routingNumbers": [
    ],
  • "identifiers": [
    ],
  • "loanBranchId": "SEA_1",
  • "loanType": "Personal",
  • "recourseType": "FullRecourse",
  • "balanceType": "Asset",
  • "lendingRelationType": "Direct",
  • "securedLoanIndicator": true,
  • "ownershipType": "SingleOwnerAccount",
  • "productId": "PD_CA_0002",
  • "name": "Hermes PD_CA 0002",
  • "accountPurpose": "This is a description.",
  • "currency": "USD",
  • "contract": {
    },
  • "parties": [
    ],
  • "relatedAccounts": [
    ],
  • "principalAmount": "100",
  • "interestAmount": "100",
  • "maturityDate": "2022-04-17",
  • "mortage": {
    },
  • "rateForecastDays": 0,
  • "projectedDates": [
    ],
  • "restrictions": [
    ],
  • "limits": [
    ],
  • "interests": [
    ],
  • "statement": {
    },
  • "profile": {
    },
  • "supplementaryData": { },
  • "ammountCalculationDate": "2022-04-17T08:00:00Z",
  • "transactionDates": [
    ],
  • "balances": [
    ],
  • "accountId": "033-DDA-123456",
  • "relatedCards": [
    ],
  • "payment": {
    },
  • "unscheduledPrincipalReduction": "100",
  • "totalReappliedReduction": "100",
  • "accruedCapitalisationAmount": "100",
  • "reviewDateEvents": [
    ],
  • "status": {
    },
  • "payOff": {
    }
}

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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

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

Request Body schema: application/merge-patch+json
accountBranchId
string (ServicerBranchId) [ 1 .. 36 ] characters
Example: "SEA_1"

Identification of the account servicer institution at branch level or center level. To overlay the codes to produce a unique identifier the following expresion is used: BranchRegionCode-BranchSubdivisionCode.

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
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.

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 or internally to connect to other applications.

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, CreditBackIdentification, UniversalLoanIdentifier, CommitmentNumber, RecordNumber, FlexDataRecordNumber

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 center level. To overlay the codes to produce a unique identifier the following expresion is used: BranchRegionCode-BranchSubdivisionCode.

loanType
required
string (LoanType) [ 1 .. 35 ] characters
Example: "Personal"

Type of the account. Possible BIAN compliant values are: Loan, Personal, Consumer,
Corporate, Lease, Syndicated, Mortgage, Conforming, Merchandising, LineOfCredit, RevolvingCredit, LoanAgainstSecurities, DirectDepositAdvance

recourseType
string (LoanRecourseType) [ 1 .. 35 ] characters
Example: "FullRecourse"

For indirect loans, the Recourse Code indicates the type of recourse that the financial institution has on the loan. Possible Values: NoRecourse, PartialRecourse, FullRecourse, FullRepurchase, PartialRepurchase, LimitedRepurchase, AsPerAgreement.

balanceType
string (Balance Type)
Example: "Asset"

Account Balance Type. Possible Values: Asset, positive transaction amount increases balance; Liability, positive transaction amount decreases balance; Equity.

lendingRelationType
string (LoanLendingRelationType) [ 1 .. 35 ] characters
Example: "Direct"

Type of lending relationship betweent the lender and the borrower. Possible Values: Direct, Dealer, BoughtParticipation, SoldParticipation, ServicedParticipation, Indirect.

securedLoanIndicator
boolean

Indicates whether the Loan is secure.

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, Organization, Business, FormalPartnership, FormalTrust, Nominee, NonProfitOrganization, NotForProfitOrganization, ForProfit, EUResidualEntity, USGovernmentOrganization, GovernmentOrganization, LimitedLiabilityCompany, RegisteredInvestmentCompany, Entrepreneurial, Unincorporated, LimitedPartnership, LimitedLiabilityPartnership, BareOwner, Usufructuary, Fiduciary, ServicerEmployeeAccount, BusinessTrust, FamilyTrust, Estate, PublicFunds, NonUSGovernmentOrganization, Church.

productId
string (ProductId) [ 1 .. 36 ] characters
Example: "PD_CA_0002"

Identification of the product offered by a financial institution to its customers.

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.

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: "San Diego"

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

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

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

object (PersonContactDetails)

Specifies the contact details of a person.

object (StructuredName)

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

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

Preferred name to contact the person

Array of objects (Phone)
Array of objects (Email)
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)
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, Operator, VRU, Telebanc.

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, Default.

contractType
string (LoanContractType) [ 1 .. 40 ] characters
Example: "Regular"

Type of the loan contract. Possible values: Regular, MasterAgreement, MasterCommitment, LineOfCredit, LetterOfCredit, Tranche, MasterMorgage.

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

Loan amount as defined in the contract.

creditReduceByOptions
string (LimitSubstractOptions) [ 1 .. 35 ] characters

Indicates which balance is subtracted determine the available limit. Possible values: CurrentPrincipalBalance, CurrentMaximumCredit, FundsNotAvailableAfterPayOff, FundsAvailableAtPayOff, LongTermDebtAdvances.

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.

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

The day a loan contract originally took effect and the day interest began to accrue.

object (MasterAgreement)

A master agreement is a document that outlines the terms and conditions of an agreement between two or more parties. It's common to use a master agreement when there are multiple agreements in place with one company.

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

Account at Master Agreement level used as a reference for the Loan opening. Payments are auto-debited from this account.

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

Account at Master Agreement level used as a reference for the Loan opening. Payments are auto-debited from this account.

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.

object (MasterAgreement)

A master agreement is a document that outlines the terms and conditions of an agreement between two or more parties. It's common to use a master agreement when there are multiple agreements in place with one company.

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

Account at Master Agreement level used as a reference for the Loan opening. Payments are auto-debited from this account.

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

Account at Master Agreement level used as a reference for the Loan opening. Payments are auto-debited from this account.

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.

object (LoanCollateral)

Provides details of contract collaterals

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

Total of the collaterals as an amount.

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

The original loan amount divided by the original collateral value. For loans with maximum credit, the ratio is the original maximum credit divided by the original collateral value.

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

The pledge is the physical collateral, it is provided by the borrower as security for the loan. The required Pledge LTV on loans serves as a measure to ensure the stability of the banking system. By establishing a maximum LTV ratio, banks can maintain a level of resilience to potential risks associated with loans.

Array of objects (Collateral)
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 (InterestDayCountBasis) [ 1 .. 50 ] characters
Example: "Actual360"

An interest day count basis is a method used to calculate interest accrual over a period of time for loans and bonds. The method involves determining the number of days over which interest is being calculated, known as the accrual period. The resulting accrual period is then divided by a certain number to calculate the daily interest rate, which is applied to the principal balance to determine the interest payment. Possible Values: ActualActual, Actual360, Actual365, 365365, 360360, Monthly78ths, 365360, ActualSchedule, ScheduleSchedule.

calculationMethodOption
string (InterestComputationParameter) [ 1 .. 50 ] characters
Example: "LastInterest"

Specifies a parameter that apply at the interest day count basis. Possible Values: LastInterest, EqualPayment, InterestAndPrincipal, InterestSeparatedm, Amortized, AddOn, NegativeAmortization, Simple, FHLMC.

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

An accrued date is a hypothetical point in time when the interest should have been paid.

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.

object

The period funds are earning interest.

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

Indicates the compounding method used for interest calculations.

object

Frequency of the interest calculation and compounded during the term.

object (Frequency)

Specifies an event frequency

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 (InterestRenewalDetails)

Detailed interest attributes related to rate change and account maturity.

object (InterestCycle)

Set of parameters used to calculate an interest cycle.

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

The amount of automatic interest that was last posted to the account.

reportingIndicator
boolean

Identifies whether interest paid is reportable.

reportingOptions
Array of strings (InterestReportingOption) [ items [ 1 .. 35 ] characters ]
Example: ["Deposit"]
object (TaxForm)

Information of the form requested by the tax payer.

object

The frequency used in calculating the Regulation DD Annual Percentage Yield (APY) when the financial institution requires interest to be withdrawn (i.e. compounding interest is not an option.) The Regulation DD Compound Frequency overrides the interest frequency only in computing the APY. For example, an account with interest paid monthly by check but disclosed as annual compounding.

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

Annual Percentage Yield (APY) is a measure used in finance to express the total return on an investment, taking into account both the interest earned and the appreciation in the investment's value, over a specified period. It is expressed as a percentage and is often used for fixed income securities such as bonds, and money market accounts.

daysSinceLastAnniversary
integer

The number of calendar days processed since the last anniversary date

Array of objects (InterestCalculationRate)

Rates involve on interest calculation.

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

pastDueOptions
Array of strings[ items [ 1 .. 70 ] characters ]

Indicates how the Past Due Rate is applied to past due loans. After a loan payment is past due after certain days, interest is earned retroactively from the payment due date.

referenceRateName
string

Identifies the reference index for the debt instrument.

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

Margin over or under an index which determines the interest rate of an interest bearing instrument. Percentage to be added to or deducted from the index rate to calculate the effective rate.

spreadRateAmount
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

spreadRatePercentageIndicator
boolean
basisPointSpread
integer

Provides the number of basis points added to (if positive) or deducted from (if negative) the underlying reference rate to calculate the actual interest rate applicable for a given period at issuance of the floating rate instrument. Used to express differences in interest rates, for example, a difference of 0.10% is equivalen

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.

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.

exemptIndicator
boolean

Indicates whether the account is exempt of the charge.

calculationMethodCode
string [ 1 .. 60 ] characters

Servicer charge calculation code. Possible values: FIFO, older payment past due. LIFO, most recent payment past due

calculationMethodOptions
Array of strings[ items [ 1 .. 70 ] characters ]

Indicates other calculation method options for charge calculation.

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, Monthly78th

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.

maximumNumber
integer

Maximum Number of charges.

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

Minimum 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: "033-DDA-123456"

Identification assigned by the account service institution (Servicer). Could be encoded (UUID). Also may be used as composite account identifier when overlaying the account code parts. [branch-type-subtype-number]

object (Frequency)

Specifies an event frequency

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

Amount during the trial period. The loan trial period is typically an agreed-upon phase within the loan contract during which the borrower has the option to explore and experience the loan product without being committed to the full loan amount.

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

The loan term is the period of time that a loan is repaid, calculated from the date of the initial loan disbursement.

object (TemporalDuration)

Describes a temporal duration.

timesExtended
integer <= 100

The number of times the loan has been extended over its term.

timesRenewed
integer <= 100

The number of times the loan has been renewed over its term.

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, Curtailment.

Array of objects (PaymentIdentification)
Array of objects (Balance)

Other payment amounts

billingOption
string <= 20 characters

AutomaticPayment: This billing option allows the borrower to choose the "automatic payment" method for their loan. The borrower will specify their preferred payment day, usually the 1st or the last day of the month. The lender will automatically debit the borrower's bank account on the specified payment day, without the need for any manual intervention. RegularBilling: In this billing option, the borrower will be responsible for making their loan payments manually. The borrower must pay the interest and the principal amount at regular intervals, usually monthly, quarterly, or annually. LumpSumPayment: In this billing option, the borrower is required to pay off the entire loan balance in a single payment, usually at the end of the loan term. This payment includes both the outstanding principal amount and the accumulated interest. NegotiatedBillingOption: In this option, the lender and the borrower may negotiate and agree on a unique payment schedule that best suits their individual financial situations. This option may involve customized payment frequencies, additional payment fees, or a combination of automatic and manual payment options. AcceleratedBillingOption: In this billing option, the borrower may choose to make extra loan payments, either as a lump sum or over a specific period. This can potentially reduce the overall interest payments and loan repayment period.

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.

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

Account used as a reference for the Loan opening. Payments are auto-debited from this account.

required
Array of objects (AccountDetailedParty)
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
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, PowerOfAttorney, ContingentBeneficiary, Fiduciary,

partyAccountRoleCode
string
Example: "50"

Bank defined party account role.

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

Percentage value of the ownership that the party has in the account.

accountOwnerRelation
string [ 1 .. 40 ] characters
Example: "PrimaryServicerOfficer"

Identifies how the party is related to the owner of the account.

customerType
string (CustomerType)
Example: "Consumer"

A customer type of a bank account can be classified into different categories based on the account's features, purpose, and benefits. Possible Values: Personal, Business, Consumer, Organization, ThirdParty.

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

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

accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: "033-DDA-123456"

Identification assigned by the account service institution (Servicer). Could be encoded (UUID). Also may be used as composite account identifier when overlaying the account code parts. [branch-type-subtype-number]

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

Amount of money borrowed (excluding interest).

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

Interest on the principal amount.

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

Current final repayment date. The maturity date is automatically calculated based upon the first scheduled payment date, the scheduled payment frequency, and the number of payments.

object (MortageLoan)

Mortage information of a Loan

fHAStateNumber
string [ 1 .. 2 ]
Example: "99"

Federal Housing Administration's (FHA) two-digit state code, which is used to identify the state where a mortgage loan is originated or where the property is located.

fHACountyNumber
string [ 1 .. 2 ]
Example: "88"

Federal Housing Administration's (FHA) two-digit county code, which is used to identify the state where a mortgage loan is originated or where the property is located.

censusTract
string (CensusTract) = 5 characters
Example: "12345"

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

censusBlock
string (CensusBlock) = 4 characters
Example: "1234"

Census blocks are used to partition counties into smaller areas for the purpose of collecting and presenting census data.

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

hMDAReportingIndicator
boolean

Indicates whether the loan is subject of HMDA reporting. The Home Mortgage Disclosure Act (HMDA) is a federal law in the United States that requires most mortgage lenders to report information about the mortgage loans they originate or purchase.

hMDAOcupationStatus
string <= 36
Example: "Vacant"

Indicates whether the property associated with a mortgage loan is owner-occupied, investor-owned, or vacant. Possible Values: OwnerOccupied, InvestorOwned, Vacant.

hMDAPropertyType
string <= 36
Example: "OneToFourFamily"

Indicates the type of property associated with a mortgage loan. Possible values: OneToFourFamily, MultiFamily, SingleFamily, ManufacturedHome.

programs
string <= 36
Example: "FHA"

Mortgage programs are financing options offered by various government agencies, private lenders, and other organizations to help individuals and families purchase or refinance real estate. Possible Values: FHA, FmHA, VA, HomeImprovement, USDA, Jumbo.

rateForecastDays
integer

Adjustable Rate Mortgage (ARM) is a type of mortgage loan in which the interest rate changes periodically throughout the life of the loan. ARM Rate Forecast Days represent the number of days for which the lender provides a forecast of the ARM interest rate.

Array of objects (SpotDate)
Array
name
string (SpotDateName) [ 1 .. 40 ] characters
Example: "Expiration"

Specifies the name of Loan projected date. Possible values por projected dates: Forecast, Expiration, LastNonFinancial

date
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 (Restriction)
Array
name
required
string [ 1 .. 60 ] characters
Example: "WireTransferIn"

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

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

Indicates whether the capability is allowed or not.

disableConditions
Array of strings (ConditionName) [ items [ 1 .. 36 ] characters ]
Example: ["Pending"]

Conditions that disabel the restriction.

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.

status
string (RestrictionStatus) [ 1 .. 36 ] characters
Example: "Pending"

Specifies the status of a restriction enablement request. Possible values: Active, Pending.

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, CashAdvance, ACHInTransfers, ACHOutTransfers

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

Specifies the type of risk management limit. Bilateral, NetBilateral, IndirectBilateral, Global, MandatoryBilateral, DiscretionaryBilateral, DirectDebit, SingleCustomerDirectDebit, SingleFinancialInstitutionDirectDebit, TotalDailyCustomerDirectDebit, TotalDailyFinancialInstitutionDirectDebit, AutoCollateralisation, UnsecuredCredit, ExternalGuarantee, Revolving, NotRevolving.

channelType
string [ 1 .. 30 ] characters

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

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

Amount limit

number
integer

Number limit.

enableIndicator
boolean
Example: true

Indicates whether the limit is enabled or not.

percentageIndicator
boolean

Indicates if the limit is calculated as a percentage.

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

temporaryIndicator
boolean
Example: true

Indicates whether the limit is temporary or not.

object (DatePeriod)
object

Renewal 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 (LimitHistory)

Historic values of a Limit

Array of objects (Balance)
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 (InterestDayCountBasis) [ 1 .. 50 ] characters
Example: "Actual360"

An interest day count basis is a method used to calculate interest accrual over a period of time for loans and bonds. The method involves determining the number of days over which interest is being calculated, known as the accrual period. The resulting accrual period is then divided by a certain number to calculate the daily interest rate, which is applied to the principal balance to determine the interest payment. Possible Values: ActualActual, Actual360, Actual365, 365365, 360360, Monthly78ths, 365360, ActualSchedule, ScheduleSchedule.

calculationMethodOption
string (InterestComputationParameter) [ 1 .. 50 ] characters
Example: "LastInterest"

Specifies a parameter that apply at the interest day count basis. Possible Values: LastInterest, EqualPayment, InterestAndPrincipal, InterestSeparatedm, Amortized, AddOn, NegativeAmortization, Simple, FHLMC.

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

An accrued date is a hypothetical point in time when the interest should have been paid.

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.

object

The period funds are earning interest.

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

Indicates the compounding method used for interest calculations.

object

Frequency of the interest calculation and compounded during the term.

object (Frequency)

Specifies an event frequency

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 (InterestRenewalDetails)

Detailed interest attributes related to rate change and account maturity.

object (InterestCycle)

Set of parameters used to calculate an interest cycle.

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

The amount of automatic interest that was last posted to the account.

reportingIndicator
boolean

Identifies whether interest paid is reportable.

reportingOptions
Array of strings (InterestReportingOption) [ items [ 1 .. 35 ] characters ]
Example: ["Deposit"]
object (TaxForm)

Information of the form requested by the tax payer.

object

The frequency used in calculating the Regulation DD Annual Percentage Yield (APY) when the financial institution requires interest to be withdrawn (i.e. compounding interest is not an option.) The Regulation DD Compound Frequency overrides the interest frequency only in computing the APY. For example, an account with interest paid monthly by check but disclosed as annual compounding.

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

Annual Percentage Yield (APY) is a measure used in finance to express the total return on an investment, taking into account both the interest earned and the appreciation in the investment's value, over a specified period. It is expressed as a percentage and is often used for fixed income securities such as bonds, and money market accounts.

daysSinceLastAnniversary
integer

The number of calendar days processed since the last anniversary date

Array of objects (InterestCalculationRate)

Rates involve on interest calculation.

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

pastDueOptions
Array of strings[ items [ 1 .. 70 ] characters ]

Indicates how the Past Due Rate is applied to past due loans. After a loan payment is past due after certain days, interest is earned retroactively from the payment due date.

referenceRateName
string

Identifies the reference index for the debt instrument.

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

Margin over or under an index which determines the interest rate of an interest bearing instrument. Percentage to be added to or deducted from the index rate to calculate the effective rate.

spreadRateAmount
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

spreadRatePercentageIndicator
boolean
basisPointSpread
integer

Provides the number of basis points added to (if positive) or deducted from (if negative) the underlying reference rate to calculate the actual interest rate applicable for a given period at issuance of the floating rate instrument. Used to express differences in interest rates, for example, a difference of 0.10% is equivalen

object (FinancialStatement)

Specifies financial statement details.

object

The frequency of the regular statement.

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.

numberOfTimes
integer
Example: 4

Number of times the event will be repeated.

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, Operator, VRU, Telebanc.

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)
periodNumber
integer

Sequence number of the period.

periodName
string (PeriodName)

Time of the year or previous. Possible Values: YearToDate, MonthToDate, PreviousYear, BeginningPreviousYear, QuarterToDate, PreviousQuarter, YearEnd

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.

object (Period)
periodNumber
integer

Sequence number of the period.

periodName
string (PeriodName)

Time of the year or previous. Possible Values: YearToDate, MonthToDate, PreviousYear, BeginningPreviousYear, QuarterToDate, PreviousQuarter, YearEnd

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.

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

The date of the last statement.

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

The date of the statement previous from the last.

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

The date of the last regular statement.

accountNameIndicator
boolean

Indicates whether the account name is printed on the statement.

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, Default.

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.

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

Account loundery risk level

Array of objects (CreditRankingScale)

Borrower credit ranking scores

Array
name
string (CreditRankingScaleName) [ 1 .. 35 ] characters
Example: "StandardAndPoors"

Most commonly used credit ranking scales. Possible Values: StandardAndPoors, MoodysInvestors. Also other values: Original, 1, 2, 3.

score
string [ 2 .. 10 ]
Example: "AAA"
object (BankruptcyProfile)
chapter
string [ 1 .. 10 ]
Example: "11"

The section on the Bankruptcy Code that sets out the rules and procedures for a particular type of bankruptcy. Possible Values: 7, 11, 13, 12, and 9.

status
string [ 1 .. 40 ]
Example: "Petition"

Bankruptcy status. Possible values: Petition, Discharged, DebtReaffirmation, DebtReaffirmationRescinded, PlanConfirmed, PlanCompleted, Withdrawn.

statementOption
string [ 1 .. 40 ]
Example: "RegularBillingStatement"

Statement option. Possible Values: RegularBillingStatement, BankruptcyBillingStatement

object

Indicates the frequency that the history profile payment status is established. Values are dependent upon credit bureau standards.

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.

numberOfTimes
integer
Example: 4

Number of times the event will be repeated.

paymentHistoryOption
string [ 1 .. 40 ]
Example: "NotRecalculate"

Indicates whether the Payment History Profile will be recalculated. Possible Values: Default, NotRecalculate, RecalculateAndSetToDefault, RecalculateAndSetToNot.

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

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

Specifies the date and time at which the all the balances amount were calculated.

Array of objects (SpotDate)

Specifies the date and time of transaction events.

Array
name
string (SpotDateName) [ 1 .. 40 ] characters
Example: "Expiration"

Specifies the name of Loan projected date. Possible values por projected dates: Forecast, Expiration, LastNonFinancial

date
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 (Balance)
Array
balanceName
required
string (BalanceName) [ 1 .. 40 ] characters
Example: "Available"

Specifies the nature of the balance. Possible values: Current, Available, Pending, Opening, Blocked, Previous, PendingLedger, LastAnniversary, CurrentAccrued, PreviousAccrued, CurrentWithLastCalculus, CarriedAdjustment, PaidWithPenalties, Accrued, Penalty, CollectionLedger, LastLedger, CurrentLedger, Withheld, CurrentBooked, CurrentBook. Loan Balances: CashProceeds, the amount that a customer actually received, exclusive of insurance premiums, fees, and unearned discount; FinancedExpenses, indicates the amount of expenses an institution has financed for a borrower; TotalInterest; AdditionalInterest, if the date of the first payment is beyond one month from the note date, the interest for the odd days will be earned during the first interest period; DeferredUnsecuredPrincipal, is the outstanding balance of an unsecured debt. The DUPB includes any accrued interest that is yet to be paid by the borrower. The deferral typically occurs due to bankruptcy or debt relief proceedings, which temporarily halt collection efforts by the original creditor; Charge Balances: Earned, RealTimeDeliveryMaximum, Current, Financed, Prepaid, CurrentEarned, CurrentEarnedOtherEscrow, InterestPaidToDate, BasePaidToDate, TotalPastDue, Escrow, OtherEscrow, FinalAmount, FinalInterestAmount, Chapter4PreviousYear.

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

count
integer

Number of transactions added to the amount.

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.

periodNumber
integer

Sequence number of the period.

periodName
string (PeriodName)

Time of the year or previous. Possible Values: YearToDate, MonthToDate, PreviousYear, BeginningPreviousYear, QuarterToDate, PreviousQuarter, YearEnd

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.

Array of objects (PaymentCardDescriptor)

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

Array
cardId
required
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.

object (RepaymentDetails)
numberOfPayments
integer

Number of repayments.

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, Curtailment.

Array of objects (PaymentIdentification)
Array of objects (Balance)

Other payment amounts

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, Curtailment.

Array of objects (PaymentIdentification)
Array of objects (Balance)

Other payment amounts

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

Payment date

object (RegularPayment)

The amount that a borrower is required to pay periodically (usually monthly) to gradually repay the loan principal along with the accumulated interest

Array of objects (Balance)

Regular payment balances

object (CreditTransferDetail)

Further details on the credit transfer instruction

object

How often principal payments are due.

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.

numberOfTimes
integer
Example: 4

Number of times the event will be repeated.

object

How often interest payments are due.

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.

numberOfTimes
integer
Example: 4

Number of times the event will be repeated.

draftDayAdjuster
integer <= 31
Example: 30

Number of days before or after an automatic payment is debited from an account.

principalVarianceOptions
Array of strings[ items [ 1 .. 70 ] characters ]

Indicates whether, prior to the loan going past due, a payment is generated using previous extra principal payments if any curtailments have been made.

automaticIndicator
boolean

Indicates whether, prior to the loan going past due, a payment is automatic generated.

Array of objects (GenericCode)

Additional relationship codes.

Array
name
string [ 1 .. 50 ] characters
Example: "Incoming Wire"

Name of the code in PascalCase.

value
string [ 1 .. 35 ] characters
Example: "195"

Code value to identify the type of transaction.

splitOptions
Array of strings[ items [ 1 .. 70 ] characters ]

Indicates the split payment options.

Array of objects (PastDueTimes)

Indicates the past due times on different periods.

Array
number
integer

Number of times a payment is past due on a period.

fromDay
integer (Day) <= 31
Example: 30

Specifies the date in a month.

toDay
integer (Day) <= 31
Example: 30

Specifies the date in a month.

authorizedAccount
string [ 1 .. 36 ] characters
Example: "033-DDA-123456"

Specifies the account on which the power of attorney applies.

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

First payment date

object (RepaymentBillDetails)

Billing information of the payment

billingDay
integer <= 31
Example: 30

Identifies the day of the month that billing statements are generated.

rebillStatus
string (RepaymentBillStatus) [ 1 .. 40 ] characters
Example: "RebillRequest"

Indicates whether a payment will be recalculated, rebilled and notified to the customer. Possible values: NoRequest, RebillRequest, ReNotifyCustomer.

rebillInterestIndicator
boolean

Indicates whether interest will be rebilled when transactions occur during the forecast period.

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

The statement date interest was billed.

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

The due date of the next interest payment due that is not past due.

Array of objects (Balance)

Bill balances

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

Principal reduction, also known as a haircut, is a type of financial engineering tool that allows lenders to reduce the principal amount of a loan before the loan has reached its full maturity. The unscheduled principal reduction is the amount of the reduction that is applied to the principal balance as a result of the lender's decision to reduce the principal amount of the loan outside of the reduction schedule agreed upon by the lender and the borrower.

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

The Reapplied Reduction is the amount of the reduction that is applied to the principal balance after a scheduled principal reduction event has occurred.

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.

reviewDateEvents
Array of strings (LoanReviewDateEvent) [ items [ 1 .. 40 ] characters ]
Example: ["ElegibleForHAMP"]
object (LoanDetailedStatus)

Specifies the current state of a loan.

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, WriteDown, WrittenOff, Active, PaymentPastDue, Foreclosure, Bankruptcy.

statusDateAndTime
string <date-time> (DateAndTime)
Example: "2022-04-17T08:00:00Z"
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.

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.

accrualStatus
string (LoanNonAccrualStatus) [ 1 .. 17 ] characters
Example: "NonAccrual"

Specifies the current Non Accrual state of a Loan. Possible values names are: NonAccrual, Accrual.

nonAccrualProcess
string (LoanNonAccrualProcess) [ 1 .. 36 ] characters
Example: "PastDueXDays"

Specifies the current Non Accrual process of a Loan. Possible values names are: PastDueXDays, InterestAutomaticAdjustment, ManuallyWithAutomaticReturn, ManuallyWithOutAutomaticReturn, PastDueWillOutAutomatic.

renegotiatedIndicator
boolean

Indicates whether a loan is a product of renegotiation. If a loan has been renegotiated, it has replaced a previous loan that may have been in default.

convertedLoanIndicator
boolean

Indicates whether the loan is coverted. In the context of a mortgage, a converted loan is a type of loan where the mortgage note's face value can be increased, or decreased, at the option of the lender.

object (LoanPayOffDetail)

Detail information of Loan Pay Off

balanceOptions
Array of strings[ items [ 1 .. 70 ] characters ]

Indicates pay-off options for the loan.

displayIndicator
boolean

Indicates wether the pay-off amount is displayed.

calculationMethodOptions
Array of strings[ items [ 1 .. 70 ] characters ]

Indicates method options for the pay off calculation.

Responses

Request samples

Content type
application/merge-patch+json
{
  • "accountBranchId": "SEA_1",
  • "accountNumber": "012345678",
  • "accountType": "Checking",
  • "routingNumbers": [
    ],
  • "identifiers": [
    ],
  • "loanBranchId": "SEA_1",
  • "loanType": "Personal",
  • "recourseType": "FullRecourse",
  • "balanceType": "Asset",
  • "lendingRelationType": "Direct",
  • "securedLoanIndicator": true,
  • "ownershipType": "SingleOwnerAccount",
  • "productId": "PD_CA_0002",
  • "name": "Hermes PD_CA 0002",
  • "accountPurpose": "This is a description.",
  • "currency": "USD",
  • "contract": {
    },
  • "parties": [
    ],
  • "relatedAccounts": [
    ],
  • "principalAmount": "100",
  • "interestAmount": "100",
  • "maturityDate": "2022-04-17",
  • "mortage": {
    },
  • "rateForecastDays": 0,
  • "projectedDates": [
    ],
  • "restrictions": [
    ],
  • "limits": [
    ],
  • "interests": [
    ],
  • "statement": {
    },
  • "profile": {
    },
  • "supplementaryData": { },
  • "ammountCalculationDate": "2022-04-17T08:00:00Z",
  • "transactionDates": [
    ],
  • "balances": [
    ],
  • "relatedCards": [
    ],
  • "payment": {
    },
  • "unscheduledPrincipalReduction": "100",
  • "totalReappliedReduction": "100",
  • "accruedCapitalisationAmount": "100",
  • "reviewDateEvents": [
    ],
  • "status": {
    },
  • "payOff": {
    }
}

Response samples

Content type
application/json
{
  • "accountBranchId": "SEA_1",
  • "accountNumber": "012345678",
  • "accountType": "Checking",
  • "routingNumbers": [
    ],
  • "identifiers": [
    ],
  • "loanBranchId": "SEA_1",
  • "loanType": "Personal",
  • "recourseType": "FullRecourse",
  • "balanceType": "Asset",
  • "lendingRelationType": "Direct",
  • "securedLoanIndicator": true,
  • "ownershipType": "SingleOwnerAccount",
  • "productId": "PD_CA_0002",
  • "name": "Hermes PD_CA 0002",
  • "accountPurpose": "This is a description.",
  • "currency": "USD",
  • "contract": {
    },
  • "parties": [
    ],
  • "relatedAccounts": [
    ],
  • "principalAmount": "100",
  • "interestAmount": "100",
  • "maturityDate": "2022-04-17",
  • "mortage": {
    },
  • "rateForecastDays": 0,
  • "projectedDates": [
    ],
  • "restrictions": [
    ],
  • "limits": [
    ],
  • "interests": [
    ],
  • "statement": {
    },
  • "profile": {
    },
  • "supplementaryData": { },
  • "ammountCalculationDate": "2022-04-17T08:00:00Z",
  • "transactionDates": [
    ],
  • "balances": [
    ],
  • "accountId": "033-DDA-123456",
  • "relatedCards": [
    ],
  • "payment": {
    },
  • "unscheduledPrincipalReduction": "100",
  • "totalReappliedReduction": "100",
  • "accruedCapitalisationAmount": "100",
  • "reviewDateEvents": [
    ],
  • "status": {
    },
  • "payOff": {
    }
}

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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

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

Responses

Response samples

Content type
application/json
{
  • "loanId": "033-DDA-123456",
  • "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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

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

Pagination-Cursor
required
string

Pagination Cursor

Pagination-Total
required
string

Total number of resources.

Responses

Response samples

Content type
application/json
{
  • "loanId": "033-DDA-123456",
  • "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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

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

Responses

Response samples

Content type
application/json
{
  • "accountBranchId": "SEA_1",
  • "accountNumber": "012345678",
  • "accountType": "Checking",
  • "routingNumbers": [
    ],
  • "identifiers": [
    ],
  • "loanId": "033-DDA-123456",
  • "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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

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

Responses

Response samples

Content type
application/json
{
  • "loanId": "033-DDA-123456",
  • "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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

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

Responses

Response samples

Content type
application/json
{
  • "accountId": "033-DDA-123456",
  • "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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

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

Responses

Response samples

Content type
application/json
{
  • "loanId": "033-DDA-123456",
  • "accountNumber": "012345678",
  • "cards": [
    ],
  • "ammountCalculationDate": "2022-04-17T08:00:00Z",
  • "transactionDates": [
    ],
  • "balances": [
    ]
}

Account Holds

Request an account hold

Authorizations:
jwtopenIdConnect
path Parameters
accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: 033-DDA-123456

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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

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

Request Body schema: application/json
holdId
string (Id) [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"
holdType
string (AccountHoldType) [ 1 .. 35 ] characters

Possible Values: Amount, holds any amount for any purpose; Check, holds the entire amount of a check or a partial amount until the check clears; StopPayment, stop payment on a check; Caution, a hold occurs when there is suspicious activity detected on the account.

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

Date/time that the hold was created or should take effect.

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

Date/time that the hold should be released.

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

Date/time that the hold was actually released.

object (Check)

Characteristics of a check

checkType
string

Specifies the type of the check. Possible values are: CustomerCheque, CertifiedCustomerCheque, BankCheque, Draft, ElectronicDraft.

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

Check amount

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

Check currency

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).

availabilityFloat
string

It refers to the time delay between when a check is deposited and when the funds become available for withdrawal. Possible Values: ImmediateWithdrawal, LocalCheck, NonLocalCheck

Responses

Request samples

Content type
application/json
{
  • "holdId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "holdType": "string",
  • "effectiveDate": "2022-04-17T08:00:00Z",
  • "releaseDate": "2022-04-17T08:00:00Z",
  • "actualReleaseDate": "2022-04-17T08:00:00Z",
  • "check": {
    }
}

Response samples

Content type
application/json
{
  • "holdId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "status": "string",
  • "holdType": "string",
  • "effectiveDate": "2022-04-17T08:00:00Z",
  • "releaseDate": "2022-04-17T08:00:00Z",
  • "actualReleaseDate": "2022-04-17T08:00:00Z",
  • "check": {
    }
}

Retrieves Account Holds

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

Account Hold Identification

accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: 033-DDA-123456

Account Identification

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

Account Servicer Identification (Bank)

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

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

Responses

Response samples

Content type
application/json
{
  • "holdId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "status": "string",
  • "holdType": "string",
  • "effectiveDate": "2022-04-17T08:00:00Z",
  • "releaseDate": "2022-04-17T08:00:00Z",
  • "actualReleaseDate": "2022-04-17T08:00:00Z",
  • "check": {
    }
}

Updates an account hold

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

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

Account Hold Identification

accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: 033-DDA-123456

Account Identification

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

Account Servicer Identification (Bank)

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

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

Request Body schema: application/merge-patch+json
holdId
string [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"

Identification assigned by the account service institution (Servicer). Could be encoded (UUID). Also may be used as composite account identifier when overlaying the account code parts. [branch-type-subtype-number]

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

Possible Values: Release, Active.

holdType
string (AccountHoldType) [ 1 .. 35 ] characters

Possible Values: Amount, holds any amount for any purpose; Check, holds the entire amount of a check or a partial amount until the check clears; StopPayment, stop payment on a check; Caution, a hold occurs when there is suspicious activity detected on the account.

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

Date/time that the hold was created or should take effect.

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

Date/time that the hold should be released.

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

Date/time that the hold was actually released.

object (Check)

Characteristics of a check

checkType
string

Specifies the type of the check. Possible values are: CustomerCheque, CertifiedCustomerCheque, BankCheque, Draft, ElectronicDraft.

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

Check amount

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

Check currency

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).

availabilityFloat
string

It refers to the time delay between when a check is deposited and when the funds become available for withdrawal. Possible Values: ImmediateWithdrawal, LocalCheck, NonLocalCheck

Responses

Request samples

Content type
application/merge-patch+json
{
  • "holdId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "status": "string",
  • "holdType": "string",
  • "effectiveDate": "2022-04-17T08:00:00Z",
  • "releaseDate": "2022-04-17T08:00:00Z",
  • "actualReleaseDate": "2022-04-17T08:00:00Z",
  • "check": {
    }
}

Response samples

Content type
application/json
{
  • "holdId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "status": "string",
  • "holdType": "string",
  • "effectiveDate": "2022-04-17T08:00:00Z",
  • "releaseDate": "2022-04-17T08:00:00Z",
  • "actualReleaseDate": "2022-04-17T08:00:00Z",
  • "check": {
    }
}

Standing Orders

Request Standing Order Cancellation

Authorizations:
jwtopenIdConnect
path Parameters
accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: 033-DDA-123456

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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

Identification of the account servicer institution at branch level or center 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": "Sent",
  • "statusDateAndTime": "2022-04-17T08:00:00Z",
  • "cancellationReason": "This is a description."
}

Relationships

Retrieves Person Relationships

Retrieves all the bank relationships the person may have.

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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

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

Responses

Response samples

Content type
application/json
{
  • "personId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "personName": "Jane Birkin",
  • "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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

Identification of the account servicer institution at branch level or center 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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

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

Request Body schema: application/json
object (CustomerRelationshipParty)
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

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

Type of relation between parties. Possible values Between Organizations and persons are: ResponsibleParty, Owner, ControlPerson, BeneficialOwner, PrimaryContact, SecondaryContact, VicePresident, President, Treasurer, Secretary, Partner. Between Persons and Organizations: Business, Organization. For Trusts: Trustor, Trustee. Between organizations: Subsidiary, ParentOrganization, Branch. Between parties and external entities: AccountOpenningOfficer, CustomerServiceOfficer, PrimaryServicerOfficer, SecondaryServicerOfficer, SalesPerson, ReferralOfficer. Between financial institutions: AffiliateFinancialInstitution, HoldingCompany. Between persons: Spouse, Aunt, Brother, Companion, Daugther, Father, Friend, Granddaugther, Grandmother, Grandfather, Grandson, Husband, Mother, Nephew, Niece, Sister, Son, Uncle, Wife, Child, Grandparent. Grandchild, Sibling, Parent, Partner.

priorityIndicator
boolean

Indicates whether the related party is a priority.

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

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

accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: "033-DDA-123456"

Identification assigned by the account service institution (Servicer). Could be encoded (UUID). Also may be used as composite account identifier when overlaying the account code parts. [branch-type-subtype-number]

primaryIndicator
boolean

Indicates whether the account related is primary.

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

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

accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: "033-DDA-123456"

Identification assigned by the account service institution (Servicer). Could be encoded (UUID). Also may be used as composite account identifier when overlaying the account code parts. [branch-type-subtype-number]

primaryIndicator
boolean

Indicates whether the account related is primary.

Array of objects (PaymentCardDescriptor)
Array
cardId
required
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.

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, Operator, VRU, Telebanc.

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 communication 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, Operator, VRU, Telebanc.

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

Maintenance activity of a resource. Possible values: Transaction, Modification, Deposit, Withdrawal, Creation, DirectDeposit, CardActivation, CardActivation, CardActivationByCallerId, CardActivationByCodeAndCallerId.

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 (GenericCode)

Additional relationship codes.

Array
name
string [ 1 .. 50 ] characters
Example: "Incoming Wire"

Name of the code in PascalCase.

value
string [ 1 .. 35 ] characters
Example: "195"

Code value to identify the type of transaction.

Responses

Request samples

Content type
application/json
{
  • "parties": {
    },
  • "accounts": [
    ],
  • "loans": [
    ],
  • "cards": [
    ],
  • "audit": {
    },
  • "codes": [
    ]
}

Response samples

Content type
application/json
{
  • "parties": {
    },
  • "accounts": [
    ],
  • "loans": [
    ],
  • "cards": [
    ],
  • "audit": {
    },
  • "codes": [
    ],
  • "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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

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

Responses

Response samples

Content type
application/json
{
  • "parties": {
    },
  • "accounts": [
    ],
  • "loans": [
    ],
  • "cards": [
    ],
  • "audit": {
    },
  • "codes": [
    ],
  • "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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

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

Request Body schema: application/merge-patch+json
object (CustomerRelationshipParty)
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

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

Type of relation between parties. Possible values Between Organizations and persons are: ResponsibleParty, Owner, ControlPerson, BeneficialOwner, PrimaryContact, SecondaryContact, VicePresident, President, Treasurer, Secretary, Partner. Between Persons and Organizations: Business, Organization. For Trusts: Trustor, Trustee. Between organizations: Subsidiary, ParentOrganization, Branch. Between parties and external entities: AccountOpenningOfficer, CustomerServiceOfficer, PrimaryServicerOfficer, SecondaryServicerOfficer, SalesPerson, ReferralOfficer. Between financial institutions: AffiliateFinancialInstitution, HoldingCompany. Between persons: Spouse, Aunt, Brother, Companion, Daugther, Father, Friend, Granddaugther, Grandmother, Grandfather, Grandson, Husband, Mother, Nephew, Niece, Sister, Son, Uncle, Wife, Child, Grandparent. Grandchild, Sibling, Parent, Partner.

priorityIndicator
boolean

Indicates whether the related party is a priority.

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

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

accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: "033-DDA-123456"

Identification assigned by the account service institution (Servicer). Could be encoded (UUID). Also may be used as composite account identifier when overlaying the account code parts. [branch-type-subtype-number]

primaryIndicator
boolean

Indicates whether the account related is primary.

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

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

accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: "033-DDA-123456"

Identification assigned by the account service institution (Servicer). Could be encoded (UUID). Also may be used as composite account identifier when overlaying the account code parts. [branch-type-subtype-number]

primaryIndicator
boolean

Indicates whether the account related is primary.

Array of objects (PaymentCardDescriptor)
Array
cardId
required
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.

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, Operator, VRU, Telebanc.

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 communication 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, Operator, VRU, Telebanc.

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

Maintenance activity of a resource. Possible values: Transaction, Modification, Deposit, Withdrawal, Creation, DirectDeposit, CardActivation, CardActivation, CardActivationByCallerId, CardActivationByCodeAndCallerId.

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 (GenericCode)

Additional relationship codes.

Array
name
string [ 1 .. 50 ] characters
Example: "Incoming Wire"

Name of the code in PascalCase.

value
string [ 1 .. 35 ] characters
Example: "195"

Code value to identify the type of transaction.

status
string (CustomerRelationshipStatus) [ 1 .. 60 ] characters
Example: "Active"

Specifies the status al a customer relationship. Some possible values are: Active, Closed, Inactive, Prospect, Restricted

Responses

Request samples

Content type
application/merge-patch+json
{
  • "parties": {
    },
  • "accounts": [
    ],
  • "loans": [
    ],
  • "cards": [
    ],
  • "audit": {
    },
  • "codes": [
    ],
  • "status": "Active"
}

Response samples

Content type
application/json
{
  • "parties": {
    },
  • "accounts": [
    ],
  • "loans": [
    ],
  • "cards": [
    ],
  • "audit": {
    },
  • "codes": [
    ],
  • "relationshipId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "status": "Active"
}

Retrieves Relationship Parties

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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

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

Responses

Response samples

Content type
application/json
{
  • "relationshipId": "033-DDA-123456",
  • "parties": [
    ]
}

Retrieves Customer Relationship Persons

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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

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

Responses

Response samples

Content type
application/json
{
  • "relationshipId": "033-DDA-123456",
  • "persons": [
    ]
}

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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

Identification of the account servicer institution at branch level or center 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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

Identification of the account servicer institution at branch level or center 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.

balanceType
string (Balance Type)
Example: "Asset"

Account Balance Type. Possible Values: Asset, positive transaction amount increases balance; Liability, positive transaction amount decreases balance; 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, AssociatedAccount.

accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: "033-DDA-123456"

Identification assigned by the account service institution (Servicer). Could be encoded (UUID). Also may be used as composite account identifier when overlaying the account code parts. [branch-type-subtype-number]

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",
  • "balanceType": "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",
  • "balanceType": "Asset",
  • "accountCategory": "1",
  • "name": "Hermes PD_CA 0002",
  • "number": "1-001",
  • "accountPurpose": "This is a description.",
  • "currency": "USD",
  • "relatedAccounts": [
    ],
  • "supplementaryData": { },
  • "accountId": "033-DDA-123456",
  • "accountBranchId": "SEA_1",
  • "balances": [
    ],
  • "status": "Active"
}

Retrieves a Ledger Account

Authorizations:
jwtopenIdConnect
path Parameters
accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: 033-DDA-123456

Account Identification

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

Account Servicer Identification (Bank)

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

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

Responses

Response samples

Content type
application/json
{
  • "accountType": "GeneralLedger",
  • "balanceType": "Asset",
  • "accountCategory": "1",
  • "name": "Hermes PD_CA 0002",
  • "number": "1-001",
  • "accountPurpose": "This is a description.",
  • "currency": "USD",
  • "relatedAccounts": [
    ],
  • "supplementaryData": { },
  • "accountId": "033-DDA-123456",
  • "accountBranchId": "SEA_1",
  • "balances": [
    ],
  • "status": "Active"
}

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: 033-DDA-123456

Account Identification

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

Account Servicer Identification (Bank)

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

Identification of the account servicer institution at branch level or center 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.

balanceType
string (Balance Type)
Example: "Asset"

Account Balance Type. Possible Values: Asset, positive transaction amount increases balance; Liability, positive transaction amount decreases balance; 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, AssociatedAccount.

accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: "033-DDA-123456"

Identification assigned by the account service institution (Servicer). Could be encoded (UUID). Also may be used as composite account identifier when overlaying the account code parts. [branch-type-subtype-number]

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

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

Identification of the account servicer institution at branch level or center level. To overlay the codes to produce a unique identifier the following expresion is used: BranchRegionCode-BranchSubdivisionCode.

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: "Active"

Specifies the current primary status of an account. Possible values are: Enabled, Dormant, Disable, Deleted, Pending, Form. Pending, Denied, Review, Approve, ChargeOff, Active, PaymentPastDue, Bankruptcy, AuthorizationProhibited, InterestProhibited.

Responses

Request samples

Content type
application/merge-patch+json
{
  • "accountType": "GeneralLedger",
  • "balanceType": "Asset",
  • "accountCategory": "1",
  • "name": "Hermes PD_CA 0002",
  • "number": "1-001",
  • "accountPurpose": "This is a description.",
  • "currency": "USD",
  • "relatedAccounts": [
    ],
  • "supplementaryData": { },
  • "accountBranchId": "SEA_1",
  • "balances": [
    ],
  • "status": "Active"
}

Response samples

Content type
application/json
{
  • "accountType": "GeneralLedger",
  • "balanceType": "Asset",
  • "accountCategory": "1",
  • "name": "Hermes PD_CA 0002",
  • "number": "1-001",
  • "accountPurpose": "This is a description.",
  • "currency": "USD",
  • "relatedAccounts": [
    ],
  • "supplementaryData": { },
  • "accountId": "033-DDA-123456",
  • "accountBranchId": "SEA_1",
  • "balances": [
    ],
  • "status": "Active"
}

Retrieves Account Balances

Authorizations:
jwtopenIdConnect
path Parameters
accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: 033-DDA-123456

Account Identification

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

Account Servicer Identification (Bank)

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

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

Responses

Response samples

Content type
application/json
{
  • "accountId": "033-DDA-123456",
  • "accountNumber": "1-001",
  • "accountType": "GeneralLedger",
  • "balances": [
    ]
}

Retrieves Ledger Account Transactions

Authorizations:
jwtopenIdConnect
path Parameters
accountId
required
string (AccountId) [ 1 .. 36 ] characters
Example: 033-DDA-123456

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": "033-DDA-123456",
  • "accountNumber": "1-001",
  • "accountType": "GeneralLedger",
  • "currentBalance": "100",
  • "transactions": [
    ]
}

Internal Transfers

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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

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

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Internal Transfer Request

Instruction to transfer funds between ledger accounts, holding accounts, or final account. To create a balanced internal transfer, there must be at least one credit entry and one debit entry. Additionally, the sum of all credit entry amounts must equal the sum of all debit entry amounts.

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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

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

Request Body schema: application/json
Array of objects (PaymentIdentification)
Array
number
required
string [ 1 .. 35 ] characters

Unique and unambiguous identification of a payment.

schemeName
string [ 1 .. 36 ] characters
Example: "UETR"

Name of other payment identificaction. For instance, ISOInitiationMessageIdentifier, InstructionIdentification (Unique identification, as assigned by the first instructing agent, to unambiguously identify the transaction that is passed on, unchanged, throughout the entire interbank chain Usage: The transaction identification can be used for reconciliation, tracking or to link tasks relating to the transaction on the interbank level. The instructing agent has to make sure that the transaction identification is unique for a pre-agreed period), UETR (Universally unique identifier to provide an end-to-end reference of a payment transaction), ExecutionIdentification, EndToEndIdentification, InstructionIdentification, TransactionIdentification, ClearingSystemReference, CreditorReference, CounterpartyReference, UniqueTradeIdentifier, ClearingBrokerIdentification, UniqueTradeIdentifier, ClearingBrokerIdentification, CommonIdentification.

issuer
string
Example: "Banc of California"

Entity that assigns the identification.

domain
string (BankTransactionDomain) [ 1 .. 35 ] characters
Example: "Payments"

Specifies the bank transaction code domain. Some possible ISO 20022 compliant values are: Payments, CashManagement, Loans, Deposits, TradeServices, Syndications, Securities, 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, IssuedCreditTransfers

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, InternalBookTransfer, PrincipalPayment, LoanAdvance,

Array of objects (GenericTransactionCode)

Additional transaction codes.

Array
codeType
required
string [ 1 .. 50 ] characters
Example: "DetailBAI"

Name of the code in PascalCase form. Possible values are: DetailBAI, SummaryBAI, MT940

name
string [ 1 .. 50 ] characters
Example: "Incoming Wire"

Code value description

value
string [ 1 .. 35 ] characters
Example: "195"

Code value to identify the type of transaction.

transferId
string (Id) [ 1 .. 36 ] characters
Example: "5fb9d4d6-1a3c-11ed-861d-0242ac120002"
reversalIndicator
boolean (ReversalIndicator)

Indicates whether or not the transaction is the result of a reversal. Usage: This element should only be present if the entry is the result of a reversal. If the CreditDebitIndicator is Credit and ReversalIndicator is Yes, the original operation was a debit entry. If the CreditDebitIndicator is Debit and ReversalIndicator is Yes, the original operation was a credit entry.

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 values names are: Credit, Debit.

reversalIndicator
boolean (ReversalIndicator)

Indicates whether or not the transaction is the result of a reversal. Usage: This element should only be present if the entry is the result of a reversal. If the CreditDebitIndicator is Credit and ReversalIndicator is Yes, the original operation was a debit entry. If the CreditDebitIndicator is Debit and ReversalIndicator is Yes, the original operation was a credit entry.

accountId
string (AccountId) [ 1 .. 36 ] characters
Example: "033-DDA-123456"

Identification assigned by the account service institution (Servicer). Could be encoded (UUID). Also may be used as composite account identifier when overlaying the account code parts. [branch-type-subtype-number]

accountType
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.

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.

purpose
string (Description) [ 1 .. 1025 ] characters
Example: "This is a description."
descriptionLines
Array of strings[ items [ 1 .. 70 ] 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.

object (TransferSettlement)

Transfer settlement information.

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

Future transfer posting date. If the posting date is left blank, it will be assumed to be the current date. When creating a MemoPost for an outgoing payment, after this date, the memo record is automatically expired. You can see this change from the status, which is changed from MemoPosted to Expired.

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

Indicates the type of posting. Possible values: MemoPosted, HardPosted.

object

Time of the day of the posting date.

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

timeOfTheDay
string

Time of the day. Possible Values: AfterMidnight, after midnight and before business day; AfterBusinessDay, after business day and before midnight.

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.

numberOfTimes
integer
Example: 4

Number of times the event will be repeated.

memopostedIndicator
boolean

Indicates whether the internal transfer has been memoposted.

Array of objects (Check)
Array
checkType
string

Specifies the type of the check. Possible values are: CustomerCheque, CertifiedCustomerCheque, BankCheque, Draft, ElectronicDraft.

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

Check amount

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

Check currency

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).

availabilityFloat
string

It refers to the time delay between when a check is deposited and when the funds become available for withdrawal. Possible Values: ImmediateWithdrawal, LocalCheck, NonLocalCheck

Array of objects (Cash)
Array
amount
string

Amount in cash

denomination
string
Example: "100"

The face value of each cash note, such as $1, $5, $10, $20, etc.

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

Amount currency

Responses

Request samples

Content type
application/json
{
  • "identifiers": [
    ],
  • "domain": "Payments",
  • "family": "CustomerCardTransactions",
  • "subFamily": "CreditCardPayment",
  • "codes": [
    ],
  • "transferId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "reversalIndicator": true,
  • "entries": [
    ],
  • "purpose": "This is a description.",
  • "descriptionLines": [
    ],
  • "reason": "CashManagementTransfer",
  • "settlement": {
    },
  • "checks": [
    ],
  • "cashNotes": [
    ]
}

Response samples

Content type
application/json
{
  • "data": {
    },
  • "metadata": {
    }
}

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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

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

Responses

Response samples

Content type
application/json
{
  • "identifiers": [
    ],
  • "domain": "Payments",
  • "family": "CustomerCardTransactions",
  • "subFamily": "CreditCardPayment",
  • "codes": [
    ],
  • "transferId": "5fb9d4d6-1a3c-11ed-861d-0242ac120002",
  • "reversalIndicator": true,
  • "entries": [
    ],
  • "purpose": "This is a description.",
  • "descriptionLines": [
    ],
  • "reason": "CashManagementTransfer",
  • "settlement": {
    },
  • "checks": [
    ],
  • "cashNotes": [
    ],
  • "date": "2022-04-17T08:00:00Z",
  • "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 (ServicerBranchId) [ 1 .. 36 ] characters
Example: SEA_1

Identification of the account servicer institution at branch level or center 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"
}