@lap v0.3
# Machine-readable API spec. Each @endpoint block is one API call.
@api Legal Entity Management API
@base https://kyc-test.adyen.com/lem/v3
@version 3
@auth ApiKey X-API-Key in header | Bearer basic
@endpoints 34
@hint download_for_search
@toc businessLines(4), documents(4), legalEntities(20), themes(2), transferInstruments(4)

@group businessLines
@endpoint POST /businessLines
@required {industryCode: str, legalEntityId: str, service: str(paymentProcessing/banking)}
@optional {capability: str(receivePayments/receiveFromPlatformPayments/issueBankAccount), salesChannels: [str], sourceOfFunds: map{acquiringBusinessLineId: str, adyenProcessedFunds: bool, description: str, type: str}, webData: [map{webAddress: str, webAddressId: str}], webDataExemption: map{reason: str}}
@returns(200) {capability: str, id: str, industryCode: str, legalEntityId: str, problems: [map], salesChannels: [str], service: str, sourceOfFunds: map{acquiringBusinessLineId: str, adyenProcessedFunds: bool, description: str, type: str}, webData: [map], webDataExemption: map{reason: str}}
@errors {400, 401, 403, 422, 500}

@endpoint GET /businessLines/{id}
@required {id: str}
@returns(200) {capability: str, id: str, industryCode: str, legalEntityId: str, problems: [map], salesChannels: [str], service: str, sourceOfFunds: map{acquiringBusinessLineId: str, adyenProcessedFunds: bool, description: str, type: str}, webData: [map], webDataExemption: map{reason: str}}
@errors {400, 401, 403, 422, 500}

@endpoint DELETE /businessLines/{id}
@required {id: str}
@returns(204)
@errors {400, 401, 403, 422, 500}

@endpoint PATCH /businessLines/{id}
@required {id: str}
@optional {industryCode: str, salesChannels: [str], sourceOfFunds: map{acquiringBusinessLineId: str, adyenProcessedFunds: bool, description: str, type: str}, webData: [map{webAddress: str, webAddressId: str}], webDataExemption: map{reason: str}}
@returns(200) {capability: str, id: str, industryCode: str, legalEntityId: str, problems: [map], salesChannels: [str], service: str, sourceOfFunds: map{acquiringBusinessLineId: str, adyenProcessedFunds: bool, description: str, type: str}, webData: [map], webDataExemption: map{reason: str}}
@errors {400, 401, 403, 422, 500}

@endgroup

@group documents
@endpoint POST /documents
@required {description: str, type: str(bankStatement/driversLicense/identityCard/nationalIdNumber/passport/proofOfAddress/proofOfNationalIdNumber/proofOfResidency/registrationDocument/vatDocument/proofOfOrganizationTaxInfo/proofOfIndividualTaxId/proofOfOwnership/proofOfSignatory/liveSelfie/proofOfIndustry/constitutionalDocument/proofOfFundingOrWealthSource/proofOfRelationship)}
@optional {x-requested-verification-code: str, attachment: map{content!: str(byte), contentType: str, filename: str, pageName: str, pageType: str}, attachments: [map{content!: str(byte), contentType: str, filename: str, pageName: str, pageType: str}], creationDate: str(date-time), expiryDate: str, fileName: str, id: str, issuerCountry: str, issuerState: str, modificationDate: str(date-time), number: str, owner: map{id!: str, type!: str}}
@returns(200) {attachment: map{content: str(byte), contentType: str, filename: str, pageName: str, pageType: str}, attachments: [map], creationDate: str(date-time), description: str, expiryDate: str, fileName: str, id: str, issuerCountry: str, issuerState: str, modificationDate: str(date-time), number: str, owner: map{id: str, type: str}, type: str}
@errors {400, 401, 403, 422, 500}

