{"files":{"SKILL.md":"---\nname: legal-entity-management-api\ndescription: \"Legal Entity Management API skill. Use when working with Legal Entity Management for businessLines, documents, legalEntities. Covers 34 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# Legal Entity Management API\nAPI version: 3\n\n## Auth\nApiKey X-API-Key in header | Bearer basic\n\n## Base URL\nhttps://kyc-test.adyen.com/lem/v3\n\n## Setup\n1. Set Authorization header with Bearer token\n2. GET /themes -- get a list of hosted onboarding page themes\n3. POST /businessLines -- create first businessLine\n\n## Endpoints\n34 endpoints across 5 groups. See references/api-spec.lap for full details.\n\n### BusinessLines\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /businessLines | Create a business line |\n| GET | /businessLines/{id} | Get a business line |\n| DELETE | /businessLines/{id} | Delete a business line |\n| PATCH | /businessLines/{id} | Update a business line |\n\n### Documents\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /documents | Upload a document for verification checks |\n| GET | /documents/{id} | Get a document |\n| DELETE | /documents/{id} | Delete a document |\n| PATCH | /documents/{id} | Update a document |\n\n### LegalEntities\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /legalEntities | Create a legal entity |\n| GET | /legalEntities/{id} | Get a legal entity |\n| PATCH | /legalEntities/{id} | Update a legal entity |\n| GET | /legalEntities/{id}/acceptedTermsOfServiceDocument/{termsofserviceacceptancereference} | Get accepted Terms of Service document |\n| GET | /legalEntities/{id}/businessLines | Get all business lines under a legal entity |\n| POST | /legalEntities/{id}/checkTaxElectronicDeliveryConsent | Check the status of consent for electronic delivery of tax forms |\n| POST | /legalEntities/{id}/checkVerificationErrors | Check a legal entity's verification errors |\n| POST | /legalEntities/{id}/confirmDataReview | Confirm data review |\n| POST | /legalEntities/{id}/onboardingLinks | Get a link to an Adyen-hosted onboarding page |\n| GET | /legalEntities/{id}/pciQuestionnaires | Get PCI questionnaire details |\n| POST | /legalEntities/{id}/pciQuestionnaires/generatePciTemplates | Generate PCI questionnaire |\n| POST | /legalEntities/{id}/pciQuestionnaires/signPciTemplates | Sign PCI questionnaire |\n| POST | /legalEntities/{id}/pciQuestionnaires/signingRequired | Calculate PCI status of a legal entity |\n| GET | /legalEntities/{id}/pciQuestionnaires/{pciid} | Get PCI questionnaire |\n| POST | /legalEntities/{id}/setTaxElectronicDeliveryConsent | Set the consent status for electronic delivery of tax forms |\n| POST | /legalEntities/{id}/termsOfService | Get Terms of Service document |\n| PATCH | /legalEntities/{id}/termsOfService/{termsofservicedocumentid} | Accept Terms of Service |\n| GET | /legalEntities/{id}/termsOfServiceAcceptanceInfos | Get Terms of Service information for a legal entity |\n| GET | /legalEntities/{id}/termsOfServiceStatus | Get Terms of Service status |\n| POST | /legalEntities/{id}/requestPeriodicReview | Request periodic data review. |\n\n### Themes\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /themes | Get a list of hosted onboarding page themes |\n| GET | /themes/{id} | Get an onboarding link theme |\n\n### TransferInstruments\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /transferInstruments | Create a transfer instrument |\n| GET | /transferInstruments/{id} | Get a transfer instrument |\n| DELETE | /transferInstruments/{id} | Delete a transfer instrument |\n| PATCH | /transferInstruments/{id} | Update a transfer instrument |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"Create a businessLine?\" -> POST /businessLines\n- \"Get businessLine details?\" -> GET /businessLines/{id}\n- \"Delete a businessLine?\" -> DELETE /businessLines/{id}\n- \"Partially update a businessLine?\" -> PATCH /businessLines/{id}\n- \"Create a document?\" -> POST /documents\n- \"Get document details?\" -> GET /documents/{id}\n- \"Delete a document?\" -> DELETE /documents/{id}\n- \"Partially update a document?\" -> PATCH /documents/{id}\n- \"Create a legalEntity?\" -> POST /legalEntities\n- \"Get legalEntity details?\" -> GET /legalEntities/{id}\n- \"Partially update a legalEntity?\" -> PATCH /legalEntities/{id}\n- \"Get acceptedTermsOfServiceDocument details?\" -> GET /legalEntities/{id}/acceptedTermsOfServiceDocument/{termsofserviceacceptancereference}\n- \"List all businessLines?\" -> GET /legalEntities/{id}/businessLines\n- \"Create a checkTaxElectronicDeliveryConsent?\" -> POST /legalEntities/{id}/checkTaxElectronicDeliveryConsent\n- \"Create a checkVerificationError?\" -> POST /legalEntities/{id}/checkVerificationErrors\n- \"Create a confirmDataReview?\" -> POST /legalEntities/{id}/confirmDataReview\n- \"Create a onboardingLink?\" -> POST /legalEntities/{id}/onboardingLinks\n- \"List all pciQuestionnaires?\" -> GET /legalEntities/{id}/pciQuestionnaires\n- \"Create a generatePciTemplate?\" -> POST /legalEntities/{id}/pciQuestionnaires/generatePciTemplates\n- \"Create a signPciTemplate?\" -> POST /legalEntities/{id}/pciQuestionnaires/signPciTemplates\n- \"Create a signingRequired?\" -> POST /legalEntities/{id}/pciQuestionnaires/signingRequired\n- \"Get pciQuestionnaire details?\" -> GET /legalEntities/{id}/pciQuestionnaires/{pciid}\n- \"Create a setTaxElectronicDeliveryConsent?\" -> POST /legalEntities/{id}/setTaxElectronicDeliveryConsent\n- \"Create a termsOfService?\" -> POST /legalEntities/{id}/termsOfService\n- \"Partially update a termsOfService?\" -> PATCH /legalEntities/{id}/termsOfService/{termsofservicedocumentid}\n- \"List all termsOfServiceAcceptanceInfos?\" -> GET /legalEntities/{id}/termsOfServiceAcceptanceInfos\n- \"List all termsOfServiceStatus?\" -> GET /legalEntities/{id}/termsOfServiceStatus\n- \"List all themes?\" -> GET /themes\n- \"Get theme details?\" -> GET /themes/{id}\n- \"Create a transferInstrument?\" -> POST /transferInstruments\n- \"Get transferInstrument details?\" -> GET /transferInstruments/{id}\n- \"Delete a transferInstrument?\" -> DELETE /transferInstruments/{id}\n- \"Partially update a transferInstrument?\" -> PATCH /transferInstruments/{id}\n- \"Create a requestPeriodicReview?\" -> POST /legalEntities/{id}/requestPeriodicReview\n- \"How to authenticate?\" -> See Auth section above\n\n## Response Tips\n- Check response schemas in references/api-spec.lap for field details\n- Create/update endpoints return the modified resource on success\n- Error responses include status codes and descriptions in the spec\n\n## References\n- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas\n\n> Generated from the official API spec by [LAP](https://lap.sh)\n","references/api-spec.lap":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api Legal Entity Management API\n@base https://kyc-test.adyen.com/lem/v3\n@version 3\n@auth ApiKey X-API-Key in header | Bearer basic\n@endpoints 34\n@hint download_for_search\n@toc businessLines(4), documents(4), legalEntities(20), themes(2), transferInstruments(4)\n\n@group businessLines\n@endpoint POST /businessLines\n@desc Create a business line\n@required {industryCode: str # A code that represents the industry of the legal entity for [marketplaces](https://docs.adyen.com/marketplaces/verification-requirements/reference-additional-products/#list-industry-codes) or [platforms](https://docs.adyen.com/platforms/verification-requirements/reference-additional-products/#list-industry-codes). For example, **4431A** for computer software stores., legalEntityId: str # Unique identifier of the [legal entity](https://docs.adyen.com/api-explorer/#/legalentity/latest/post/legalEntities__resParam_id) that owns the business line., service: str(paymentProcessing/banking) # The service for which you are creating the business line.    Possible values: *  **paymentProcessing** *  **banking**}\n@optional {capability: str(receivePayments/receiveFromPlatformPayments/issueBankAccount) # The capability for which you are creating the business line.  Possible values: **receivePayments**, **receiveFromPlatformPayments**, **issueBankAccount**, salesChannels: [str] # A list of channels where goods or services are sold.  Possible values: **pos**, **posMoto**, **eCommerce**, **ecomMoto**, **payByLink**.  Required only in combination with the `service` **paymentProcessing**., sourceOfFunds: map{acquiringBusinessLineId: str, adyenProcessedFunds: bool, description: str, type: str}, webData: [map{webAddress: str, webAddressId: str}] # List of website URLs where your user's goods or services are sold. When this is required for a service but your user does not have an online presence, provide the reason in the `webDataExemption` object., webDataExemption: map{reason: str}}\n@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}} # OK - the request has succeeded.\n@errors {400: Bad Request - a problem reading or understanding the request., 401: Unauthorized - authentication required., 403: Forbidden - insufficient permissions to process the request., 422: Unprocessable Entity - a request validation error., 500: Internal Server Error - the server could not process the request.}\n@example_request {\"service\":\"banking\",\"industryCode\":\"4531\",\"webData\":[{\"webAddress\":\"https://www.adyen.com\"}],\"legalEntityId\":\"LE00000000000000000000001\",\"sourceOfFunds\":{\"type\":\"business\",\"adyenProcessedFunds\":false,\"description\":\"Funds from my flower shop business\"}}\n\n@endpoint GET /businessLines/{id}\n@desc Get a business line\n@required {id: str # The unique identifier of the business line.}\n@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}} # OK - the request has succeeded.\n@errors {400: Bad Request - a problem reading or understanding the request., 401: Unauthorized - authentication required., 403: Forbidden - insufficient permissions to process the request., 422: Unprocessable Entity - a request validation error., 500: Internal Server Error - the server could not process the request.}\n\n@endpoint DELETE /businessLines/{id}\n@desc Delete a business line\n@required {id: str # The unique identifier of the business line to be deleted.}\n@returns(204) No Content - look at the actual response code for the status of the request.\n@errors {400: Bad Request - a problem reading or understanding the request., 401: Unauthorized - authentication required., 403: Forbidden - insufficient permissions to process the request., 422: Unprocessable Entity - a request validation error., 500: Internal Server Error - the server could not process the request.}\n\n@endpoint PATCH /businessLines/{id}\n@desc Update a business line\n@required {id: str # The unique identifier of the business line.}\n@optional {industryCode: str # A code that represents the industry of your legal entity. For example, **4431A** for computer software stores., salesChannels: [str] # A list of channels where goods or services are sold.  Possible values: **pos**, **posMoto**, **eCommerce**, **ecomMoto**, **payByLink**.  Required only in combination with the `service` **paymentProcessing**., sourceOfFunds: map{acquiringBusinessLineId: str, adyenProcessedFunds: bool, description: str, type: str}, webData: [map{webAddress: str, webAddressId: str}] # List of website URLs where your user's goods or services are sold. When this is required for a service but your user does not have an online presence, provide the reason in the `webDataExemption` object., webDataExemption: map{reason: str}}\n@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}} # OK - the request has succeeded.\n@errors {400: Bad Request - a problem reading or understanding the request., 401: Unauthorized - authentication required., 403: Forbidden - insufficient permissions to process the request., 422: Unprocessable Entity - a request validation error., 500: Internal Server Error - the server could not process the request.}\n@example_request {\"industryCode\":\"55\",\"webData\":[{\"webAddress\":\"https://www.example.com\"}]}\n\n@endgroup\n\n@group documents\n@endpoint POST /documents\n@desc Upload a document for verification checks\n@required {description: str # Your description for the document., type: str(bankStatement/driversLicense/identityCard/nationalIdNumber/passport/proofOfAddress/proofOfNationalIdNumber/proofOfResidency/registrationDocument/vatDocument/proofOfOrganizationTaxInfo/proofOfIndividualTaxId/proofOfOwnership/proofOfSignatory/liveSelfie/proofOfIndustry/constitutionalDocument/proofOfFundingOrWealthSource/proofOfRelationship) # Type of document, used when providing an ID number or uploading a document. The possible values depend on the legal entity type.  * For **organization**, the `type` values can be **proofOfAddress**, **registrationDocument**, **vatDocument**, **proofOfOrganizationTaxInfo**, **proofOfOwnership**, **proofOfIndustry**, **proofOfSignatory**, or **proofOfFundingOrWealthSource**.  * For **individual**, the `type` values can be **identityCard**, **driversLicense**, **passport**, **liveSelfie**, **proofOfNationalIdNumber**, **proofOfResidency**, **proofOfIndustry**, **proofOfIndividualTaxId**, **proofOfFundingOrWealthSource** or **proofOfRelationship**.  * For **soleProprietorship**, the `type` values can be **constitutionalDocument**, **proofOfAddress**, or **proofOfIndustry**.  * For **trust**, the `type` value is **constitutionalDocument**.  * For **unincorporatedPartnership**, the `type` value is **constitutionalDocument**.  * Use **bankStatement** to upload documents for a [transfer instrument](https://docs.adyen.com/api-explorer/#/legalentity/latest/post/transferInstruments__resParam_id).}\n@optional {x-requested-verification-code: str # Use a suberror code as your requested verification code. You can include one code at a time in your request header. Requested verification codes can only be used in your test environment., 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}] # Array that contains the document. The array supports multiple attachments for uploading different sides or pages of a document., creationDate: str(date-time) # The creation date of the document., expiryDate: str # The expiry date of the document, in YYYY-MM-DD format., fileName: str # The filename of the document., id: str # The unique identifier of the document., issuerCountry: str # The two-character [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code where the document was issued. For example, **US**., issuerState: str # The state or province where the document was issued (AU only)., modificationDate: str(date-time) # The modification date of the document., number: str # The number in the document., owner: map{id!: str, type!: str}}\n@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} # OK - the request has succeeded.\n@errors {400: Bad Request - a problem reading or understanding the request., 401: Unauthorized - authentication required., 403: Forbidden - insufficient permissions to process the request., 422: Unprocessable Entity - a request validation error., 500: Internal Server Error - the server could not process the request.}\n@example_request {\"type\":\"registrationDocument\",\"attachments\":[{\"content\":\"JVBERi0xLjQKJcOkw7zDtsOfCjIgMCBv+f/ub0j6JPRX+E3EmC==\"}],\"description\":\"Registration doc for Example Company\",\"owner\":{\"id\":\"LE00000000000000000000001\",\"type\":\"legalEntity\"}}\n\n@endpoint GET /documents/{id}\n@desc Get a document\n@required {id: str # The unique identifier of the document.}\n@optional {skipContent: bool # Do not load document content while fetching the document.}\n@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} # OK - the request has succeeded.\n@errors {400: Bad Request - a problem reading or understanding the request., 401: Unauthorized - authentication required., 403: Forbidden - insufficient permissions to process the request., 422: Unprocessable Entity - a request validation error., 500: Internal Server Error - the server could not process the request.}\n\n@endpoint DELETE /documents/{id}\n@desc Delete a document\n@required {id: str # The unique identifier of the document to be deleted.}\n@returns(204) No Content - look at the actual response code for the status of the request.\n@errors {400: Bad Request - a problem reading or understanding the request., 401: Unauthorized - authentication required., 403: Forbidden - insufficient permissions to process the request., 422: Unprocessable Entity - a request validation error., 500: Internal Server Error - the server could not process the request.}\n\n@endpoint PATCH /documents/{id}\n@desc Update a document\n@required {id: str # The unique identifier of the document to be updated., description: str # Your description for the document., type: str(bankStatement/driversLicense/identityCard/nationalIdNumber/passport/proofOfAddress/proofOfNationalIdNumber/proofOfResidency/registrationDocument/vatDocument/proofOfOrganizationTaxInfo/proofOfIndividualTaxId/proofOfOwnership/proofOfSignatory/liveSelfie/proofOfIndustry/constitutionalDocument/proofOfFundingOrWealthSource/proofOfRelationship) # Type of document, used when providing an ID number or uploading a document. The possible values depend on the legal entity type.  * For **organization**, the `type` values can be **proofOfAddress**, **registrationDocument**, **vatDocument**, **proofOfOrganizationTaxInfo**, **proofOfOwnership**, **proofOfIndustry**, **proofOfSignatory**, or **proofOfFundingOrWealthSource**.  * For **individual**, the `type` values can be **identityCard**, **driversLicense**, **passport**, **liveSelfie**, **proofOfNationalIdNumber**, **proofOfResidency**, **proofOfIndustry**, **proofOfIndividualTaxId**, **proofOfFundingOrWealthSource** or **proofOfRelationship**.  * For **soleProprietorship**, the `type` values can be **constitutionalDocument**, **proofOfAddress**, or **proofOfIndustry**.  * For **trust**, the `type` value is **constitutionalDocument**.  * For **unincorporatedPartnership**, the `type` value is **constitutionalDocument**.  * Use **bankStatement** to upload documents for a [transfer instrument](https://docs.adyen.com/api-explorer/#/legalentity/latest/post/transferInstruments__resParam_id).}\n@optional {x-requested-verification-code: str # Use the requested verification code 0_0001 to resolve any suberrors associated with the document. Requested verification codes can only be used in your test environment., 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}] # Array that contains the document. The array supports multiple attachments for uploading different sides or pages of a document., creationDate: str(date-time) # The creation date of the document., expiryDate: str # The expiry date of the document, in YYYY-MM-DD format., fileName: str # The filename of the document., id: str # The unique identifier of the document., issuerCountry: str # The two-character [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code where the document was issued. For example, **US**., issuerState: str # The state or province where the document was issued (AU only)., modificationDate: str(date-time) # The modification date of the document., number: str # The number in the document., owner: map{id!: str, type!: str}}\n@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} # OK - the request has succeeded.\n@errors {400: Bad Request - a problem reading or understanding the request., 401: Unauthorized - authentication required., 403: Forbidden - insufficient permissions to process the request., 422: Unprocessable Entity - a request validation error., 500: Internal Server Error - the server could not process the request.}\n@example_request {\"type\":\"proofOfIndustry\",\"description\":\"Proof of industry doc for Example Company\"}\n\n@endgroup\n\n@group legalEntities\n@endpoint POST /legalEntities\n@desc Create a legal entity\n@required {type: str(individual/organization/soleProprietorship/trust/unincorporatedPartnership) # The type of legal entity.   Possible values: **individual**, **organization**, **soleProprietorship**, or **trust**.}\n@optional {x-requested-verification-code: str # Use a suberror code as your requested verification code. You can include one code at a time in your request header. Requested verification codes can only be used in your test environment., capabilities: map # Contains key-value pairs that specify the actions that the legal entity can do in your platform.The key is a capability required for your integration. For example, **issueCard** for Issuing. The value is an object containing the settings for the capability., entityAssociations: [map{associatorId: str, entityType: str, jobTitle: str, legalEntityId!: str, name: str, nominee: bool, relationship: str, settlorExemptionReason: [str], type!: str}] # List of legal entities associated with the current legal entity. For example, ultimate beneficial owners associated with an organization through ownership or control, or as signatories., 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 # Your reference for the legal entity, maximum 150 characters., 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 # A key-value pair that specifies the verification process for a legal entity. Set to **upfront** for upfront verification for [marketplaces](https://docs.adyen.com/marketplaces/verification-overview/verification-types/#upfront-verification).}\n@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} # OK - the request has succeeded.\n@errors {400: Bad Request - a problem reading or understanding the request., 401: Unauthorized - authentication required., 403: Forbidden - insufficient permissions to process the request., 422: Unprocessable Entity - a request validation error., 500: Internal Server Error - the server could not process the request.}\n@example_request {\"type\":\"individual\",\"individual\":{\"residentialAddress\":{\"city\":\"Sydney\",\"country\":\"AU\",\"postalCode\":\"1122\",\"stateOrProvince\":\"NSW\",\"street\":\"Winfield Avenue\",\"street2\":\"12\"},\"name\":{\"firstName\":\"Shelly\",\"lastName\":\"Eller\"},\"identificationData\":{\"issuerState\":\"NSW\",\"number\":\"1234567891\",\"type\":\"driversLicense\",\"cardNumber\":\"112327\"},\"birthData\":{\"dateOfBirth\":\"1991-01-01\"},\"email\":\"s.hopper@example.com\"}}\n\n@endpoint GET /legalEntities/{id}\n@desc Get a legal entity\n@required {id: str # The unique identifier of the legal entity.}\n@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} # OK - the request has succeeded.\n@errors {400: Bad Request - a problem reading or understanding the request., 401: Unauthorized - authentication required., 403: Forbidden - insufficient permissions to process the request., 422: Unprocessable Entity - a request validation error., 500: Internal Server Error - the server could not process the request.}\n\n@endpoint PATCH /legalEntities/{id}\n@desc Update a legal entity\n@required {id: str # The unique identifier of the legal entity.}\n@optional {x-requested-verification-code: str # Use the requested verification code 0_0001 to resolve any suberrors associated with the legal entity. Requested verification codes can only be used in your test environment., capabilities: map # Contains key-value pairs that specify the actions that the legal entity can do in your platform.The key is a capability required for your integration. For example, **issueCard** for Issuing. The value is an object containing the settings for the capability., entityAssociations: [map{associatorId: str, entityType: str, jobTitle: str, legalEntityId!: str, name: str, nominee: bool, relationship: str, settlorExemptionReason: [str], type!: str}] # List of legal entities associated with the current legal entity. For example, ultimate beneficial owners associated with an organization through ownership or control, or as signatories., 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 # Your reference for the legal entity, maximum 150 characters., 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) # The type of legal entity.  Possible values: **individual**, **organization**, **soleProprietorship**, or **trust**., 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 # A key-value pair that specifies the verification process for a legal entity. Set to **upfront** for upfront verification for [marketplaces](https://docs.adyen.com/marketplaces/verification-overview/verification-types/#upfront-verification).}\n@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} # OK - the request has succeeded.\n@errors {400: Bad Request - a problem reading or understanding the request., 401: Unauthorized - authentication required., 403: Forbidden - insufficient permissions to process the request., 422: Unprocessable Entity - a request validation error., 500: Internal Server Error - the server could not process the request.}\n@example_request {\"type\":\"individual\"}\n\n@endpoint GET /legalEntities/{id}/acceptedTermsOfServiceDocument/{termsofserviceacceptancereference}\n@desc Get accepted Terms of Service document\n@required {id: str # The unique identifier of the legal entity. For sole proprietorship, this is the individual legal entity ID of the owner. For organizations, this is the ID of the organization., termsofserviceacceptancereference: str # An Adyen-generated reference for the accepted Terms of Service.}\n@optional {termsOfServiceDocumentFormat: str # The format of the Terms of Service document. Possible values: **JSON**, **PDF**, or **TXT**}\n@returns(200) {document: str(byte), id: str, termsOfServiceAcceptanceReference: str, termsOfServiceDocumentFormat: str} # OK - the request has succeeded.\n@errors {400: Bad Request - a problem reading or understanding the request., 401: Unauthorized - authentication required., 403: Forbidden - insufficient permissions to process the request., 422: Unprocessable Entity - a request validation error., 500: Internal Server Error - the server could not process the request.}\n\n@endpoint GET /legalEntities/{id}/businessLines\n@desc Get all business lines under a legal entity\n@required {id: str # The unique identifier of the legal entity.}\n@returns(200) {businessLines: [map]} # OK - the request has succeeded.\n@errors {400: Bad Request - a problem reading or understanding the request., 401: Unauthorized - authentication required., 403: Forbidden - insufficient permissions to process the request., 422: Unprocessable Entity - a request validation error., 500: Internal Server Error - the server could not process the request.}\n\n@endpoint POST /legalEntities/{id}/checkTaxElectronicDeliveryConsent\n@desc Check the status of consent for electronic delivery of tax forms\n@required {id: str # The unique identifier of the legal entity. For sole proprietorships, this is the individual legal entity ID of the owner. For organizations, this is the ID of the organization.}\n@returns(200) {US1099k: bool} # OK - the request has succeeded.\n@errors {400: Bad Request - a problem reading or understanding the request., 401: Unauthorized - authentication required., 403: Forbidden - insufficient permissions to process the request., 422: Unprocessable Entity - a request validation error., 500: Internal Server Error - the server could not process the request.}\n\n@endpoint POST /legalEntities/{id}/checkVerificationErrors\n@desc Check a legal entity's verification errors\n@required {id: str # The unique identifier of the legal entity.}\n@returns(200) {problems: [map]} # OK - the request has succeeded.\n@errors {400: Bad Request - a problem reading or understanding the request., 401: Unauthorized - authentication required., 403: Forbidden - insufficient permissions to process the request., 422: Unprocessable Entity - a request validation error., 500: Internal Server Error - the server could not process the request.}\n\n@endpoint POST /legalEntities/{id}/confirmDataReview\n@desc Confirm data review\n@required {id: str # The unique identifier of the legal entity.}\n@returns(200) {dataReviewedAt: str} # OK - the request has succeeded.\n@errors {400: Bad Request - a problem reading or understanding the request., 401: Unauthorized - authentication required., 403: Forbidden - insufficient permissions to process the request., 422: Unprocessable Entity - a request validation error., 500: Internal Server Error - the server could not process the request.}\n\n@endpoint POST /legalEntities/{id}/onboardingLinks\n@desc Get a link to an Adyen-hosted onboarding page\n@required {id: str # The unique identifier of the legal entity}\n@optional {locale: str # The language that will be used for the page, specified by a combination of two letter [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language and [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes. See possible valuesfor [marketplaces](https://docs.adyen.com/marketplaces/onboard-users/hosted#supported-languages) or [platforms](https://docs.adyen.com/platforms/onboard-users/hosted#supported-languages).   If not specified in the request or if the language is not supported, the page uses the browser language. If the browser language is not supported, the page uses **en-US** by default., redirectUrl: str # The URL where the user is redirected after they complete hosted onboarding., 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 # The unique identifier of the hosted onboarding theme.}\n@returns(200) {url: str} # OK - the request has succeeded.\n@errors {400: Bad Request - a problem reading or understanding the request., 401: Unauthorized - authentication required., 403: Forbidden - insufficient permissions to process the request., 422: Unprocessable Entity - a request validation error., 500: Internal Server Error - the server could not process the request.}\n@example_request {\"themeId\":\"YOUR_THEME_ID\",\"redirectUrl\":\"https://your-company.example.com\",\"locale\":\"nl-NL\"}\n\n@endpoint GET /legalEntities/{id}/pciQuestionnaires\n@desc Get PCI questionnaire details\n@required {id: str # The unique identifier of the legal entity to get PCI questionnaire information.}\n@returns(200) {data: [map]} # OK - the request has succeeded.\n@errors {400: Bad Request - a problem reading or understanding the request., 401: Unauthorized - authentication required., 403: Forbidden - insufficient permissions to process the request., 422: Unprocessable Entity - a request validation error., 500: Internal Server Error - the server could not process the request.}\n\n@endpoint POST /legalEntities/{id}/pciQuestionnaires/generatePciTemplates\n@desc Generate PCI questionnaire\n@required {id: str # The unique identifier of the legal entity to get PCI questionnaire information.}\n@optional {additionalSalesChannels: [str] # An array of additional sales channels to generate PCI questionnaires. Include the relevant sales channels if you need your user to sign PCI questionnaires. Not required if you [create stores](https://docs.adyen.com/platforms) and [add payment methods](https://docs.adyen.com/adyen-for-platforms-model) before you generate the questionnaires.  Possible values: *  **eCommerce** *  **pos** *  **ecomMoto** *  **posMoto**, language: str # Sets the language of the PCI questionnaire. Its value is a two-character [ISO 639-1](https://en.wikipedia.org/wiki/ISO_639-1) language code, for example, **en**.}\n@returns(200) {content: str(byte), language: str, pciTemplateReferences: [str]} # OK - the request has succeeded.\n@errors {400: Bad Request - a problem reading or understanding the request., 401: Unauthorized - authentication required., 403: Forbidden - insufficient permissions to process the request., 422: Unprocessable Entity - a request validation error., 500: Internal Server Error - the server could not process the request.}\n@example_request {\"language\":\"fr\"}\n\n@endpoint POST /legalEntities/{id}/pciQuestionnaires/signPciTemplates\n@desc Sign PCI questionnaire\n@required {id: str # The legal entity ID of the user that has a contractual relationship with your platform., pciTemplateReferences: [str] # The array of Adyen-generated unique identifiers for the questionnaires., signedBy: str # The [legal entity ID](https://docs.adyen.com/api-explorer/#/legalentity/latest/post/legalEntities__resParam_id) of the individual who signs the PCI questionnaire.}\n@returns(200) {pciQuestionnaireIds: [str], signedBy: str} # OK - the request has succeeded.\n@errors {400: Bad Request - a problem reading or understanding the request., 401: Unauthorized - authentication required., 403: Forbidden - insufficient permissions to process the request., 422: Unprocessable Entity - a request validation error., 500: Internal Server Error - the server could not process the request.}\n@example_request {\"signedBy\":\"LE00000000000000000000002\",\"pciTemplateReferences\":[\"PCIT-T7KC6VGL\",\"PCIT-PKB6DKS4\"]}\n\n@endpoint POST /legalEntities/{id}/pciQuestionnaires/signingRequired\n@desc Calculate PCI status of a legal entity\n@required {id: str # The unique identifier of the legal entity to calculate PCI status.}\n@optional {additionalSalesChannels: [str] # An array of additional sales channels to generate PCI questionnaires. Include the relevant sales channels if you need your user to sign PCI questionnaires. Not required if you [create stores](https://docs.adyen.com/platforms) and [add payment methods](https://docs.adyen.com/adyen-for-platforms-model) before you generate the questionnaires.  Possible values: *  **eCommerce** *  **pos** *  **ecomMoto** *  **posMoto**}\n@returns(200) {signingRequired: bool} # OK - the request has succeeded.\n@errors {400: Bad Request - a problem reading or understanding the request., 401: Unauthorized - authentication required., 403: Forbidden - insufficient permissions to process the request., 422: Unprocessable Entity - a request validation error., 500: Internal Server Error - the server could not process the request.}\n\n@endpoint GET /legalEntities/{id}/pciQuestionnaires/{pciid}\n@desc Get PCI questionnaire\n@required {id: str # The legal entity ID of the individual who signed the PCI questionnaire., pciid: str # The unique identifier of the signed PCI questionnaire.}\n@returns(200) {content: str(byte), createdAt: str(date-time), id: str, validUntil: str(date-time)} # OK - the request has succeeded.\n@errors {400: Bad Request - a problem reading or understanding the request., 401: Unauthorized - authentication required., 403: Forbidden - insufficient permissions to process the request., 422: Unprocessable Entity - a request validation error., 500: Internal Server Error - the server could not process the request.}\n\n@endpoint POST /legalEntities/{id}/setTaxElectronicDeliveryConsent\n@desc Set the consent status for electronic delivery of tax forms\n@required {id: str # The unique identifier of the legal entity. For sole proprietorships, this is the individual legal entity ID of the owner. For organizations, this is the ID of the organization.}\n@optional {US1099k: bool # Consent to electronically deliver tax form US1099-K.}\n@returns(200) No Content - look at the actual response code for the status of the request.\n@errors {400: Bad Request - a problem reading or understanding the request., 401: Unauthorized - authentication required., 403: Forbidden - insufficient permissions to process the request., 422: Unprocessable Entity - a request validation error., 500: Internal Server Error - the server could not process the request.}\n\n@endpoint POST /legalEntities/{id}/termsOfService\n@desc Get Terms of Service document\n@required {id: str # The unique identifier of the legal entity. For sole proprietorships, this is the individual legal entity ID of the owner. For organizations, this is the ID of the organization., language: str # The language to be used for the Terms of Service document, specified by the two-letter [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language code. Possible values: **en** for English or **fr** for French., type: str(adyenAccount/adyenCapital/adyenCard/adyenChargeCard/adyenForPlatformsAdvanced/adyenForPlatformsManage/adyenFranchisee/adyenIssuing/adyenPccr/kycOnInvite) # The type of Terms of Service.  Possible values: *  **adyenForPlatformsManage** *  **adyenIssuing** *  **adyenForPlatformsAdvanced** *  **adyenCapital** *  **adyenAccount** *  **adyenCard** *  **adyenFranchisee** *  **adyenPccr** *  **adyenChargeCard** *  **kycOnInvite**}\n@optional {termsOfServiceDocumentFormat: str # The requested format for the Terms of Service document. Default value: JSON. Possible values: **JSON**, **PDF**, or **TXT**.}\n@returns(200) {document: str(byte), id: str, language: str, termsOfServiceDocumentFormat: str, termsOfServiceDocumentId: str, type: str} # OK - the request has succeeded.\n@errors {400: Bad Request - a problem reading or understanding the request., 401: Unauthorized - authentication required., 403: Forbidden - insufficient permissions to process the request., 422: Unprocessable Entity - a request validation error., 500: Internal Server Error - the server could not process the request.}\n@example_request {\"type\":\"adyenIssuing\",\"language\":\"en\"}\n\n@endpoint PATCH /legalEntities/{id}/termsOfService/{termsofservicedocumentid}\n@desc Accept Terms of Service\n@required {id: str # The unique identifier of the legal entity.  For sole proprietorships, this is the individual legal entity ID of the owner.  For organizations, this is the ID of the organization.  For legal representatives of individuals, this is the ID of the individual., termsofservicedocumentid: str # The unique identifier of the Terms of Service document., acceptedBy: str # The legal entity ID of the user accepting the Terms of Service.  For organizations, this must be the individual legal entity ID of an authorized signatory for the organization.  For sole proprietorships, this must be the individual legal entity ID of the owner.  For individuals, this must be the individual legal entity id of either the individual, parent, or guardian.}\n@optional {ipAddress: str # The IP address of the user accepting the Terms of Service.}\n@returns(200) {acceptedBy: str, id: str, ipAddress: str, language: str, termsOfServiceDocumentId: str, type: str} # OK - the request has succeeded.\n@errors {400: Bad Request - a problem reading or understanding the request., 401: Unauthorized - authentication required., 403: Forbidden - insufficient permissions to process the request., 422: Unprocessable Entity - a request validation error., 500: Internal Server Error - the server could not process the request.}\n@example_request {\"acceptedBy\":\"LE00000000000000000000002\"}\n\n@endpoint GET /legalEntities/{id}/termsOfServiceAcceptanceInfos\n@desc Get Terms of Service information for a legal entity\n@required {id: str # The unique identifier of the legal entity. For sole proprietorships, this is the individual legal entity ID of the owner. For organizations, this is the ID of the organization.}\n@returns(200) {data: [map]} # OK - the request has succeeded.\n@errors {400: Bad Request - a problem reading or understanding the request., 401: Unauthorized - authentication required., 403: Forbidden - insufficient permissions to process the request., 422: Unprocessable Entity - a request validation error., 500: Internal Server Error - the server could not process the request.}\n\n@endpoint GET /legalEntities/{id}/termsOfServiceStatus\n@desc Get Terms of Service status\n@required {id: str # The unique identifier of the legal entity. For sole proprietorships, this is the individual legal entity ID of the owner. For organizations, this is the ID of the organization.}\n@returns(200) {termsOfServiceTypes: [str]} # OK - the request has succeeded.\n@errors {400: Bad Request - a problem reading or understanding the request., 401: Unauthorized - authentication required., 403: Forbidden - insufficient permissions to process the request., 422: Unprocessable Entity - a request validation error., 500: Internal Server Error - the server could not process the request.}\n\n@endgroup\n\n@group themes\n@endpoint GET /themes\n@desc Get a list of hosted onboarding page themes\n@returns(200) {next: str, previous: str, themes: [map]} # OK - the request has succeeded.\n@errors {400: Bad Request - a problem reading or understanding the request., 401: Unauthorized - authentication required., 403: Forbidden - insufficient permissions to process the request., 422: Unprocessable Entity - a request validation error., 500: Internal Server Error - the server could not process the request.}\n\n@endpoint GET /themes/{id}\n@desc Get an onboarding link theme\n@required {id: str # The unique identifier of the theme}\n@returns(200) {createdAt: str(date-time), description: str, id: str, properties: map, updatedAt: str(date-time)} # OK - the request has succeeded.\n@errors {400: Bad Request - a problem reading or understanding the request., 401: Unauthorized - authentication required., 403: Forbidden - insufficient permissions to process the request., 422: Unprocessable Entity - a request validation error., 500: Internal Server Error - the server could not process the request.}\n\n@endgroup\n\n@group transferInstruments\n@endpoint POST /transferInstruments\n@desc Create a transfer instrument\n@required {bankAccount: map{accountIdentification: any, accountType: str, bankName: str, countryCode: str, trustedSource: bool}, legalEntityId: str # The unique identifier of the [legal entity](https://docs.adyen.com/api-explorer/legalentity/latest/post/legalEntities#responses-200-id) that owns the transfer instrument., type: str(bankAccount/recurringDetail) # The type of transfer instrument.  Possible value: **bankAccount**.}\n@optional {x-requested-verification-code: str # Use a suberror code as your requested verification code. You can include one code at a time in your request header. Requested verification codes can only be used in your test environment.}\n@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} # OK - the request has succeeded.\n@errors {400: Bad Request - a problem reading or understanding the request., 401: Unauthorized - authentication required., 403: Forbidden - insufficient permissions to process the request., 422: Unprocessable Entity - a request validation error., 500: Internal Server Error - the server could not process the request.}\n@example_request {\"legalEntityId\":\"LE00000000000000000000001\",\"type\":\"bankAccount\",\"bankAccount\":{\"accountIdentification\":{\"type\":\"iban\",\"iban\":\"NL62ABNA0000000123\"}}}\n\n@endpoint GET /transferInstruments/{id}\n@desc Get a transfer instrument\n@required {id: str # The unique identifier of the transfer instrument.}\n@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} # OK - the request has succeeded.\n@errors {400: Bad Request - a problem reading or understanding the request., 401: Unauthorized - authentication required., 403: Forbidden - insufficient permissions to process the request., 422: Unprocessable Entity - a request validation error., 500: Internal Server Error - the server could not process the request.}\n\n@endpoint DELETE /transferInstruments/{id}\n@desc Delete a transfer instrument\n@required {id: str # The unique identifier of the transfer instrument to be deleted.}\n@returns(204) No Content - look at the actual response code for the status of the request.\n@errors {400: Bad Request - a problem reading or understanding the request., 401: Unauthorized - authentication required., 403: Forbidden - insufficient permissions to process the request., 422: Unprocessable Entity - a request validation error., 500: Internal Server Error - the server could not process the request.}\n\n@endpoint PATCH /transferInstruments/{id}\n@desc Update a transfer instrument\n@required {id: str # The unique identifier of the transfer instrument., bankAccount: map{accountIdentification: any, accountType: str, bankName: str, countryCode: str, trustedSource: bool}, legalEntityId: str # The unique identifier of the [legal entity](https://docs.adyen.com/api-explorer/legalentity/latest/post/legalEntities#responses-200-id) that owns the transfer instrument., type: str(bankAccount/recurringDetail) # The type of transfer instrument.  Possible value: **bankAccount**.}\n@optional {x-requested-verification-code: str # Use the requested verification code 0_0001 to resolve any suberrors associated with the transfer instrument. Requested verification codes can only be used in your test environment.}\n@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} # OK - the request has succeeded.\n@errors {400: Bad Request - a problem reading or understanding the request., 401: Unauthorized - authentication required., 403: Forbidden - insufficient permissions to process the request., 422: Unprocessable Entity - a request validation error., 500: Internal Server Error - the server could not process the request.}\n@example_request {\"bankAccount\":{\"accountIdentification\":{\"type\":\"iban\",\"iban\":\"NL02ABNA0123456789\"}},\"legalEntityId\":\"LE00000000000000000000001\",\"type\":\"bankAccount\"}\n\n@endgroup\n\n@group legalEntities\n@endpoint POST /legalEntities/{id}/requestPeriodicReview\n@desc Request periodic data review.\n@required {id: str # The unique identifier of the legal entity.}\n@returns(204) No Content - the request has been successfully processed, but there is no additional content.\n\n@endgroup\n\n@end\n"}}