@endpoint GET /documents/{id}
@required {id: str}
@optional {skipContent: bool}
@returns(200) {attachment: map{content: str(byte), contentType: str, filename: str, pageName: str, pageType: str}, attachments: [map], creationDate: str(date-time), description: str, expiryDate: str, fileName: str, id: str, issuerCountry: str, issuerState: str, modificationDate: str(date-time), number: str, owner: map{id: str, type: str}, type: str}
@errors {400, 401, 403, 422, 500}

@endpoint DELETE /documents/{id}
@required {id: str}
@returns(204)
@errors {400, 401, 403, 422, 500}

@endpoint PATCH /documents/{id}
@required {id: str, description: str, type: str(bankStatement/driversLicense/identityCard/nationalIdNumber/passport/proofOfAddress/proofOfNationalIdNumber/proofOfResidency/registrationDocument/vatDocument/proofOfOrganizationTaxInfo/proofOfIndividualTaxId/proofOfOwnership/proofOfSignatory/liveSelfie/proofOfIndustry/constitutionalDocument/proofOfFundingOrWealthSource/proofOfRelationship)}
@optional {x-requested-verification-code: str, attachment: map{content!: str(byte), contentType: str, filename: str, pageName: str, pageType: str}, attachments: [map{content!: str(byte), contentType: str, filename: str, pageName: str, pageType: str}], creationDate: str(date-time), expiryDate: str, fileName: str, id: str, issuerCountry: str, issuerState: str, modificationDate: str(date-time), number: str, owner: map{id!: str, type!: str}}
@returns(200) {attachment: map{content: str(byte), contentType: str, filename: str, pageName: str, pageType: str}, attachments: [map], creationDate: str(date-time), description: str, expiryDate: str, fileName: str, id: str, issuerCountry: str, issuerState: str, modificationDate: str(date-time), number: str, owner: map{id: str, type: str}, type: str}
@errors {400, 401, 403, 422, 500}

@endgroup

@group legalEntities
@endpoint POST /legalEntities
@required {type: str(individual/organization/soleProprietorship/trust/unincorporatedPartnership)}
@optional {x-requested-verification-code: str, capabilities: map, entityAssociations: [map{associatorId: str, entityType: str, jobTitle: str, legalEntityId!: str, name: str, nominee: bool, relationship: str, settlorExemptionReason: [str], type!: str}], individual: map{birthData: map, email: str, identificationData: map, name!: map, nationality: str, phone: map, residentialAddress!: map, taxInformation: [map], webData: map}, organization: map{countryOfGoverningLaw: str, dateOfIncorporation: str, dateOfInitiationOfLegalProceeding: str, description: str, doingBusinessAs: str, economicSector: str, email: str, financialReports: [map], globalLegalEntityIdentifier: str, headOfficeIndicator: bool, institutionalSector: str, legalForm: str, legalName!: str, phone: map, principalPlaceOfBusiness: map, registeredAddress!: map, registrationNumber: str, statusOfLegalProceeding: str, stockData: map, taxInformation: [map], taxReportingClassification: map, type: str, vatAbsenceReason: str, vatNumber: str, webData: map}, reference: str, soleProprietorship: map{countryOfGoverningLaw!: str, dateOfIncorporation: str, doingBusinessAs: str, financialReports: [map], name!: str, principalPlaceOfBusiness: map, registeredAddress!: map, registrationNumber: str, taxAbsent: bool, taxInformation: [map], vatAbsenceReason: str, vatNumber: str}, trust: map{countryOfGoverningLaw!: str, dateOfIncorporation: str, description: str, doingBusinessAs: str, name!: str, principalPlaceOfBusiness: map, registeredAddress!: map, registrationNumber: str, taxInformation: [map], type!: str, undefinedBeneficiaryInfo: [map], vatAbsenceReason: str, vatNumber: str}, unincorporatedPartnership: map{countryOfGoverningLaw!: str, dateOfIncorporation: str, description: str, doingBusinessAs: str, name!: str, principalPlaceOfBusiness: map, registeredAddress!: map, registrationNumber: str, taxInformation: [map], type: str, vatAbsenceReason: str, vatNumber: str}, verificationPlan: str}
@returns(200) {capabilities: map, documentDetails: [map], documents: [map], entityAssociations: [map], id: str, individual: map{birthData: map{dateOfBirth: str}, email: str, identificationData: map{cardNumber: str, expiryDate: str, issuerCountry: str, issuerState: str, nationalIdExempt: bool, number: str, type: str}, name: map{firstName: str, infix: str, lastName: str}, nationality: str, phone: map{number: str, phoneCountryCode: str, type: str}, residentialAddress: map{city: str, country: str, postalCode: str, stateOrProvince: str, street: str, street2: str}, taxInformation: [map], webData: map{webAddress: str, webAddressId: str}}, organization: map{countryOfGoverningLaw: str, dateOfIncorporation: str, dateOfInitiationOfLegalProceeding: str, description: str, doingBusinessAs: str, economicSector: str, email: str, financialReports: [map], globalLegalEntityIdentifier: str, headOfficeIndicator: bool, institutionalSector: str, legalForm: str, legalName: str, phone: map{number: str, phoneCountryCode: str, type: str}, principalPlaceOfBusiness: map{city: str, country: str, postalCode: str, stateOrProvince: str, street: str, street2: str}, registeredAddress: map{city: str, country: str, postalCode: str, stateOrProvince: str, street: str, street2: str}, registrationNumber: str, statusOfLegalProceeding: str, stockData: map{marketIdentifier: str, stockNumber: str, tickerSymbol: str}, taxInformation: [map], taxReportingClassification: map{businessType: str, financialInstitutionNumber: str, mainSourceOfIncome: str, type: str}, type: str, vatAbsenceReason: str, vatNumber: str, webData: map{webAddress: str, webAddressId: str}}, problems: [map], reference: str, soleProprietorship: map{countryOfGoverningLaw: str, dateOfIncorporation: str, doingBusinessAs: str, financialReports: [map], name: str, principalPlaceOfBusiness: map{city: str, country: str, postalCode: str, stateOrProvince: str, street: str, street2: str}, registeredAddress: map{city: str, country: str, postalCode: str, stateOrProvince: str, street: str, street2: str}, registrationNumber: str, taxAbsent: bool?, taxInformation: [map], vatAbsenceReason: str, vatNumber: str}, transferInstruments: [map], trust: map{countryOfGoverningLaw: str, dateOfIncorporation: str, description: str, doingBusinessAs: str, name: str, principalPlaceOfBusiness: map{city: str, country: str, postalCode: str, stateOrProvince: str, street: str, street2: str}, registeredAddress: map{city: str, country: str, postalCode: str, stateOrProvince: str, street: str, street2: str}, registrationNumber: str, taxInformation: [map], type: str, undefinedBeneficiaryInfo: [map], vatAbsenceReason: str, vatNumber: str}, type: str, unincorporatedPartnership: map{countryOfGoverningLaw: str, dateOfIncorporation: str, description: str, doingBusinessAs: str, name: str, principalPlaceOfBusiness: map{city: str, country: str, postalCode: str, stateOrProvince: str, street: str, street2: str}, registeredAddress: map{city: str, country: str, postalCode: str, stateOrProvince: str, street: str, street2: str}, registrationNumber: str, taxInformation: [map], type: str, vatAbsenceReason: str, vatNumber: str}, verificationDeadlines: [map], verificationPlan: str}
@errors {400, 401, 403, 422, 500}

@endpoint GET /legalEntities/{id}
@required {id: str}
@returns(200) {capabilities: map, documentDetails: [map], documents: [map], entityAssociations: [map], id: str, individual: map{birthData: map{dateOfBirth: str}, email: str, identificationData: map{cardNumber: str, expiryDate: str, issuerCountry: str, issuerState: str, nationalIdExempt: bool, number: str, type: str}, name: map{firstName: str, infix: str, lastName: str}, nationality: str, phone: map{number: str, phoneCountryCode: str, type: str}, residentialAddress: map{city: str, country: str, postalCode: str, stateOrProvince: str, street: str, street2: str}, taxInformation: [map], webData: map{webAddress: str, webAddressId: str}}, organization: map{countryOfGoverningLaw: str, dateOfIncorporation: str, dateOfInitiationOfLegalProceeding: str, description: str, doingBusinessAs: str, economicSector: str, email: str, financialReports: [map], globalLegalEntityIdentifier: str, headOfficeIndicator: bool, institutionalSector: str, legalForm: str, legalName: str, phone: map{number: str, phoneCountryCode: str, type: str}, principalPlaceOfBusiness: map{city: str, country: str, postalCode: str, stateOrProvince: str, street: str, street2: str}, registeredAddress: map{city: str, country: str, postalCode: str, stateOrProvince: str, street: str, street2: str}, registrationNumber: str, statusOfLegalProceeding: str, stockData: map{marketIdentifier: str, stockNumber: str, tickerSymbol: str}, taxInformation: [map], taxReportingClassification: map{businessType: str, financialInstitutionNumber: str, mainSourceOfIncome: str, type: str}, type: str, vatAbsenceReason: str, vatNumber: str, webData: map{webAddress: str, webAddressId: str}}, problems: [map], reference: str, soleProprietorship: map{countryOfGoverningLaw: str, dateOfIncorporation: str, doingBusinessAs: str, financialReports: [map], name: str, principalPlaceOfBusiness: map{city: str, country: str, postalCode: str, stateOrProvince: str, street: str, street2: str}, registeredAddress: map{city: str, country: str, postalCode: str, stateOrProvince: str, street: str, street2: str}, registrationNumber: str, taxAbsent: bool?, taxInformation: [map], vatAbsenceReason: str, vatNumber: str}, transferInstruments: [map], trust: map{countryOfGoverningLaw: str, dateOfIncorporation: str, description: str, doingBusinessAs: str, name: str, principalPlaceOfBusiness: map{city: str, country: str, postalCode: str, stateOrProvince: str, street: str, street2: str}, registeredAddress: map{city: str, country: str, postalCode: str, stateOrProvince: str, street: str, street2: str}, registrationNumber: str, taxInformation: [map], type: str, undefinedBeneficiaryInfo: [map], vatAbsenceReason: str, vatNumber: str}, type: str, unincorporatedPartnership: map{countryOfGoverningLaw: str, dateOfIncorporation: str, description: str, doingBusinessAs: str, name: str, principalPlaceOfBusiness: map{city: str, country: str, postalCode: str, stateOrProvince: str, street: str, street2: str}, registeredAddress: map{city: str, country: str, postalCode: str, stateOrProvince: str, street: str, street2: str}, registrationNumber: str, taxInformation: [map], type: str, vatAbsenceReason: str, vatNumber: str}, verificationDeadlines: [map], verificationPlan: str}
@errors {400, 401, 403, 422, 500}

@endpoint PATCH /legalEntities/{id}
@required {id: str}
@optional {x-requested-verification-code: str, capabilities: map, entityAssociations: [map{associatorId: str, entityType: str, jobTitle: str, legalEntityId!: str, name: str, nominee: bool, relationship: str, settlorExemptionReason: [str], type!: str}], individual: map{birthData: map, email: str, identificationData: map, name!: map, nationality: str, phone: map, residentialAddress!: map, taxInformation: [map], webData: map}, organization: map{countryOfGoverningLaw: str, dateOfIncorporation: str, dateOfInitiationOfLegalProceeding: str, description: str, doingBusinessAs: str, economicSector: str, email: str, financialReports: [map], globalLegalEntityIdentifier: str, headOfficeIndicator: bool, institutionalSector: str, legalForm: str, legalName!: str, phone: map, principalPlaceOfBusiness: map, registeredAddress!: map, registrationNumber: str, statusOfLegalProceeding: str, stockData: map, taxInformation: [map], taxReportingClassification: map, type: str, vatAbsenceReason: str, vatNumber: str, webData: map}, reference: str, soleProprietorship: map{countryOfGoverningLaw!: str, dateOfIncorporation: str, doingBusinessAs: str, financialReports: [map], name!: str, principalPlaceOfBusiness: map, registeredAddress!: map, registrationNumber: str, taxAbsent: bool, taxInformation: [map], vatAbsenceReason: str, vatNumber: str}, trust: map{countryOfGoverningLaw!: str, dateOfIncorporation: str, description: str, doingBusinessAs: str, name!: str, principalPlaceOfBusiness: map, registeredAddress!: map, registrationNumber: str, taxInformation: [map], type!: str, undefinedBeneficiaryInfo: [map], vatAbsenceReason: str, vatNumber: str}, type: str(individual/organization/soleProprietorship/trust/unincorporatedPartnership), unincorporatedPartnership: map{countryOfGoverningLaw!: str, dateOfIncorporation: str, description: str, doingBusinessAs: str, name!: str, principalPlaceOfBusiness: map, registeredAddress!: map, registrationNumber: str, taxInformation: [map], type: str, vatAbsenceReason: str, vatNumber: str}, verificationPlan: str}
@returns(200) {capabilities: map, documentDetails: [map], documents: [map], entityAssociations: [map], id: str, individual: map{birthData: map{dateOfBirth: str}, email: str, identificationData: map{cardNumber: str, expiryDate: str, issuerCountry: str, issuerState: str, nationalIdExempt: bool, number: str, type: str}, name: map{firstName: str, infix: str, lastName: str}, nationality: str, phone: map{number: str, phoneCountryCode: str, type: str}, residentialAddress: map{city: str, country: str, postalCode: str, stateOrProvince: str, street: str, street2: str}, taxInformation: [map], webData: map{webAddress: str, webAddressId: str}}, organization: map{countryOfGoverningLaw: str, dateOfIncorporation: str, dateOfInitiationOfLegalProceeding: str, description: str, doingBusinessAs: str, economicSector: str, email: str, financialReports: [map], globalLegalEntityIdentifier: str, headOfficeIndicator: bool, institutionalSector: str, legalForm: str, legalName: str, phone: map{number: str, phoneCountryCode: str, type: str}, principalPlaceOfBusiness: map{city: str, country: str, postalCode: str, stateOrProvince: str, street: str, street2: str}, registeredAddress: map{city: str, country: str, postalCode: str, stateOrProvince: str, street: str, street2: str}, registrationNumber: str, statusOfLegalProceeding: str, stockData: map{marketIdentifier: str, stockNumber: str, tickerSymbol: str}, taxInformation: [map], taxReportingClassification: map{businessType: str, financialInstitutionNumber: str, mainSourceOfIncome: str, type: str}, type: str, vatAbsenceReason: str, vatNumber: str, webData: map{webAddress: str, webAddressId: str}}, problems: [map], reference: str, soleProprietorship: map{countryOfGoverningLaw: str, dateOfIncorporation: str, doingBusinessAs: str, financialReports: [map], name: str, principalPlaceOfBusiness: map{city: str, country: str, postalCode: str, stateOrProvince: str, street: str, street2: str}, registeredAddress: map{city: str, country: str, postalCode: str, stateOrProvince: str, street: str, street2: str}, registrationNumber: str, taxAbsent: bool?, taxInformation: [map], vatAbsenceReason: str, vatNumber: str}, transferInstruments: [map], trust: map{countryOfGoverningLaw: str, dateOfIncorporation: str, description: str, doingBusinessAs: str, name: str, principalPlaceOfBusiness: map{city: str, country: str, postalCode: str, stateOrProvince: str, street: str, street2: str}, registeredAddress: map{city: str, country: str, postalCode: str, stateOrProvince: str, street: str, street2: str}, registrationNumber: str, taxInformation: [map], type: str, undefinedBeneficiaryInfo: [map], vatAbsenceReason: str, vatNumber: str}, type: str, unincorporatedPartnership: map{countryOfGoverningLaw: str, dateOfIncorporation: str, description: str, doingBusinessAs: str, name: str, principalPlaceOfBusiness: map{city: str, country: str, postalCode: str, stateOrProvince: str, street: str, street2: str}, registeredAddress: map{city: str, country: str, postalCode: str, stateOrProvince: str, street: str, street2: str}, registrationNumber: str, taxInformation: [map], type: str, vatAbsenceReason: str, vatNumber: str}, verificationDeadlines: [map], verificationPlan: str}
@errors {400, 401, 403, 422, 500}

@endpoint GET /legalEntities/{id}/acceptedTermsOfServiceDocument/{termsofserviceacceptancereference}
@required {id: str, termsofserviceacceptancereference: str}
@optional {termsOfServiceDocumentFormat: str}
@returns(200) {document: str(byte), id: str, termsOfServiceAcceptanceReference: str, termsOfServiceDocumentFormat: str}
@errors {400, 401, 403, 422, 500}

@endpoint GET /legalEntities/{id}/businessLines
@required {id: str}
@returns(200) {businessLines: [map]}
@errors {400, 401, 403, 422, 500}

@endpoint POST /legalEntities/{id}/checkTaxElectronicDeliveryConsent
@required {id: str}
@returns(200) {US1099k: bool}
@errors {400, 401, 403, 422, 500}

@endpoint POST /legalEntities/{id}/checkVerificationErrors
@required {id: str}
@returns(200) {problems: [map]}
@errors {400, 401, 403, 422, 500}

@endpoint POST /legalEntities/{id}/confirmDataReview
@required {id: str}
@returns(200) {dataReviewedAt: str}
@errors {400, 401, 403, 422, 500}

@endpoint POST /legalEntities/{id}/onboardingLinks
@required {id: str}
@optional {locale: str, redirectUrl: str, settings: map{acceptedCountries: [str], allowBankAccountFormatSelection: bool, allowDebugUi: bool, allowIntraRegionCrossBorderPayout: bool, changeLegalEntityType: bool, editPrefilledCountry: bool, enforceLegalAge: bool, hideOnboardingIntroductionIndividual: bool, hideOnboardingIntroductionOrganization: bool, hideOnboardingIntroductionSoleProprietor: bool, hideOnboardingIntroductionTrust: bool, instantBankVerification: bool, requirePciSignEcomMoto: bool, requirePciSignEcommerce: bool, requirePciSignPos: bool, requirePciSignPosMoto: bool, transferInstrumentLimit: int(int32)}, themeId: str}
@returns(200) {url: str}
@errors {400, 401, 403, 422, 500}

@endpoint GET /legalEntities/{id}/pciQuestionnaires
@required {id: str}
@returns(200) {data: [map]}
@errors {400, 401, 403, 422, 500}

@endpoint POST /legalEntities/{id}/pciQuestionnaires/generatePciTemplates
@required {id: str}
@optional {additionalSalesChannels: [str], language: str}
@returns(200) {content: str(byte), language: str, pciTemplateReferences: [str]}
@errors {400, 401, 403, 422, 500}

@endpoint POST /legalEntities/{id}/pciQuestionnaires/signPciTemplates
@required {id: str, pciTemplateReferences: [str], signedBy: str}
@returns(200) {pciQuestionnaireIds: [str], signedBy: str}
@errors {400, 401, 403, 422, 500}

@endpoint POST /legalEntities/{id}/pciQuestionnaires/signingRequired
@required {id: str}
@optional {additionalSalesChannels: [str]}
@returns(200) {signingRequired: bool}
@errors {400, 401, 403, 422, 500}

@endpoint GET /legalEntities/{id}/pciQuestionnaires/{pciid}
@required {id: str, pciid: str}
@returns(200) {content: str(byte), createdAt: str(date-time), id: str, validUntil: str(date-time)}
@errors {400, 401, 403, 422, 500}

@endpoint POST /legalEntities/{id}/setTaxElectronicDeliveryConsent
@required {id: str}
@optional {US1099k: bool}
@returns(200)
@errors {400, 401, 403, 422, 500}

@endpoint POST /legalEntities/{id}/termsOfService
@required {id: str, language: str, type: str(adyenAccount/adyenCapital/adyenCard/adyenChargeCard/adyenForPlatformsAdvanced/adyenForPlatformsManage/adyenFranchisee/adyenIssuing/adyenPccr/kycOnInvite)}
@optional {termsOfServiceDocumentFormat: str}
@returns(200) {document: str(byte), id: str, language: str, termsOfServiceDocumentFormat: str, termsOfServiceDocumentId: str, type: str}
@errors {400, 401, 403, 422, 500}

@endpoint PATCH /legalEntities/{id}/termsOfService/{termsofservicedocumentid}
@required {id: str, termsofservicedocumentid: str, acceptedBy: str}
@optional {ipAddress: str}
@returns(200) {acceptedBy: str, id: str, ipAddress: str, language: str, termsOfServiceDocumentId: str, type: str}
@errors {400, 401, 403, 422, 500}

@endpoint GET /legalEntities/{id}/termsOfServiceAcceptanceInfos
@required {id: str}
@returns(200) {data: [map]}
@errors {400, 401, 403, 422, 500}

@endpoint GET /legalEntities/{id}/termsOfServiceStatus
@required {id: str}
@returns(200) {termsOfServiceTypes: [str]}
@errors {400, 401, 403, 422, 500}

@endgroup

@group themes
@endpoint GET /themes
@returns(200) {next: str, previous: str, themes: [map]}
@errors {400, 401, 403, 422, 500}

@endpoint GET /themes/{id}
@required {id: str}
@returns(200) {createdAt: str(date-time), description: str, id: str, properties: map, updatedAt: str(date-time)}
@errors {400, 401, 403, 422, 500}

@endgroup

@group transferInstruments
@endpoint POST /transferInstruments
@required {bankAccount: map{accountIdentification: any, accountType: str, bankName: str, countryCode: str, trustedSource: bool}, legalEntityId: str, type: str(bankAccount/recurringDetail)}
@optional {x-requested-verification-code: str}
@returns(200) {bankAccount: map{accountIdentification: any, accountType: str, bankName: str, countryCode: str, trustedSource: bool}, capabilities: map, documentDetails: [map], id: str, legalEntityId: str, problems: [map], type: str}
@errors {400, 401, 403, 422, 500}

@endpoint GET /transferInstruments/{id}
@required {id: str}
@returns(200) {bankAccount: map{accountIdentification: any, accountType: str, bankName: str, countryCode: str, trustedSource: bool}, capabilities: map, documentDetails: [map], id: str, legalEntityId: str, problems: [map], type: str}
@errors {400, 401, 403, 422, 500}

@endpoint DELETE /transferInstruments/{id}
@required {id: str}
@returns(204)
@errors {400, 401, 403, 422, 500}

@endpoint PATCH /transferInstruments/{id}
@required {id: str, bankAccount: map{accountIdentification: any, accountType: str, bankName: str, countryCode: str, trustedSource: bool}, legalEntityId: str, type: str(bankAccount/recurringDetail)}
@optional {x-requested-verification-code: str}
@returns(200) {bankAccount: map{accountIdentification: any, accountType: str, bankName: str, countryCode: str, trustedSource: bool}, capabilities: map, documentDetails: [map], id: str, legalEntityId: str, problems: [map], type: str}
@errors {400, 401, 403, 422, 500}

@endgroup

@group legalEntities
@endpoint POST /legalEntities/{id}/requestPeriodicReview
@required {id: str}
@returns(204)

@endgroup

@end